Webhook event: payment.failed

When it fires

payment.failed is emitted when a repayment attempt fails. It fires once per occurrence; a redelivery of the same occurrence carries the same event id.

If your endpoint does not return a 2xx within the timeout, delivery is retried on an exponential backoff schedule — see Webhook delivery and retries. Design your handler to be idempotent so a redelivered event is safe to process twice.

Example delivery

{
  "id": "evt_PAYM7X",
  "type": "payment.failed",
  "created": "2026-07-04T10:00:00Z",
  "livemode": true,
  "api_version": "2026-07-01",
  "data": {
    "object": {
      "id": "pay_7M3X1",
      "loan_id": "loan_2K9P4",
      "amount": 2200,
      "currency": "GBP",
      "status": "failed",
      "failure_code": "insufficient_funds"
    }
  }
}

Handling it

A common handler will trigger a dunning or hardship-signposting flow. Verify the signature first, acknowledge with 200 within 10 seconds, then do the work asynchronously. The underlying resource is the same shape the get loyalty tiers endpoint returns, so you can re-fetch current state if you need it.