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 Bearer. 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": "Cartao tokenizado com sucesso",
  "token": "a1b2c3d4-e5f6-4789-9abc-def012345678",
  "suffix": "1111",
  "bin": "411111",
  "statusTransaction": "CON",
  "bandeiraCartao": "1"
}

Campos da resposta

Campo	Tipo	Descrição
`code`	string	Código de resposta. Diferente de `0` significa falha
`message`	string	Mensagem de resposta
`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)
`statusTransaction`	enum	Status da tokenização — ver Status de transaçã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