Withdrawal - Docs

[POST] Create request for automated withdrawal

This request should be executed to initiate automated withdrawal request.

/private-api/{slug}/withdrawal

{slug} – unique instance name defined for the company.

Parameters

Name	Type	Required	Description
amount	string	Y	amount to withdraw
currency	string	N	currency for withdraw
wallet	string	Y	card number (for fiat currency) or wallet address (for cryptocurrency)
network	string	Y, in case if balance is stored in crypto currency	cryptocurrency network
memo	string	Y, in case if currencies network requires memo	memo tag
external_id	string	N	external id for withdrawal operation
comment	string	N	description for withdrawal operation

Request Payload

{
   "amount":"100",
   "currency":"USDT",
   "wallet":"djfhku2h345h43l63jh423j4v2",
   "network":"TRC20",
   "external_id":"123456",
   "comment":"comment for withdrawal"
}

Response Payload

{
  "request_id":"123",
  "transactions":[
    {
      "id":"123",
      "currency":{
        "id":"123",
        "ticker":"USDT",
        "is_fiat":true,
        "is_used_for_order_exchange":true,
        "icon":"https://icon.svg",
        "precision":2,
        "title":"Tether US"
      },
      "value":"77",
      "status":"PENDING_WITHDRAWAL",
      "type":"CRYPTO_WALLET",
      "network":null,
      "fee":"1",
      "created_at":"2022-11-18 14:27:36",
      "completed_at":null
    }
  ]
}

Check out Transaction entity reference for detailed description.

[POST] Create request for IBAN withdrawal

This request should be executed to initiate funds withdrawal to IBAN.

/private-api/withdrawal-iban

Parameters

Attribute	Type	Required	Description
amount	number	Y	amount to withdraw
message	string	Y	data on bank account (IBAN, address etc)
exchange_currency	string	Y/N	currency of exchange after withdrawal. Required in case if main balance is in crypto.
external_id	string	N	external id for withdrawal operation
comment	string	N	description for withdrawal operation

Request Payload

{
  "amount":"200",
  "message":"IBAN address",
  "exchange_currency":"EUR",
  "external_id":"1234external123",
  "comment":"comment"
}

Response Payload

{
  "request_id": "baa8c39a-2c95-4967-8437-7920513041a1"
}