Network token (externo)
Quick Reference
WhatDPAN + criptograma na API de cobrança
WhyMaiores taxas de aprovação e confiança em nível de bandeira vs PAN bruto
DifficultyAdvanced
PrerequisitesHost-to-Host → Autenticação
Se sua stack já executa tokenização de rede e 3DS fora da A55, use o mesmo endpoint POST de cobrança com PAN tokenizado (DPAN) e criptograma de uso único do seu serviço de tokens.
Por que network tokens
| Benefício | Detalhe |
|---|---|
| Maiores taxas de aprovação | Emissores favorecem network tokens em relação ao PAN bruto |
| Continuidade cartão salvo | Tokens atualizam quando cartões são substituídos |
| Menos fraude | Criptograma de uso único por transação |
| Confiança em nível de bandeira | Relação direta com cofres Visa/Mastercard |
Ciclo de vida do token
Formato do payload
| Campo | Descrição |
|---|---|
card_number | DPAN do seu provedor de network token |
card_cryptogram | TAVV / CAVV criptograma de uso único |
card_expiry_month / card_expiry_year | Validade do token conforme fornecida pela bandeira |
Objeto threeds_external
| Campo | Descrição |
|---|---|
eci | Electronic Commerce Indicator |
cavv | Cardholder Authentication Verification Value |
xid | ID da transação (contextos legados) |
version | Versão do protocolo 3DS |
Alinhamento de campos
Campos de network token e 3DS externo devem corresponder às expectativas do emissor e da bandeira. Valide cada combinação no sandbox antes da produção.
Exemplo
- JSON
{
"wallet_uuid": "00000000-0000-4000-8000-000000000001",
"currency": "BRL",
"type_charge": "credit_card",
"card_number": "4500000000000000",
"card_cryptogram": "AAABBBCCCDDDEEFF==",
"card_expiry_month": 12,
"card_expiry_year": 2030,
"threeds_external": {
"eci": "05",
"cavv": "BwABBylVaQAAAAFwllVpAAAAAAA=",
"xid": "",
"version": "2.2.0"
}
}
POST https://core-manager.a55.tech/api/v1/bank/wallet/charge/ com Authorization: Bearer $ACCESS_TOKEN.
Segurança
A tokenização com network tokens reduz a exposição ao PAN bruto. A A55 gerencia o ciclo de vida do token e a segurança dos dados — você foca na experiência do seu cliente.