Criar Cobrança Cartão
Processa um pagamento por cartão de crédito a partir de uma oferta da sua conta. Requer um token de cartão obtido previamente no front-end via SDK.
Visão geral
O métodocredit_card processa um pagamento por cartão de crédito sem autenticação 3DS. O front-end tokeniza o cartão e envia apenas o cardToken ao seu backend, que chama este endpoint.
Autenticação
Todas as requisições exigem um token OAuth2 válido obtido emPOST /public_api/token/.
Escopo
Idempotência
O headerX-Idempotency-Key é obrigatório e permite reenviar a mesma requisição com segurança sem gerar cobranças duplicadas. Janela de retenção: 24 horas.
Rate limit
Corpo da requisição
Resumo dos campos
Detalhamento dos campos
"credit_card" para pagamentos por cartão sem 3DS.POST /public_api/card-tokens/.Resposta de sucesso
201 Created
credit_card.Exemplo de resposta
Respostas de erro
Exemplo de requisição
Boas práticas
- Obtenha o
cardTokenimediatamente antes de chamar este endpoint. O token expira em 15 minutos e é de uso único. - Prefira a Cobrança 3DS sempre que possível. Ela reduz chargebacks via liability shift.
- Não confunda
declinedcomrefused.declinedé recusa financeira do banco.refusedé falha técnica no adquirente.
Authorizations
Token de autenticação do tipo Bearer {access_token}, onde {access_token} é o token obtido no fluxo de autenticação.
Headers
Identificador único da cobrança (até 255 caracteres). Recomendado UUID v4. Reuso com payload idêntico devolve a resposta original por 24h.
255Body
short_id ou id (UUID) do produto. O produto deve pertencer ao
tenant autenticado e estar ativo.
Método de pagamento da cobrança.
pix, pix_auto, boleto Deve conter exatamente um item.
1 elementshort_id do afiliado responsável pela venda. Deve estar com status
active e cadastrado para o produto informado.
40Código do cupom de desconto.
255Somente para boleto. Data de vencimento (YYYY-MM-DD). Deve ser
futura e respeitar o ticketExpiration do produto.
Somente para pix e pix_auto. Expiração do código Pix em segundos.
Mínimo 60. Deve respeitar o pixExpiresIn do produto.
x >= 60Response
Cobrança criada com sucesso.
Identificador único do pedido criado.
Código curto de referência do pedido.
Status inicial do pedido. Para Pix e Boleto, normalmente waiting_payment.
pix, pix_auto, boleto Valor final cobrado, em reais, como string decimal.
Identificador da transação no provedor.
URL do checkout Cakto.
Presente apenas para pix e pix_auto.
Presente apenas para boleto.