Transfers

Payments transfers processing

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

postWebhookpaymentsTransfersProcessing

Payload

eventIDstring uuid required

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

eventType'payments.transfers.processing' 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.processing",
  "timestamp": "2026-01-01T00:05:00Z",
  "data": {
    "transferId": "transfer_af2937b0-9846-4fe7-bfe9-ccc22d935114",
    "status": "completed",
    "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",
    "completedAt": "2025-01-01T00:05:00Z",
    "createdAt": "2025-01-01T00:00:00Z",
    "updatedAt": "2025-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.