Order lifecycle and Webhooks - Welcome to Saber Money

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

Sell

transaction_status values sent: COMPLETED, FAILED, REFUND_COMPLETED

{
  "transaction_id": "2f4e6d8c-0b1a-4c3e-9f5d-7a6b8c9d0e1f",
  "client_id": "3a9f0c12-6b4e-4d7a-9c21-5e8f7a6b4c3d",
  "user_id": "e2d4c6b8-1a3f-4e5d-8c7b-9a0f1e2d3c4b",
  "event": "SELL",
  "fiat_amount": 8800,
  "usd_amount": 100,
  "transfer_type": "BANK_TRANSFER",
  "invested_at": "2026-10-09T12:30:00Z",
  "bank_reference_id": "UTR000000003456",
  "transaction_status": "COMPLETED"
}

Pool Sell

transaction_status values sent: COMPLETED, FAILED, REFUND_COMPLETED. Same body as Sell; event is SELL.

{
  "transaction_id": "8c0a2e4f-6b1d-4f3a-8e5c-9d7b1a3c5e7f",
  "client_id": "3a9f0c12-6b4e-4d7a-9c21-5e8f7a6b4c3d",
  "user_id": "e2d4c6b8-1a3f-4e5d-8c7b-9a0f1e2d3c4b",
  "event": "SELL",
  "fiat_amount": 44000,
  "usd_amount": 500,
  "transfer_type": "BANK_TRANSFER",
  "invested_at": "2026-10-09T13:45:20Z",
  "bank_reference_id": "UTR000000007890",
  "transaction_status": "REFUND_COMPLETED"
}

External Sell

status values sent, in order: FUNDS_RECEIVED → PAYMENT_INITIATED → COMPLETED. Failure path: REFUND_INITIATED, REFUND_FAILED, REFUND_COMPLETED (always followed by a FAILED webhook), FAILED.

{
  "id": "4d6f8a0c-2e1b-4a3d-9c5e-6f7a8b9c0d1e",
  "status": "COMPLETED",
  "fiat_symbol": "INR",
  "crypto_symbol": "USDT",
  "fiat_amount": 8800,
  "crypto_amount": 100,
  "payment_method": "BANK_TRANSFER",
  "deposit_crypto_address": "TXyz...mock...Deposit01",
  "deposit_network": "TRC20",
  "deposit_tag": "",
  "sender_wallet_address": "TXyz...mock...Sender01",
  "transaction_hash": "0xmocktxnhash000000000000000000000000000000000000000000000000ef01",
  "destination_instrument_id": "inst_mock_001",
  "refund_wallet_address": "TXyz...mock...Refund01",
  "refund_network": "TRC20",
  "refund_tag": "",
  "failure_code": "",
  "failure_desc": "",
  "created_at": 1791545000000,
  "updated_at": 1791548600000
}

On refund, refund_transaction_hash is also included.