{
"event": "refund",
"transaction": {
"id": "10000000-0000-4000-8000-000000000102",
"merchant_id": "20000000-0000-4000-8000-000000000001",
"user_id": "30000000-0000-4000-8000-000000000001",
"processor_id": "40000000-0000-4000-8000-000000000001",
"merchant_transaction_id": "50000000-0000-4000-8000-000000000102",
"transaction_type": "pix",
"first_name": "Cliente",
"last_name": "Exemplo",
"email": "cliente@example.com",
"updated_at": "2026-10-23T15:01:00+00:00",
"created_at": "2026-10-23T15:00:00+00:00",
"events": [
{
"id": "60000000-0000-4000-8000-000000000106",
"success": true,
"status": "pending_settlement",
"event_type": "refund",
"amount": "42.50",
"ip_address": null,
"processor_code": null,
"processor_message": null,
"processor_transaction_id": "sandbox-refund-1001",
"batch_id": null,
"qrcode": null,
"qrcode_image": "",
"pix_key_type": null,
"pix_key_value": null,
"pix_message": null,
"updated_at": "2026-10-23T15:01:00+00:00",
"created_at": "2026-10-23T15:01:00+00:00"
},
{
"id": "60000000-0000-4000-8000-000000000105",
"success": false,
"status": "declined",
"event_type": "payment",
"amount": "42.50",
"ip_address": null,
"processor_code": null,
"processor_message": null,
"processor_transaction_id": "sandbox-payment-1001",
"batch_id": null,
"qrcode": null,
"qrcode_image": "",
"pix_key_type": "email",
"pix_key_value": "destino@example.com",
"pix_message": "Pagamento para: CONTA DEMO",
"updated_at": "2026-10-23T15:00:00+00:00",
"created_at": "2026-10-23T15:00:00+00:00"
}
],
"document_number": "12345678909",
"status": "failed",
"flow_type": "cashout",
"error": {
"type": "ERROR_BANK_CASH_OUT",
"code": "4",
"message": "The transfer was rejected by the receiving bank",
"meta": []
},
"e2e_id": null,
"statement": []
}
}Webhooks
Pagamento devolvido
Indica a devolução de uma saída Pix.
WEBHOOK
refund
{
"event": "refund",
"transaction": {
"id": "10000000-0000-4000-8000-000000000102",
"merchant_id": "20000000-0000-4000-8000-000000000001",
"user_id": "30000000-0000-4000-8000-000000000001",
"processor_id": "40000000-0000-4000-8000-000000000001",
"merchant_transaction_id": "50000000-0000-4000-8000-000000000102",
"transaction_type": "pix",
"first_name": "Cliente",
"last_name": "Exemplo",
"email": "cliente@example.com",
"updated_at": "2026-10-23T15:01:00+00:00",
"created_at": "2026-10-23T15:00:00+00:00",
"events": [
{
"id": "60000000-0000-4000-8000-000000000106",
"success": true,
"status": "pending_settlement",
"event_type": "refund",
"amount": "42.50",
"ip_address": null,
"processor_code": null,
"processor_message": null,
"processor_transaction_id": "sandbox-refund-1001",
"batch_id": null,
"qrcode": null,
"qrcode_image": "",
"pix_key_type": null,
"pix_key_value": null,
"pix_message": null,
"updated_at": "2026-10-23T15:01:00+00:00",
"created_at": "2026-10-23T15:01:00+00:00"
},
{
"id": "60000000-0000-4000-8000-000000000105",
"success": false,
"status": "declined",
"event_type": "payment",
"amount": "42.50",
"ip_address": null,
"processor_code": null,
"processor_message": null,
"processor_transaction_id": "sandbox-payment-1001",
"batch_id": null,
"qrcode": null,
"qrcode_image": "",
"pix_key_type": "email",
"pix_key_value": "destino@example.com",
"pix_message": "Pagamento para: CONTA DEMO",
"updated_at": "2026-10-23T15:00:00+00:00",
"created_at": "2026-10-23T15:00:00+00:00"
}
],
"document_number": "12345678909",
"status": "failed",
"flow_type": "cashout",
"error": {
"type": "ERROR_BANK_CASH_OUT",
"code": "4",
"message": "The transfer was rejected by the receiving bank",
"meta": []
},
"e2e_id": null,
"statement": []
}
}A saída recebeu um evento de devolução. O efeito bancário depende do processador.
Responda com HTTP 200 a 226. O entregador atual considera respostas fora desse intervalo como falha e pode tentar novamente.
Consulte Validar a assinatura para validar
x-azentech-webhook-signature. Se a sua inscrição usa o modo legado, valide o cabeçalho Signature com o fluxo legado documentado na mesma página.Headers
Base64 dos caracteres hexadecimais minúsculos do HMAC-SHA256 do JSON compacto, usando o segredo da inscrição.
Body
application/json
Response
Confirmação recomendada do recebedor.