POST
/
v1
/
cards

Authorizations

X-Client-Id
string
headerrequired
X-Api-Key
string
headerrequired

Body

application/json
tokenId
string
required

Identificador do token gerado

merchantId
string

Caso queria validar o cartão via zero dollar, informe o merchantId que possui pelo menos 1 provedor com suporte a validação zero dollar.

cvvCheck
boolean

Mesmo informando o merchantId, é possível desabilitar a validação do cvv (zero dollar). Informe true para validar ou false para pular a validação. Caso você informe false, a verificação será pulada e o cartão será criado como pending necessitando validar via uma transação.

Response

201 - application/json
id
string

ID do cartão

status
enum<string>

Status de validação dos dados cartões, failed (cartão inválido para uso), active (cartão válido para uso), pending (validação do cartão pendente, uso autorizado temporariamente)

Available options:
failed,
active,
pending
statusReason
string

Contém uma string com um breve descritivo informando o motivo do status do cartão. Em alguns casos uma string vazia é retornada.

createdAt
string

Data de criação do cartão

clientId
string

Identificação do cliente

brand
enum<string>

Bandeira do cartão

Available options:
American Express,
Mastercard,
Visa,
Elo,
Discover,
JCB,
Diners
cardHolderName
string

Nome do cliente do cartão

cvvChecked
boolean

Identifica se o CVV foi verificado

fingerprint
string

Hash de identificação única do cartão com base nos dados sensíveis

first6digits
string

Primeiros 6 digitos do cartão

last4digits
string

Últimos 4 digitos do cartão

customerId
string

Identificador de comprador para consulta futura

expirationMonth
string

Data de expiração MM

expirationYear
string

Data de expiração YYYY

tokens
object[]

Lista de tokens externos associados ao cartão