Payments transfers failed

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

postWebhookpaymentsTransfersFailed

Payload

eventIDstring uuid required

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

eventType'payments.transfers.failed' required

The type of webhook event.

timestampstring date-time required

The UTC ISO 8601 timestamp at which the underlying state change occurred, not the time at which this webhook was delivered.

Example payload

{
  "eventID": "123e4567-e89b-12d3-a456-426614174000",
  "eventType": "payments.transfers.failed",
  "timestamp": "2026-01-01T00:05:00Z",
  "data": {
    "transferId": "transfer_af2937b0-9846-4fe7-bfe9-ccc22d935114",
    "status": "failed",
    "source": {
      "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
      "asset": "usd"
    },
    "target": {
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "network": "base",
      "asset": "usdc"
    },
    "sourceAmount": "103.50",
    "sourceAsset": "usd",
    "targetAmount": "100.00",
    "targetAsset": "usdc",
    "failureReason": "Insufficient balance to complete this transfer.",
    "createdAt": "2026-01-01T00:00:00Z",
    "updatedAt": "2026-01-01T00:05:00Z"
  }
}

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.