Fetching Transaction Status

Overview

Use the generic v2 transaction endpoint to track the current status of a sell transaction, no matter which offramp flow created it. This allows merchants to poll for completion, surface progress to users, and investigate failures.

Endpoint

URL: https://api.saber.money/api/v2/wallet/transaction Method: GET

Query Param	Required	Description
`transaction_type`	Yes	`POOL_SELL`, `SELL`, or `EXTERNAL_SELL` — must match the flow that created the transaction.
`transaction_id`	Yes	The transaction UUID (`id`) returned from the corresponding create call.

Request Headers

Header	Description
`X-Api-Key`	Your API key
`X-Signature`	HMAC-SHA256 signature (auto-generated)
`X-Timestamp`	Unix timestamp in seconds (auto-generated)
`X-Request-Id`	Unique request identifier (auto-generated)
`X-User-Id`	The user’s UUID

Status values by transaction type

Transaction Type	Possible `status` values
`POOL_SELL`, `SELL`	`CREATED`, `PROCESSING`, `COMPLETED`, `FAILED`, `CANCELLED`, `APPROVAL_REQUIRED`, `SOURCE_INVALID`, `VERIFICATION_PENDING`, `REFUND_INITIATED`, `REFUND_COMPLETED`
`EXTERNAL_SELL`	`CREATED`, `PAYMENT_INITIATED`, `FUNDS_RECEIVED`, `COMPLETED`, `FAILED`, `REFUND_INITIATED`, `REFUND_COMPLETED`, `REFUND_FAILED`

PAYMENT_INITIATED and FUNDS_RECEIVED reflect on-chain funding progress after calling Confirm External Sell On-chain Funding — see Available Flows for the full External Sell sequence, or the INR Offramp Flow walkthrough for the exact confirm call.

Sample Request (Pool Sell)

curl --location 'https://api.saber.money/api/v2/wallet/transaction?transaction_type=POOL_SELL&transaction_id=0195a3a6-62c2-766b-b984-7f9f1754b3f1' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'X-Signature: GENERATED_SIGNATURE' \
--header 'X-Timestamp: 1732265171' \
--header 'X-Request-Id: unique-request-id' \
--header 'X-User-Id: USER_UUID_HERE'

Sample Response

{
  "success": true,
  "data": {
    "transaction_type": "POOL_SELL",
    "status": "COMPLETED",
    "created_at": 1742207345000,
    "updated_at": 1742207346000,
    "id": "0195a3a6-62c2-766b-b984-7f9f1754b3f1",
    "crypto_symbol": "USDT",
    "fiat_symbol": "INR",
    "exchange_rate": 84.56973573047619,
    "crypto_amount": 21,
    "fiat_amount": 1775.96445034,
    "bank_transaction_id": "1234",
    "source_id": ""
  }
}

Key Response Fields

Field	Description	Example Value
`transaction_type`	Echoes the queried type.	`POOL_SELL`
`status`	Current status — see the table above.	`COMPLETED`
`exchange_rate`	The conversion rate used for the transaction.	`84.56973573047619`
`crypto_amount`	The amount of cryptocurrency sold.	`21`
`fiat_amount`	The amount of fiat currency delivered.	`1775.96445034`
`fiat_symbol` / `crypto_symbol`	Currency/asset involved.	`INR` / `USDT`
`id`	Unique identifier for the transaction.	`0195a3a6-62c2-766b-b984-7f9f1754b3f1`
`created_at` / `updated_at`	Unix timestamp in milliseconds.	`1742207345000`
`bank_transaction_id`	Bank reference ID for the fiat transfer. Empty string until settled.	`1234`
`source_id`	Source instrument identifier. Empty string when not applicable.	`""`
`failure_code` / `failure_desc`	Present only if the transaction failed — omitted (key absent) on success.	`FIAT_PAYMENT_FAILED`

Use Cases

Transaction Tracking — Poll status until it reaches a terminal state, to confirm completion.
User Notifications — Reflect progress to end users based on status.
Error Investigation — Use failure_code/failure_desc to diagnose a failed transaction.

Legacy (v1)

The original v1 endpoint remains available for existing integrations, but new integrations should use the v2 endpoint above. URL: https://api.saber.money/api/v1/wallet/conversion/fiat/transaction/{transaction_id} Method: GET

Header	Description
`X-Timestamp`	UNIX timestamp for the request.
`X-Client-Id`	Unique identifier for the merchant.
`X-Request-Id`	A unique identifier for the request (optional but recommended).
`X-Secret-Key`	API secret key for authenticating the request.
`X-User-Id`	The unique ID of the user making the request.

curl --location 'https://api.saber.money/api/v1/wallet/conversion/fiat/transaction/a892dc4a-aecb-4a22-9de4-2990b4179b77' \
--header 'X-Timestamp: 1732265171' \
--header 'X-Client-Id: CLIENT_ID_HERE' \
--header 'X-Request-Id: CC' \
--header 'X-Secret-Key: SECRET_KEY_HERE' \
--header 'X-User-Id: USER_ID_HERE'

Getting Started

Client Admin Operations

Offramp

Onramp

User Operations

Overview

Endpoint

Request Headers

Status values by transaction type

Sample Request (Pool Sell)

Sample Response

Key Response Fields

Use Cases

Legacy (v1)

​Overview

​Endpoint

​Request Headers

​Status values by transaction type

​Sample Request (Pool Sell)

​Sample Response

​Key Response Fields

​Use Cases

​Legacy (v1)

Overview

Endpoint

Request Headers

Status values by transaction type

Sample Request (Pool Sell)

Sample Response

Key Response Fields

Use Cases

Legacy (v1)