Funding

Accept a withdrawal draft

POST/v1/blockchain-manager/order/withdrawal/draft/accept

Confirms and submits a previously created withdrawal draft, creating the actual withdrawal order on the blockchain. The draft must belong to the authenticated user and must not have expired.

Every acceptance requires a second-factor code in the x-totp header. The first request is usually sent without it and answered with 428:

  • For stablecoin withdrawals, the 428 means a code has just been sent to the user, and its body says through which channel (sfaType) and which phone channels are available (availableChannels, defaultChannel).
  • For any other currency, the 428 only says that the code is needed.

Then repeat the same request with the code in x-totp and the channel it came through in x-totp-type. A wrong code returns 420 and nothing is executed.

Authorization

ApiKeyAuth
X-Api-Key<token>

For accessing these endpoints a valid API key must be sent in the X-Api-Key header.

In: header

Header Parameters

x-totp?string

Second-factor code. Without it the response is 428.

Match^[0-9]{4,6}$
x-totp-type?string

Channel through which the code in x-totp was received (e.g. sms, whatsapp, email, gauth).

Value in

  • "gauth"
  • "sms"
  • "email"
  • "call"
  • "whatsapp"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request to accept (confirm) a previously created withdrawal draft.

Response Body

application/json

application/json

application/json

application/json

application/json

Accept a withdrawal draft
curl --request POST \  --url 'https://gateway.bit2me.com/v1/blockchain-manager/order/withdrawal/draft/accept' \  --header 'x-totp: 123456' \  --header 'x-totp-type: sms' \  --header 'Content-Type: application/json' \  --data '{  "draftId": "550e8400-e29b-41d4-a716-446655440010"}'
{  "amount": "0.5",  "chargedFee": "0.0001",  "chargedFeeCurrency": "BTC",  "createdAt": "2026-06-02T12:00:00.000Z",  "currency": "BTC",  "destinationAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",  "network": "bitcoin",  "orderId": "550e8400-e29b-41d4-a716-446655440020",  "status": "created",  "tag": null,  "type": "withdrawal",  "userId": "550e8400-e29b-41d4-a716-446655440099",  "walletPocketId": "550e8400-e29b-41d4-a716-446655440002"}