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

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

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

post

Header parameters

x-api-public-keystringOptional

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

x-api-signaturestringOptional

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

Content-typestringOptional

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

Example: application/json

Body

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

advancedBalanceIdstringRequired

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

Example: 2db11a99-a1cb-44f1-ba3b-ee41d80f53be

addressIdstringRequired

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

Example: e5b79674-72aa-46c5-9bc0-6c71176bbd61

addressstringRequired

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

Example: 0x00000005707bf50efa35a2db020ede9ac08ae226

tagstring | nullOptional

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

amountstringRequired

Сумма вывода

Example: 123.12

feeTokenstringRequired

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

Example: U2FsdGVkX1+xPSxeuUcfampBAWDDbmjIgDt9N8n3SUiVofu/XY2cgx6PW/2xDpu9Pa71XLOPcr65kQD0ZL93HuuY3j30j/WsxDy862RkqoGUHaBnB+5m4U9biRCjZFiifzJVK5iTMZiWk7WLPqGibF/FxTjKa4APk5uf8Z6mHpk=

feeInAmountbooleanOptional

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

webhookUrlstringOptional

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

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

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /api-gateway/make-withdrawal-async HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 457

{
  "advancedBalanceId": "2db11a99-a1cb-44f1-ba3b-ee41d80f53be",
  "addressId": "e5b79674-72aa-46c5-9bc0-6c71176bbd61",
  "address": "0x00000005707bf50efa35a2db020ede9ac08ae226",
  "tag": null,
  "amount": "123.12",
  "feeToken": "U2FsdGVkX1+xPSxeuUcfampBAWDDbmjIgDt9N8n3SUiVofu/XY2cgx6PW/2xDpu9Pa71XLOPcr65kQD0ZL93HuuY3j30j/WsxDy862RkqoGUHaBnB+5m4U9biRCjZFiifzJVK5iTMZiWk7WLPqGibF/FxTjKa4APk5uf8Z6mHpk=",
  "feeInAmount": true,
  "webhookUrl": "https://merchant.domain/webhooks/withdraw"
}

200Success

{
  "success": true,
  "response": {
    "id": "9c261884-0200-45c1-8c7a-f3b37a3f4942",
    "advancedBalanceId": "2db11a99-a1cb-44f1-ba3b-ee41d80f53be",
    "addressId": "e5b79674-72aa-46c5-9bc0-6c71176bbd61",
    "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": "2025-05-14T13:39:50.463Z"
  }
}