Every payment outcome produces exactly one event, normalized into a single schema whether Stripe or Adyen captured it. Events are delivered as POST requests to your registered endpoint with a JSON body.

​
Delivery headers

SwitchFlow-Signature: t=1751798551,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd
SwitchFlow-Event-Id: evt_9f8a7b6c5d
Content-Type: application/json
Verify the signature on every delivery before trusting the payload — see Verifying signatures.

​
Payload

{
  "id": "evt_9f8a7b6c5d",
  "type": "payment.succeeded",
  "created_at": "2026-07-06T10:42:31Z",
  "environment": "LIVE",
  "data": {
    "session_id": "ps_1a2b3c4d",
    "order_ref": "ORDER-10023",
    "amount_minor": 4900,
    "currency": "USD",
    "status": "SUCCEEDED",
    "captured_via": "ADYEN",
    "failover_used": true,
    "reason": null,
    "attempts": [
      {
        "gateway": "STRIPE",
        "outcome": "DECLINED",
        "decline_code": "do_not_honor",
        "latency_ms": 812
      },
      {
        "gateway": "ADYEN",
        "outcome": "APPROVED",
        "decline_code": null,
        "latency_ms": 1104
      }
    ]
  }
}
Webhook payloads use snake_case field names; API request/response bodies use camelCase. The values are the same.

​
Event types

typedata.statusMeaning
payment.succeededSUCCEEDEDA gateway captured the payment; captured_via and failover_used say how
payment.declinedDECLINEDTerminal decline — the trail shows every attempt and decline code
payment.failedFAILED / DEGRADEDNo capture; reason explains (e.g. gateway_blackout when all gateways were down)
payment.refunded—A refund was processed on the capturing gateway

​
Handling guidance

  • Fulfill on payment.succeeded only, after verifying the signature.
  • Key your processing on SwitchFlow-Event-Id (or id) so a redelivered event is a no-op.
  • order_ref is your own reference from session creation — use it to find the order in your system.
  • Respond 2xx fast and process asynchronously; delivery and retry semantics are described in the webhooks guide.