Webhook Events

payout.returned

Sent when a payout is returned after it was sent.

postWebhookpayout.returned

Payload

idstring required

Unique identifier for the event. Stable across retries.

type'payout.returned' required

Event type in resource.action format.

api_versionstring required

API version the payload was rendered at. Stable across retries and redeliveries.

datestring date-time required

ISO 8601 UTC timestamp when the event was created.

Example payload

{
  "id": "550e8400-e29b-41d4-a716-446655440008",
  "api_version": "2026-05-01",
  "payload": {
    "id": "550e8400-e29b-41d4-a716-446655440003",
    "status": "sent",
    "account_id": "550e8400-e29b-41d4-a716-446655440001",
    "amount": "100.50",
    "currency": "USD",
    "counterparty_id": "550e8400-e29b-41d4-a716-446655440000",
    "unstructured_remittance_information": "INV-2026-0042",
    "tracking_reference": {
      "type": "uetr",
      "value": "550e8400-e29b-41d4-a716-446655440000"
    },
    "metadata": {
      "invoice_id": "INV-2026-0042"
    },
    "initiated_at": "2026-01-15T10:30:00Z",
    "sent_at": "2026-01-15T10:35:00Z",
    "rail": "ach"
  },
  "date": "2026-01-15T10:30:00Z"
}

Response

Event received successfully.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.