Criar Cartão

Criar cartão

POST /api/v1/cards

Tokeniza um cartão de crédito, retornando um token que representa o cartão em transações futuras.

Requer autenticação mTLS. Veja Autenticação.

Request

Body

{
  "dataExpiracao": "12/28",
  "numeroCartao": "4111111111111111",
  "walletTransactionId": "wt-20250723-000123",
  "bandeiraCartao": "1",
  "merchantUsn": "123456789012",
  "clientId": "CLI-000123"
}

Campos

Campo	Tipo	Obrigatório	Descrição
`dataExpiracao`	string	sim	Validade no formato `MM/AA`
`numeroCartao`	string	sim	Número do cartão a ser tokenizado
`bandeiraCartao`	string	sim	Código numérico da bandeira
`walletTransactionId`	string	não	ID de transação gerado pela carteira digital de origem (rastreabilidade)
`merchantUsn`	string	não	Número sequencial único gerado pela loja (max 12)
`clientId`	string	não	Identificador do cliente/lojista

Response

`200 OK`

{
  "code": "0",
  "message": "Cartão tokenizado com sucesso",
  "token": "a1b2c3d4-e5f6-4789-9abc-def012345678",
  "suffix": "1111",
  "bin": "411111",
  "statusTransaction": "CON",
  "nsua": "123456789012345",
  "nita": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6a7b8c9d0e1f2",
  "merchantUsn": "123456789012",
  "clientId": "CLI-000123",
  "bandeiraCartao": "1"
}

Campos da resposta

Campo	Tipo	Descrição
`code`	string	Código de resposta. Diferente de `0` significa falha (max 4)
`message`	string	Mensagem de resposta (max 500)
`token`	string	Token gerado para representar o cartão
`suffix`	string	Últimos 4 dígitos do cartão
`bin`	string	BIN do cartão — identifica emissor e bandeira (max 8)
`statusTransaction`	enum	Status da tokenização — ver Status de transação
`nsua`	string	NSU da adquirente para a transação de tokenização (max 15)
`nita`	string	NIT da adquirente — identificador da transação de tokenização (max 64)
`merchantUsn`	string	Número sequencial único enviado pela loja na requisição (max 12)
`clientId`	string	Identificador do cliente/lojista da requisição
`bandeiraCartao`	string	Código da bandeira tokenizada

Erros

Status	Significado
`400`	Requisição inválida
`401`	Não autorizado
`409`	Cartão já cadastrado
`500`	Erro interno ao criar o cartão

Criar Cartão

On this page