Voltar ao site
Guias

Cobrar com cartão

Cofre de cartões, token do SDK, parcelamento, 3DS e captura.

Página em construção

Este é um resumo. O conteúdo completo entra nas próximas versões da documentação; o contrato de cada rota já está na Referência da API.

  • POST /v1/payments/cards com card.id (cartão salvo no cofre) ou card.token (gerado no navegador pelo SDK de tokenização). PAN e CVV nunca passam pela sua API.
  • Parcelamento de 1 a 12 vezes em installments.
  • Com desafio 3DS, o pagamento fica PENDING com nextAction: { "type": "REDIRECT_3DS", "url" }.
  • Captura manual: o pagamento fica AUTHORIZED até POST /v1/payments/{id}/captures, que aceita captura parcial.
  • Salvar o cartão para cobranças futuras exige o escopo payments:vault:write.