Webhook event: payment.succeeded

When it fires

payment.succeeded is emitted when a scheduled repayment settles. 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.succeeded",
  "created": "2026-08-04T02:00:00Z",
  "livemode": true,
  "api_version": "2026-07-01",
  "data": {
    "object": {
      "id": "pay_7M3X1",
      "loan_id": "loan_2K9P4",
      "amount": 2200,
      "currency": "GBP",
      "status": "succeeded",
      "settled_at": "2026-08-04T02:00:00Z"
    }
  }
}

Handling it

A common handler will reconcile the payment and update the balance. 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.