Skip to main content
POST
Create Transaction

Create Transaction

Creates a new transaction. The type parameter determines the flow. See the Transaction Lifecycle guide for status flows and the Pool Settlement guide for the two-step pool workflow.
Idempotency Required: Include an Idempotency-Key header (UUID) to prevent duplicate transactions. See Idempotency for details.

Headers

Idempotency-Key
string
required
A unique UUID for each transaction. One key = one transaction.

Body Parameters

type
string
required
Transaction type: sell, pool_settlement, or buy. (payout is an accepted alias for pool_settlement.)
userId
string
required
The user ID. Must have completed KYC when KYC is enforced on your account.
amountInr
string
required
pool_settlement only. Gross INR to disburse from your escrow balance. TDS (if enabled) is withheld from this — the user receives the net.
amount
string
required
sell only. Amount in stablecoin units (e.g., “100”).
asset
string
required
sell only. Stablecoin: USDC or USDT
network
string
required
sell only. Blockchain: polygon, ethereum, arbitrum, base, tron
partnerReference
string
Your internal reference ID. For pool_settlement, this is also a business idempotency key: retrying with the same partnerReference returns the original payout and never sends a second transfer.
metadata
object
Custom key-value metadata

Request

Only available on accounts with transactionMode: sell or transactionMode: both.

Response

Errors