{
"id": "evt_01k1y6r7z2m4n6p8q0r2s4t6ua",
"type": "charge.failed",
"created_at": "2026-08-04T14:03:12+00:00",
"data": {
"charge": {
"object": "charge",
"id": "ch_01k1y6r6m6q2x0p3d9v4t7c8n2",
"status": "failed",
"payment_method": "credit_card",
"amount": 12775,
"currency": "BRL",
"description": "Curso de Vue 3",
"created_at": "2026-08-04T14:00:00+00:00"
}
}
}Eventos de cobrança
charge.failed
Enviado quando a operadora do cartão recusa o pagamento, ou quando a análise de fraude o reprova.
WEBHOOK
charge.failed
{
"id": "evt_01k1y6r7z2m4n6p8q0r2s4t6ua",
"type": "charge.failed",
"created_at": "2026-08-04T14:03:12+00:00",
"data": {
"charge": {
"object": "charge",
"id": "ch_01k1y6r6m6q2x0p3d9v4t7c8n2",
"status": "failed",
"payment_method": "credit_card",
"amount": 12775,
"currency": "BRL",
"description": "Curso de Vue 3",
"created_at": "2026-08-04T14:00:00+00:00"
}
}
}Confira a assinatura antes de agir. Ver Verificar a assinatura.
failure_reason traz o que a operadora respondeu, e o lugar dele é o seu log, não a tela do
comprador. “Cartão sem limite” dito ao portador de um cartão clonado é informação que ajuda quem
clonou.Authorizations
Chave secreta do vendedor, criada no painel em Desenvolvedores.
O valor em claro existe uma única vez, na criação. Guardamos só o hash SHA-256 - nem o suporte consegue recuperá-lo, o que é o ponto: um dump do nosso banco não permite cobrar em nome de ninguém.
A chave vai no servidor. Colocá-la no navegador do comprador a entrega a qualquer pessoa que abra a página.
Headers
Assinatura da entrega, no formato t=<timestamp>,v1=<hmac>, onde
hmac é HMAC-SHA256("<timestamp>.<corpo bruto>", <segredo>).
Duas regras ao conferir:
- Calcule sobre o corpo bruto, antes de desserializar. Reserializar muda espaçamento e ordem, e o HMAC deixa de bater.
- Recuse timestamps com mais de 5 minutos. É isso que impede
alguém que interceptou uma entrega de
charge.paidde reenviá-la quantas vezes quiser, com assinatura perfeitamente válida.
Pattern:
^t=[0-9]+,v1=[0-9a-f]{64}$Body
application/json
Response
Recebido.