Tokenizar cartão
Troca os dados do cartão por um token reutilizável (`ctok_…`). Não cobra nada. Se o mesmo cartão já tem token ativo para o mesmo `customerId`, responde `200` com o token existente e `deduplicated: true`. Nesta rota o código de segurança é `cvv` (não `cvc`) e os erros usam o envelope `{code, message}`. Disponível no sandbox; confirme a habilitação em produção com a equipe de integração.
Troca os dados do cartão por um token reutilizável (ctok_…). Não cobra nada.
Se o mesmo cartão já tem token ativo para o mesmo customerId, responde 200 com o token existente e deduplicated: true.
Nesta rota o código de segurança é cvv (não cvc) e os erros usam o envelope {code, message}.
Disponível no sandbox; confirme a habilitação em produção com a equipe de integração.
ApiKeyAuthorization<token>A chave de API crua, sem prefixo: kpa_test_sk_… no sandbox e kpa_live_sk_… em produção.
Use apenas no servidor.
Idempotency-Key?stringObrigatória (ou idempotencyKey no corpo). 8 a 255 caracteres [A-Za-z0-9_.:-]. Retenção de 24 horas.
^[A-Za-z0-9_.:-]+$8 <= length <= 255application/json- body
card*customerId?stringIdentificador estável do cliente no seu sistema. Separa os cartões de clientes diferentes.
idempotencyKey?stringAlternativa ao cabeçalho. Se enviar os dois, precisam ser iguais.
Cartão já tokenizado para o mesmo cliente. Devolve o token existente.
application/json- response
cardTokenUid?string^ctok_[0-9A-HJKMNP-TV-Z]{26}$brand?string"VISA""MASTERCARD""ELO""HIPERCARD""AMERICAN_EXPRESS""DINERS""DISCOVER""JCB""UNSPECIFIED"bin?stringSeis primeiros dígitos.
last4?stringexpMonth?integerexpYear?integerstatus?string"ACTIVE""SUSPENDED"cvvStored?booleandeduplicated?booleancurl -X POST 'https://g6idryo27h.execute-api.us-east-1.amazonaws.com/api/v1/card-tokens' \ -H 'Content-Type: application/json' \ -d '{ "card": { "number": "5555555555554444", "expMonth": 12, "expYear": 2030, "cvv": "123", "holderName": "MARIA SOUZA" }, "customerId": "cliente-1001"}'{ "cardTokenUid": "ctok_01M0FVG11PZK94T569VFYE4FY3", "brand": "VISA", "bin": "555555", "last4": "4444", "expMonth": 0, "expYear": 0, "status": "ACTIVE", "cvvStored": true, "deduplicated": true}Abrir sessão do SDK de campos POST
Abre a sessão que autoriza o SDK de campos (`DMCard`) a capturar o cartão no navegador do comprador. Chame do seu servidor, uma vez por checkout. A sessão vale 1 hora e permite até 5 tentativas de tokenização. Disponível no sandbox e em produção, com habilitação por conta. Guia: /docs/cartoes/sdk-de-campos.
Cancelar saque POST
Cancela um saque ainda em análise. Idempotente. A devolução do valor ao saldo é assíncrona. Se o saque já foi aprovado, responde `409 withdrawal.cannot_cancel`.