Skip to main content
POST
Quote withdrawals
Withdrawal quote and submit calls require an Ed25519 signature over the exact HTTP method, request path and query, timestamp, nonce, and raw body hash. Reuse the business idempotency key with a new timestamp, nonce, and signature when retrying an uncertain response.

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