Асинхронный вывод

Метод позволяет создать запрос на вывод монет с адреса и получить результат исполнения на указанный URL в параметре webhookUrl

Асинхронный вывод

post

Header parameters

x-api-public-keystringoptional

Публичный API-ключ

x-api-signaturestringoptional

Подпись тела запроса приватным API-ключем

Content-typestringoptional

Тип тела запроса

Example: application/json

Body

Тело запроса создания вывода

advancedBalanceIdstringrequired

Идентификатор авансового баланса для списания комиссий

Example: 50781c26-1005-4b1e-94ea-a19a17017e90

addressIdstringrequired

Идентификатор адреса, с которого надо вывести монеты

Example: 47ce6b06-bce3-4172-b2a4-ce5206487491

addressstringrequired

Адрес для отправки монет

Example: 0x00000005707bf50efa35a2db020ede9ac08ae226

tagstring | nulloptional

Тег (memo) адреса (актуально для сетей поддерживающих тег, например Ripple)

amountstringrequired

Сумма вывода

Example: 123.12

feeTokenstringrequired

Токен комисси, который без создан при запросе /request-fee

Example: U2FsdGVkX1+VQLveRY+0+81+7kD5ngGngne2/rsrW+XAexZv9dGmOXoJ+fnmCIUIs5fkIm8QzaH7V5/pcf48DytQbJtAahv8m7XWU6U1GIv8vM8UP19nDcKkOrzYCIco2GQflQ081kKpNqIxaopySRojm4TS4DYQkFQHAarYGgI=

feeInAmountbooleanoptional

(Актуально для вывода монет) Удерживать комиссию сети из суммы вывода или из средств плательщика. По умолчанию комиссия сети берется из суммы вывода

webhookUrlstringoptional

URL для отправки векхука при изменении статуса вывода

Example: https://merchant.domain/webhooks/withdraw

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://ocp.onchainpay.io/api-gateway/make-withdrawal-async' \
  --header 'Content-Type: application/json' \
  --data '{
    "advancedBalanceId": "50781c26-1005-4b1e-94ea-a19a17017e90",
    "addressId": "47ce6b06-bce3-4172-b2a4-ce5206487491",
    "address": "0x00000005707bf50efa35a2db020ede9ac08ae226",
    "tag": null,
    "amount": "123.12",
    "feeToken": "U2FsdGVkX1+VQLveRY+0+81+7kD5ngGngne2/rsrW+XAexZv9dGmOXoJ+fnmCIUIs5fkIm8QzaH7V5/pcf48DytQbJtAahv8m7XWU6U1GIv8vM8UP19nDcKkOrzYCIco2GQflQ081kKpNqIxaopySRojm4TS4DYQkFQHAarYGgI=",
    "feeInAmount": true,
    "webhookUrl": "https://merchant.domain/webhooks/withdraw"
  }'

200

200

{
  "success": true,
  "response": {
    "id": "99284a0a-e9e9-46af-bb77-2637c710dbe6",
    "advancedBalanceId": "50781c26-1005-4b1e-94ea-a19a17017e90",
    "addressId": "47ce6b06-bce3-4172-b2a4-ce5206487491",
    "currency": "USDT",
    "network": "ethereum",
    "tx": "null",
    "status": "pending",
    "address": "0x00000005707bf50efa35a2db020ede9ac08ae226",
    "tag": null,
    "amount": "123.12",
    "feeCurrency": "0x00000005707Bf50EfA35a2db020eDe9Ac0780b9f",
    "feeSource": "advanced_balance",
    "feeAmount": "1.12",
    "webhookUrl": "https://merchant.domain/webhooks/withdraw",
    "createdAt": "2024-12-25T14:35:23.163Z"
  }
}