Skip to main content
POST
Quote withdrawals

Authorizations

X-Api-Key
string
header
default:sb_test_your_key
required

API credential. Withdrawal quote and submit operations additionally require the documented Ed25519 timestamp, nonce, and signature headers.

Headers

X-Stabyl-Timestamp
string
required

Current Unix time in milliseconds. The server accepts at most 30 seconds of clock skew.

X-Stabyl-Nonce
string<uuid>
required

A new UUIDv4 or UUIDv7 for this HTTP attempt. A verified nonce is single-use for five minutes.

X-Stabyl-Signature
string
required

Unpadded base64url Ed25519 signature of the version 1 canonical payload. The exact path includes the server prefix, for example /v1/partner/wallets/withdrawals.

Body

application/json

List-shaped NGN or one-item USD withdrawal to quote. Do not include an authorization token; the signed HTTP request authenticates the caller and quoting does not reserve funds.

currency
string
required
Example:

"NGN"

items
object[]
required
settlement_rail
string | null
Example:

"USDC"

Response

Withdrawal quote

data
object
required
status
enum<string>
required
Available options:
success