Вывод средств

Для того чтобы осуществить вывод средств:

1. Войдите в свою учетную запись AlfaBit Pay.

2. Перейдите в раздел “Мерчанты”.

3. Выберите валюту, которую хотите вывести.

4. Нажмите кнопку “Вывести”.

5. Укажите реквизиты и сумму вывода.

6. Подтвердите 2FA.

7. Ожидайте получения средств.

Вывод с автоконвертацией (withdraw-with-exchange)

Функционал представляет собой новый тип операции и позволяет клиентам PAY выводить активы со счета PAY с конвертацией в другую валюту.

Пример User Story

Как клиент Pay, я хочу вывести 0.1 BTC на внешний кошелек, но чтобы списание произошло с моего счёта в USDT. Для корректного выполнения операции расчет выполняется в обратном порядке: начиная с расчёта всех комиссий, затем выполняется конвертация и вывод.

Основные шаги реализации:

1. Расчет сетевой брокерской комиссии: К указанной пользователем сумме прибавляется сетевая брокерская комиссия за вывод. Эта комиссия зависит от текущих условий сети и может быть фиксированной или динамической.

2. Добавление сервисной комиссии: К полученной сумме добавляется сервисная комиссия Pay за предоставление услуги по выводу средств, процент от суммы вывода определяется тарифом.

3. Конвертация в целевую валюту: После расчета комиссий выполняется конвертация итоговой суммы.

Создание заявки Вывод с обменом

  Заявка на вывод с конвертацией.
  Процесс включает два этапа: Обмен -> Вывод.
  Например, при выводе USDT в BTC:
    1. USDT (fromAssetCode) с баланса мерчанта конвертируются в BTC
    2. BTC (toCurrencyCode) выводятся  на указанный адрес (recipient) в сети Bitcoin.
  
  Важно:Сумма вывода (amount) указывается в toCurrencyCode.
 
  Совет: Для оценки суммы currencyInCode можно воспользоваться методом "orders/estimate-in".    

POST/api/v1/integration/orders/withdraw-with-exchange

Header parameters

Body

application/json

amount*string

Сумма выхода

Example: 10

toCurrencyCode*string

Валюта получения (с сетью)

Example: "USDTMATIC"

recipient*string

Реципиент (адрес)

Example: "0x0000000000000000000000000000000000000000"

requisitesMemoTagstring

Мемо тег (для XRP, TON и т.д.)

Example: "80576"

callbackUrlstring

Callback url для отправки хуков

Example: "https://api.myip.com"

commentstring

Комментарий к переводу. Опциональное поле

Example: "Оплата сервера за 07.2023"

detailsobject

Детали для фиатных выводов

Example: "{\"method\":\"card\"}"

fromAssetCode*string

Ассет из которого конвертируется

Example: "BTC"

Response

200400401403500

Успешное создание заявки на вывод с обменом

Body

application/json

message*string

Сообщение статуса

Example: "ok"

dataobject

Данные

countnumber

Общее кол-во элементов в БД

Example: 1

dataOrderSerializer (object)

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/integration/orders/withdraw-with-exchange', {
    method: 'POST',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "amount": 10,
      "toCurrencyCode": "USDTMATIC",
      "recipient": "0x0000000000000000000000000000000000000000",
      "fromAssetCode": "BTC"
    }),
});
const data = await response.json();

Response

200400401403500

{
  "message": "ok",
  "count": 1,
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2024-10-04T20:34:23.601Z",
    "updatedAt": "2024-10-04T20:34:23.601Z",
    "deletedAt": "2024-10-04T20:34:23.601Z",
    "comment": "Комментарий",
    "publicComment": "Публичный комментарий",
    "merchantUid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "merchantName": "Тестовый мерчант",
    "merchantId": 6547,
    "type": "invoice",
    "status": "created",
    "invoiceCurrencyCode": "BTC",
    "currencyInCode": "USDTERC20",
    "currencyOutCode": "USDT",
    "invoiceAmount": "10.2334",
    "amountInExpected": "43.11",
    "amountInFact": "44",
    "amountOutExpected": "43.11,",
    "amountOutFact": "44",
    "hedgeRate": "44",
    "paymentTiming": "onTime",
    "amountValidity": "valid",
    "isDone": false,
    "apiMode": "ui",
    "risk": "24",
    "requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "requisitesMemoTag": "80576",
    "billingTag": "[e-mail]",
    "requisitesQrCode": "https://example.com/img-name.png",
    "serviceCommission": "0.565",
    "netCommission": "0.565",
    "serviceFeeCurrencyCode": "USDT",
    "netFeeCurrencyCode": "USDT",
    "balanceAfter": "44",
    "callbackUrl": "https://example/myCallback",
    "invoicePublicUrl": "https://example/myInvoice",
    "txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "expirationTime": "2024-10-04T20:34:23.601Z",
    "isImPayed": false
  }
}