Criar cartão

post

https://api.pagar.me/core/v5/customers/{customer_id}/cards

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

🚧
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

required

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 Pluxee).

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

required

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, unionpay ou discover.

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.

billing_address

object

Endereço de cobrança.

metadata

string

Objeto chave/valor utilizado para armazenar informações adicionais sobre o cartão. Saiba mais sobre metadata

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

Language

Credentials

Basic

base64

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Falha na verificação de cartão

Cartão já cadastrado

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

200200

404404

422422