v1

latestOpenAPI 3.0.02026-07-2656110201.6 KB

Withdrawals

Update (Re-quote) a Withdrawal Detail

Re-quotes an existing withdrawal in place when inputs change or the quote expires. Returns a fresh token, prepared payload, and summary while reusing the same withdrawalDetailId. Only details in QUOTED state are re-quotable. Optional customerId on the request body is ignored; it is set only on prepare.

patch/v1/withdraw-details/{id}

Path parameters

idstring required

The withdrawal detail ID from prepare.

Request body

ownerAddressstring required

Holder's source wallet address. Format is lane-specific (e.g. Solana base58 for Solana raw, EVM checksummed address for EVM raw/hyperliquid).

recipientstring required

Destination address on any supported chain.

amountstring required

Amount in atomic units as a decimal-free string (e.g. 1500000 for 1.5 USDC).

toCurrencyIdstring required

Destination currency Mongo ID.

sourceCurrencyIdstring required

Source currency Mongo ID from the withdrawal config.

customerIdstring

Optional merchant identifier for the end user (max 255 characters). Persisted on prepare and echoed on the withdrawal detail and webhooks. Not applied on re-quote.

Response

Withdrawal re-quoted successfully.

withdrawalDetailIdstring

Per-request ID. Use for submit and status polling.

tokenstring

JWT quote token. Pass verbatim on submit.