Disbursement failed

Triggered when the acceptance.disbursement.failed webhook event is emitted. Your API will receive a POST request at the webhook URL you configured.

postWebhookacceptanceDisbursementFailed

Payload

eventIdstring uuid required

Unique identifier for this webhook event. Use this for idempotency.

timestampstring date-time required

When this event occurred (ISO 8601 format).

eventType'acceptance.disbursement.failed' required

The type of webhook event.

Example payload

{
  "eventType": "acceptance.disbursement.failed",
  "eventId": "345g6789-g01d-34f5-c678-648836396222",
  "timestamp": "2026-04-17T17:01:00Z",
  "data": {
    "disbursementId": "disbursement_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
    "source": {
      "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
      "asset": "usdc"
    },
    "target": {
      "coinbaseUserId": "coinbase_user_abc123"
    },
    "amount": "25.00",
    "asset": "usdc",
    "status": "failed",
    "reason": "Goodwill disbursement for delayed shipment.",
    "externalReferenceId": "disbursement-2026-04-1234",
    "error": {
      "code": "insufficient_funds",
      "message": "The source account does not have sufficient funds.",
      "occurredAt": "2026-04-17T17:01:00.000Z"
    },
    "createdAt": "2026-04-17T17:00:00.000Z",
    "updatedAt": "2026-04-17T17:01:00.000Z"
  }
}

Response

Webhook received and processed 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.