Order lifecycle and Webhooks - Welcome to Saber Money

This page describes the webhook events and order statuses for the onramp flows: Buy, Pool Buy, and External Buy.

Buy

transaction_status values sent: COMPLETED, FAILED, CANCELLED

{
  "transaction_id": "7c1e4b2a-9f3d-4a61-8e2b-1d5c6f7a8b90",
  "client_id": "3a9f0c12-6b4e-4d7a-9c21-5e8f7a6b4c3d",
  "user_id": "e2d4c6b8-1a3f-4e5d-8c7b-9a0f1e2d3c4b",
  "event": "BUY",
  "fiat_amount": 10000,
  "usd_amount": 113.25,
  "transfer_type": "BANK_TRANSFER",
  "invested_at": "2026-10-09T10:15:30Z",
  "bank_reference_id": "UTR000000001234",
  "transaction_status": "COMPLETED"
}

Pool Buy

transaction_status values sent: CREATED, COMPLETED, FAILED. Same body as Buy; event is BUY.

{
  "transaction_id": "5b8d2e1f-3c4a-4b7e-9d6f-2a1b3c4d5e6f",
  "client_id": "3a9f0c12-6b4e-4d7a-9c21-5e8f7a6b4c3d",
  "user_id": "e2d4c6b8-1a3f-4e5d-8c7b-9a0f1e2d3c4b",
  "event": "BUY",
  "fiat_amount": 50000,
  "usd_amount": 566.25,
  "transfer_type": "BANK_TRANSFER",
  "invested_at": "2026-10-09T11:02:10Z",
  "bank_reference_id": "UTR000000005678",
  "transaction_status": "CREATED"
}

External Buy

status values sent:

Status	Description
`ONRAMP_COMPLETED`	Fiat received, crypto being sent.
`COMPLETED`	Crypto withdrawal to the specified wallet address is completed.
`FAILED`	The order failed.

{
  "id": "9a7b6c5d-4e3f-4a2b-8c1d-0e9f8a7b6c5d",
  "uuid": "9a7b6c5d-4e3f-4a2b-8c1d-0e9f8a7b6c5d",
  "status": "COMPLETED",
  "fiat_symbol": "INR",
  "crypto_symbol": "USDT",
  "fiat_amount": 10000,
  "crypto_amount": 113.25,
  "payment_method": "UPI",
  "exchange_rate": 88.3,
  "crypto_wallet_address": "TXyz...mock...Wallet01",
  "created_at": 1791540930000,
  "source_id": "src_mock_001",
  "bank_transaction_id": "UTR000000009012",
  "tag": "",
  "network": "TRC20",
  "event": "CRYPTO_BUY",
  "user_id": "e2d4c6b8-1a3f-4e5d-8c7b-9a0f1e2d3c4b",
  "txn_hash": "0xmocktxnhash000000000000000000000000000000000000000000000000abcd"
}

On FAILED, failure_code and failure_desc are also included.