Cadastrar cartão (tokenizado) para compras futuras
POST
/api/Transacoes/IncluirCartao
Transacoes
Funcionalidade principal
CartaoId.Ao enviar os dados completos do cartão ( NumeroCartao,CodigoSeguranca, etc.), a API armazena essas informações em um cofre seguro (em conformidade com as normas PCI-DSS) e retorna oCartaoId. Este ID é a referência que será utilizada em todas as cobranças futuras, evitando a necessidade de trafegar novamente os dados sensíveis do cartão.
O parâmetro "ValidarCartao"
O campo booleano ValidarCartaoé um recurso de segurança importante. Quando definido comotrue, o sistema realizará uma transação de validação (geralmente uma pré-autorização de valor zero ou muito baixo) para confirmar que o cartão é válido, ativo e possui fundos antes de tokenizá-lo. Isso previne o armazenamento de cartões inválidos na sua base.
Casos de uso comuns
1.
2.
3.
Próximo Passo: Após receber o CartaoIdcom sucesso, você deve armazená-lo associado ao seu cliente. EsteCartaoIdserá o principal identificador a ser enviado no endpoint "Efetuar transação com cartão tokenizado".
Requisição
Parâmetros Header
Parâmetros Bodyapplication/json
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/api/Transacoes/IncluirCartao' \
--header 'UserName;' \
--header 'RequestOrigin;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"Data": {
"CodigoCanal": 0,
"CodigoCliente": 0,
"Apelido": "string",
"NomeImpresso": "string",
"NumeroCartao": "string",
"DataValidade": "string",
"CodigoSeguranca": "string",
"ValidarCartao": true
}
}'Response Response Example
Response
{
"Data": {
"CartaoId": "string"
},
"ResultCode": 0,
"Message": "string",
"ValidationData": {
"ResultCode": 0,
"Message": "string",
"Errors": [
{
"ErrorMessage": "string",
"FieldName": "string"
}
]
}
}Modificado em 2026-03-03 14:53:45