Transaction Lifecycle

How Payout Works

Type	Steps	Payout
`sell`	1 API call	Automatic — INR is sent as soon as the deposit is confirmed on-chain. No second call needed.
`pool_settlement`	2 API calls	You trigger it — after the sweep is confirmed, call `POST /transactions/:id/payout` to release INR.
`buy`	Coming soon	—

User deposits crypto to their wallet address → StablePay detects and confirms → INR payout is automatic.

Status	What’s happening
`deposit_pending`	Waiting for user to send crypto. Quote valid 24h.
`deposit_detected`	Deposit seen on blockchain. Waiting for confirmations.
`deposit_confirmed`	Confirmations met. Payout initiated automatically.
`payout_processing`	INR bank transfer in progress.
`completed`	INR delivered. UTR available.

Merchant sweeps USDT from their pool wallet → StablePay confirms sweep → merchant triggers INR payout.

Status	What’s happening
`sweep_processing`	USDT being swept from pool wallet for settlement.
`sweep_confirmed`	Sweep confirmed. You must call `POST /transactions/:id/payout` to trigger INR.
`payout_processing`	INR bank transfer in progress.
`completed`	INR delivered. UTR available.

User pays fiat and receives stablecoins in their wallet. Contact us for early access.

Status	What happened	What to do
`failed`	Bank transfer failed	Auto-retries up to 3x, then our team investigates
`cancelled`	Partner cancelled	Create a new transaction
`expired`	No deposit in 24h	Create a new transaction for fresh quote
`sweep_failed`	Sweep failed on-chain	Funds safe in pool. Retry with new transaction

Event	When
`transaction.created`	Transaction created
`transaction.deposit_detected`	Crypto deposit seen on blockchain
`transaction.deposit_confirmed`	Required confirmations met
`transaction.sweep_confirmed`	Pool sweep confirmed on-chain
`transaction.sweep_failed`	Pool sweep failed
`transaction.payout_initiated`	INR bank transfer started
`transaction.payout_completed`	INR delivered, UTR available
`transaction.payout_failed`	Bank transfer failed

See the Webhooks guide for payload format and signature verification.

curl https://api.stablepay.global/v2/transactions/{transactionId} \
  -H "Authorization: Bearer YOUR_API_KEY"