Cartões
Cartões
O fluxo de cobrança com cartão de crédito e débito, com coleta de dispositivo e autenticação 3DS, de ponta a ponta.
A cobrança de crédito usa uma sessão de coleta de dados do dispositivo, a cobrança propriamente dita e, quando o emissor pede, um desafio 3DS no navegador. As chamadas autenticadas saem sempre do seu servidor.
| Etapa | Quem faz | Resultado | Página |
|---|---|---|---|
| 1. Abrir sessão 3DS | Seu servidor | session_token e expires_at | Abra a sessão 3DS |
| 2. Coletar dispositivo | SDK no navegador | Coleta durante o preenchimento do checkout | Colete os dados do dispositivo |
| 3. Criar cobrança | Seu servidor | Succeeded, Failed, Processing ou RequiresAction | Crie a cobrança |
| 4. Exibir desafio | Seu checkout | Iframe com a URL recebida, se necessário | Exiba o desafio 3DS |
| 5. Confirmar pedido | Seu servidor | Resposta autenticada, webhook ou consulta | Consulte um pagamento |
Débito usa type: "DebitCard" e pagamento à vista. A jornada de sessão e desafio desta seção se aplica ao crédito. Veja Opções e dados do cartão.
Antes de começar
- ID do recebedor e escopo da conta (
DomesticouOffshore), entregues no credenciamento. - Origem HTTPS do checkout cadastrada, para o desafio abrir no iframe.
- CSP do checkout liberando as origens do SDK e da Hooks. Veja Colete os dados do dispositivo.
Como capturar o cartão
| Opção | Por onde passam número e código de segurança | Quando usar |
|---|---|---|
| SDK de campos | Só pelos campos da Accelerazione, no navegador. Sua página e seu servidor recebem um token tok_…. | Recomendado. Disponível em produção, com habilitação por conta. |
| Cartão no corpo da cobrança | Pelo seu servidor, em paymentMethods[].card. | Quando o seu ambiente já é preparado para PCI DSS, ou no sandbox. |
| Cartão salvo | Pelo seu servidor, uma vez; depois, só o ctok_…. | Compras recorrentes do mesmo comprador. |
Dados de cartão no seu servidor
Sem o SDK de campos, o número e o código de segurança passam pelo seu servidor. Proteja o transporte, nunca registre esses dados em log e cumpra as exigências do PCI DSS que se aplicam ao seu ambiente.