Create customer card

post

https://test-api.acquired.com/v1/customers/{customer_id}/cards

Store a card against a customer for use in later stored-card payments.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

customer_id

uuid

required

Unique ID assigned by Acquired.com for the customer.

Body Params

holder_name

string

required

length between 2 and 50

^[a-zA-Z ]*$

The name of the cardholder.

scheme

string

enum

The scheme the card belongs to.

Allowed:

number

string

required

The card number.

expiry_month

integer

required

1 to 12

The month the card expires in.

expiry_year

integer

required

26 to 56

The year the card expires in.

cvv

string

length between 3 and 4

The 3 or 4-digit security code that appears on the card.

scheme_reference_data

string

Scheme reference data from a prior successful transaction on the same card. Visa values are 15 digits; Mastercard values are 13 alphanumeric characters.

source

string

enum

Defaults to card

Identifies how the card was created.

Allowed:

Responses

200OK - the customer already has a card with the same holder name and card number. The existing card_id is returned and any new details from your request are saved to the stored card.

201Created

400Bad Request

401Unauthorized

403Forbidden - the customer does not belong to your company.