Создание авто-вывода

Метод создает запрос на авто-вывод

На создание распространяются лимиты сумм:

• сумма должна быть больше $20 в эквиваленте

• сумма должна быть в два раза больше комиссии сети конечной монеты/сети (см. метод получения доступных монет)

Описание параметров запроса

Параметр	Тип	Обязательно	Описание
address	string	yes	Адрес назначения
currency	string	yes	Монета к получению
network	string	yes	Сеть к получению
amountFrom	string	no	Сумма, которую хотите поменять и отправить
amountTo	string	no	Сумма, которую хотите получить
feeInAmount	boolean	no	Закладывать комиссию сети в сумму обмена
webhookUrl	string	no	URL для отправки уведомлений при изменении статуса

Обязательно надо отправить один из параметров: amountFrom или amountTo При указании двух параметров приоритет будет иметь amountFrom

Закладывать комиссию сети в сумму обмена

Указывая параметр feeInAmount в значении true с адреса будет списана указанная сумма + комиссия сети

• Если указывате amountFrom - возможно проскальзывание конечной суммы amountTo (может отличаться от указаной после запроса создания)

• Если указываете amountTo - будет заблокирована расчетная сумма списания с адреса + процент для покрытия страховки проскальзывания. После завершения обмена сумма будет откорректирована, до той, которая была израсходована для проведения обмена. Возможно небольшое проскальзывание (≈ 0.1%) конечной суммы из-за наложения фильтров обмена на сумму к получению

Дополнительное подтверждение

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

В теле вебхука будет указан пользователь запросивший вывод, запрошенная сумма, запрошенная монет и пересчет к выбранной для вывода монете. Вы можете подтвердить или отклонить вывод отправил соответствующее значение в запросе

Дополнительные поля в теле ответа:

Имя	Описание
approveUrl	Урл отправки вебхука для подтверждения
approveResult	Данные о подтверждении
approveResult.apiKey	Данные об API-ключе
approveResult.apiKey.public	Публичная часть API-ключа, с которого пришло подтверждение
approveResult.request	Данные о запросе
approveResult.request.ip	IP адрес, с которого пришел запрос
approveResult.request.userAgent	User-Agent, с которого пришел запрос
approveResult.approve	Подтвержден или отклонен
approveResult.time	Время запроса
requestedClientId	Идентификатор пользователя в системе мерчанта, который запросил вывод
requestedCurrency	Запрошенная монета при создании вывода
requestedAmount	Запрошенная сумма при создании вывода

Создание авто-вывода

POSThttps://ocp.onchainpay.io/api-gateway/auto-withdrawals/create

Header parameters

Body

application/json

address*string

Адрес для получения

Example: "1CGuTUAx7icKniPVKGiyiT7QLycpkxULLP"

currency*string

Монета, которую хотите получить

Example: "BTC"

network*string

Сеть, в которой хотите получить монеты

Example: "bitcoin"

amountFromstring

Исходящая сумма

Example: "1000"

amountTostring

Конечная сумма

Example: "0.1"

feeInAmountboolean

Включать комиссию сети в сумму к обмену, при указании данного параметра amountTo будет равняться сумме, которую получить адрес

webhookUrlstring

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

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

Response

200

Body

application/json

success*boolean

Признак успешности запроса

response*AutoWithdrawal (object)

Request

JavaScriptCurlPython

const response = await fetch('https://ocp.onchainpay.io/api-gateway/auto-withdrawals/create', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "address": "1CGuTUAx7icKniPVKGiyiT7QLycpkxULLP",
      "currency": "BTC",
      "network": "bitcoin"
    }),
});
const data = await response.json();

Response

200

{
  "success": false,
  "response": {
    "id": "57a99f94-59a8-431d-a673-cda8902d8325",
    "organizationId": "bf1a4cb8-5340-4442-8e12-6e0faf3502cd",
    "type": "WITHDRAWAL",
    "status": "PENDING",
    "message": null,
    "addressRiskLevel": "Low",
    "currencyFrom": "USDT",
    "networkFrom": "bsc",
    "currencyTo": "BTC",
    "networkTo": "bitcoin",
    "addressFromId": "25a8de42-a359-47f1-bb82-bc9f6c20f1b9",
    "addressFrom": "0xD65D24ABCd85165a243C33Cf8133ffBaaa98255D",
    "addressTo": "0x22aECc7ff5b435E38be5457C8538256918783F67",
    "amountFrom": "1000",
    "amountFromUSD": "1000",
    "amountTo": "0.1",
    "amountToUSD": "990",
    "amountToReceive": "0.999",
    "rate": "10000",
    "blockchainFeeFrom": "0.34",
    "blockchainFeeFromUSD": "0.34",
    "blockchainFeeToSource": "ADVANCED",
    "blockchainFeeTo": "0.001",
    "blockchainFeeToUSD": "10",
    "serviceFee": "10",
    "txId": "0xadcc95b8bcd123e41612c46b057df889e32a73297e973c21e8b38046ac04130a",
    "webhookUrl": "https://merchant.domain/webhooks/...",
    "approveUrl": "https://merchant.domain/webhooks/...",
    "approveResult": {
      "apiKey": {
        "id": "48851183-ac41-40a9-b797-8028a4f976ef",
        "public": "c9jeO7OJcJb7cnBTVXrgtRzazf60W4Lbsz3/wOYM1m2EsJyZz5wGfbIIuoJ4Ugs6HMowQj8zlv2jf8Vt1ra4Fw=="
      },
      "request": {
        "ip": "123.231.123.100",
        "userAgent": "axios/1.6.0"
      },
      "approve": false,
      "time": "2024-12-11T10:54:03.312Z"
    },
    "requestedClientId": "85df040d-5f92-44cb-9811-c96d3bf4d733",
    "requestedCurrency": "EUR",
    "requestedAmount": "5500",
    "createdAt": "2024-12-11T10:54:03.312Z",
    "updatedAt": "2024-12-11T10:54:03.312Z"
  }
}