pix.refund.failed

Payload

{
  "id": "pix-refund-9ccd1869-7593-4feb-9602-e525e818ab8e",
  "type": "pix.refund.failed",
  "occurredAt": "2026-09-16T20:58:46.258668746Z",
  "schemaVersion": "1.0",
  "environment": "production",
  "tenantId": "tenant-acme",
  "data": {
    "paymentId": "9ccd1869-7593-4feb-9602-e525e818ab8e",
    "tenantId": "tenant-acme",
    "accountId": "acc_123456",
    "status": "FAILED",
    "endToEnd": "",
    "amount": 150.5,
    "currency": "BRL",
    "description": "Devolução PIX",
    "identifier": "refund-998",
    "originalTransactionId": "2ee948cb-4e03-43d1-b202-b7fb31d5b016",
    "initiatedAt": "2026-09-16T20:58:42.646763686Z",
    "completedAt": "2026-09-16T20:58:46.258668746Z",
    "error": "transação original já devolvida",
    "errorCode": "already_refunded",
    "errorReason": "transação original já devolvida"
  },
  "accountId": "acc_123456"
}

Refund que iniciamos falhou

Enviado quando a devolução que nós disparamos falha. Mesmo shape de pix.out.failed, com type: "pix.refund.failed" e id pix-refund-{paymentId}.

Payload

The payload of this webhook request is an object.

idstringRequired

Deterministic event id. Same id means the same event, possibly redelivered — deduplicate on it.

typeenumRequired

Event type. Full list at GET /v1/webhooks/events.

Allowed values:

occurredAtdatetimeRequired

RFC 3339, UTC with Z.

schemaVersionstringRequired

1.0 today; bumped only on breaking payload changes.

environmentenumRequired

Environment that emitted the event.

Allowed values:

tenantIdstringRequired

Tenant the event belongs to.

dataobjectRequired

Event-specific payload. See each webhook.

accountIdstringOptional

CorpX account where the event happened. Empty on cross-account events.

Response

2XX

Acknowledged. Any 2xx within 10 seconds stops retries; anything else is retried with backoff (see the Webhooks guide).

pix.refund.failed

Headers

Payload

Response

Headers

Payload

Response