Skip to main content
POST
Create withdrawal

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 withdrawal request to execute directly. Include a stable business idempotency key and do not send an authorization token.

currency
string
required
Example:

"USD"

idempotency_key
string
required
items
object[]
required
settlement_rail
string | null
Example:

"USDC"

Response

Parent withdrawal accepted

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