Skip to main content
POST
Add card to customer

Authorizations

Authorization
string
header
required

Use your account's Secret Key as the Bearer token.

Path Parameters

uuid
string
required

Customer UUID.

Body

application/json
payin_type
enum<string>
required
Available options:
DCP,
DCP_AUTH,
STRIPE,
M2P_ISSUING
wallet_id
integer

ID of the wallet that backs the card. Required for STRIPE and M2P_ISSUING. Must belong to the customer.

Example:

51

ficha_beneficiario
object

M2P_ISSUING only. Optional cardholder data; cards are issued anonymous by default.

product_id
string

M2P_ISSUING only. Card product identifier.

card_type
string

M2P_ISSUING only. Card type or program code.

Response

Card created

id
integer
self
string
uuid
string
type
string | null

Card brand (e.g. VISA, MASTERCARD).

cardholder
string | null
alias
string | null

Masked card number alias (e.g. 4242XXXXXXXX4242).

expiration
string | null
Example:

"12/26"

issuing_country
string | null
issuing_bank
string | null
is_3d_secure
boolean | null
confirmed
boolean

Whether the card has been successfully tokenized and confirmed.

payin_type
string | null

Payment type this card is associated with.

URL to complete card tokenization. Only present immediately after creation.

gateway_reference_id
string | null

Identifier of the card at the issuer (STRIPE, M2P_ISSUING). Only present for cards linked to a wallet.

created_at
string<date-time> | null
connections
object

Hypermedia links to related resources.