Skip to main content
A cobrança no cartão tem dois passos, e essa separação existe por segurança: os dados sensíveis do cartão nunca passam pela rota de cobrança.

Tokenizar

Você envia número, validade e CVV para a rota de tokenização e recebe um cardToken opaco.

Cobrar

Você cria a cobrança usando apenas o cardToken — nunca o número do cartão.
Nunca envie número do cartão ou CVV para a rota de cobrança. Esses dados só trafegam na tokenização. Isso reduz seu escopo de PCI e o risco de vazamento.

​
Parcelamento

Você pode cobrar em 1 a 12 parcelas (installments). O padrão é 1 (à vista).

​
O resultado pode vir na hora

Diferente do PIX (que sempre nasce pending), o cartão costuma resolver de imediato. A resposta da cobrança já vem com um status:
StatusO que significa
paidAprovado.
refusedRecusado — veja o refuseReason.
pendingO adquirente confirma de forma assíncrona; o resto chega por webhook.

​
Quando é recusado

O campo refuseReason diz o motivo (saldo insuficiente, cartão bloqueado, antifraude, etc.) e o campo message já vem traduzido para exibir ao usuário. Trate a recusa oferecendo outro cartão ou o PIX como alternativa.

Referência: rotas de cartão

Tokenização, cobrança, parcelas e a tabela completa de motivos de recusa.