Cria um pagamento de crédito ou débito, à vista ou parcelado. Com amount: 0 funciona como
validação de cartão (zero-dollar): verifica o cartão junto ao emissor sem cobrar.
Envie os dados do cartão via card (PAN completo) ou via tokenData (cartão tokenizado) — nunca os dois
simultaneamente.
Suporta idempotência via orderId. Se um pagamento com o mesmo orderId já estiver ACCEPTED ou CAPTURED, retorna
409 sem criar um novo débito.
Códigos de erro
Quando a transação não é aprovada a resposta é 422 com errors[]. O campo code diz o que aconteceu
e se vale retentar:
errors[].code | Significado | O que fazer |
|---|---|---|
AUTHORIZER_REJECTED | O emissor do cartão recusou. msg traz o código de resposta do emissor e o texto, ex.: 51 - Not sufficient funds, 59 - Suspected fraud, 05 - Do not honor, 54 - Expired card, 46 - Identification required, 19 - Re-enter transaction. | Recusa definitiva para esta tentativa. 19 e 46 valem uma nova tentativa pelo portador. |
TOKEN_NOT_AVAILABLE | O token do cartão (tokenData.slugToken) deixou de ser elegível. | Tokenize o cartão novamente. Retentar com o mesmo token continua falhando. |
INVALID_CARD_BRAND | Bandeira não suportada. | Recusa definitiva. |
MSG_GENERAL_ERROR | Erro técnico no processamento (a msg traz o detalhe, ex.: 502 : badGateway). | Transitório: retente com o mesmo orderId — a idempotência garante que não haverá cobrança em dobro. |
UNAUTHORIZED | Falha técnica transitória de autenticação no processamento. | Retente. |
Demais status HTTP: 400 validação do body, 401/403 token ou IP não autorizado, 409 ORDER_ALREADY_APPROVED
(idempotência — o pagamento original está de pé, nada foi cobrado), 422 SPLIT_MERCHANT_NOT_FOUND.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Token de acesso inválido