Event: charge.failed

Dispatched when a recurring charge fails definitively (rejected after max attempts, permanent card error, etc.).

Schema definition

Loading ....

failure_code and failure_reason are present. reference_number is omitted.

failure_reason is a human-readable message (e.g. Monto Invalido), not the raw gateway JSON envelope.

Example

{
  "event_type": "charge.failed",
  "charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "subscription_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "customer_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "merchant_id": "2e0b4f5a-8c3d-4e1f-9a2b-1c3d4e5f6a7b",
  "amount": 1500.00,
  "currency": "ARS",
  "status": "failed",
  "billing_period_start": "2026-05-01T00:00:00Z",
  "billing_period_end": "2026-06-01T00:00:00Z",
  "attempt_count": 3,
  "processed_at": "2026-05-21T14:30:00Z",
  "failure_code": "13",
  "failure_reason": "Monto Invalido"
}