Criar cartão

post

https://api.mundipagg.com/core/v1/customers/{customer_id}/cards

Este recurso cria um card associado ao customer através do customer_id informado.

🚧
Falha na verificação de cartão
Quando a verificação de cartão esta ativa e ocorre uma falha na verificação, a API irá retornar erro "412" com a mensagem: "Could not create credit card. The card verification failed."

🚧
Cartão já cadastrado
Caso um cliente tente cadastrar um mesmo cartão mais de uma vez*, será retornado o mesmo card_id do cartão previamente cadastrado.

❗️
Campo "brand" é obrigatório para cartões Private Label
Caso o cartão seja private label (ou seja private_label = true), brand será um campo obrigatório.

Path Params

customer_id

string

required

Código do cliente. Formato: cus_XXXXXXXXXXXXXXXX

Body Params

number

string

required

Número do cartão. Entre 13 e 19 caracteres

holder_name

string

Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)

holder_document

string

CPF ou CNPJ do portador do cartão. Obrigatório caso o tipo do cartão seja voucher (bandeiras VR ou Sodexo).

exp_month

int32

required

Mês de validade do cartão. Valor entre 1 e 12 (inclusive)

exp_year

int32

required

Ano de validade do cartão. Formatos yy ou yyyy. Ex: 23 ou 2023.

cvv

string

Código de segurança do cartão. O campo aceita 4 ou 3 caracteres, variando por bandeira.

brand

string

Bandeira do cartão. Para cartões de crédito, temos como valores possíveis: Elo, Mastercard, Visa, Amex, JCB, Aura, Hipercard, Diners ou Discover. Para voucher, temos como valores possíveis: Alelo, VR ou Sodexo.

label

string

Indica a label do cartão

billing_address_id

string

Código do endereço de cobrança. Max: 36 caracteres.<>Opcional, pode ser utilizado no lugar do billing_address.

token

string

Pode ser enviado no lugar dos dados do cartão, caso este já tenha sido tokenizado previamente. Saiba mais sobre criação de token de cartão.

Responses

Criar cartão

🚧
Falha na verificação de cartão

🚧
Cartão já cadastrado

❗️
Campo "brand" é obrigatório para cartões Private Label

🚧Falha na verificação de cartão

🚧Cartão já cadastrado

❗️Campo "brand" é obrigatório para cartões Private Label

200200

404404

422422

🚧
Falha na verificação de cartão

🚧
Cartão já cadastrado

❗️
Campo "brand" é obrigatório para cartões Private Label