API Reference

Эндпоинт:

https://pay.alfabit.org/

Получение списка ордеров мерчанта

GET/api/v1/integration/orders

Query parameters

Header parameters

Response

Успешное получение списка ордеров мерчанта

Body

message*string

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

countnumber

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

dataarray of OrderListSerializer (object)

Request

const response = await fetch('/api/v1/integration/orders', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": [
    {
      "id": 1,
      "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
      "createdAt": "2024-05-20T06:58:55.873Z",
      "updatedAt": "2024-05-20T06:58:55.873Z",
      "deletedAt": "2024-05-20T06:58:55.873Z",
      "comment": "Комментарий",
      "publicComment": "Публичный комментарий",
      "merchantUid": "3422b448-2460-4fd2-9183-8000de6f8343",
      "merchantName": "Тестовый мерчант",
      "type": "invoice",
      "status": "created",
      "invoiceCurrencyCode": "BTC",
      "currencyInCode": "USDT",
      "currencyOutCode": "RUB",
      "invoiceAmount": "10.2334",
      "amountInExpected": "43.11",
      "amountInFact": "44",
      "amountOutExpected": "43.11,",
      "amountOutFact": "44",
      "hedgeRate": "44",
      "paymentTiming": "onTime",
      "amountValidity": "valid",
      "isDone": false,
      "apiMode": "ui",
      "risk": "2"
    }
  ]
}

Примечание

Параметры statuses, types, merchantsUids, billingTags и assets метода /client/v1/api/orders фактически являются массивами строк. Пример использования:

curl -X 'GET' 'https://gateway.tst.alfacore.net/client/v1/api/orders?statuses=failed&types=invoice&types=invoice-without-amount&assets=BTC&assets=BNB'

Примеры и схему ответов можно посмотреть в соответствующем подразделе метода.

Получение информации по ордеру

GET/api/v1/integration/orders/{orderUid}

Path parameters

orderUid*string

Header parameters

Response

Успешное получение информации по ордеру

Body

message*string

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

countnumber

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

dataOrderSerializer (object)

Request

const response = await fetch('/api/v1/integration/orders/{orderUid}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2024-05-20T06:58:55.873Z",
    "updatedAt": "2024-05-20T06:58:55.873Z",
    "deletedAt": "2024-05-20T06:58:55.873Z",
    "comment": "Комментарий",
    "publicComment": "Публичный комментарий",
    "merchantUid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "merchantName": "Тестовый мерчант",
    "type": "invoice",
    "status": "created",
    "invoiceCurrencyCode": "BTC",
    "currencyInCode": "USDT",
    "currencyOutCode": "RUB",
    "invoiceAmount": "10.2334",
    "amountInExpected": "43.11",
    "amountInFact": "44",
    "amountOutExpected": "43.11,",
    "amountOutFact": "44",
    "hedgeRate": "44",
    "paymentTiming": "onTime",
    "amountValidity": "valid",
    "isDone": false,
    "apiMode": "ui",
    "risk": "2",
    "requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "serviceCommission": "0.565",
    "netCommission": "0.565",
    "serviceFeeCurrencyCode": "USDT",
    "netFeeCurrencyCode": "USDT",
    "billingTag": "example@mail.com",
    "balanceAfter": "44",
    "callbackUrl": "https://example/myCallback",
    "invoicePublicUrl": "https://example/myInvoice",
    "txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "expirationTime": "2024-05-20T06:58:55.873Z",
    "isImPayed": false
  }
}

Создание инвойса

  Создание инвойса с указанием суммы оплаты.
  Инвойс формируется в валюте invoiceAssetCode. 
  Платеж производится в валюте, указанной в параметре currencyInCode. 
  Если не заполнено - покупателю будет предложен список доступных для оплаты валют.

POST/api/v1/integration/orders/invoice

Header parameters

Body

currencyInCodestring

Валюта, выбранная для оплаты покупателем

commentstring

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

publicCommentstring

Публичный комментарий к ордеру. Опциональное поле

callbackUrlstring

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

redirectUrlstring

Url для перенаправления покупателя после оплаты

invoiceAssetCode*string

Ассет, в котором выстален счет покупателю

invoiceAmount*string

Сумма для оплаты в $invoiceAssetCode

Response

Успешное создание инвойса

Body

message*string

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

countnumber

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

dataOrderSerializer (object)

Request

const response = await fetch('/api/v1/integration/orders/invoice', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "invoiceAssetCode": "RUB",
      "invoiceAmount": 5000
    }),
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2024-05-20T06:58:55.873Z",
    "updatedAt": "2024-05-20T06:58:55.873Z",
    "deletedAt": "2024-05-20T06:58:55.873Z",
    "comment": "Комментарий",
    "publicComment": "Публичный комментарий",
    "merchantUid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "merchantName": "Тестовый мерчант",
    "type": "invoice",
    "status": "created",
    "invoiceCurrencyCode": "BTC",
    "currencyInCode": "USDT",
    "currencyOutCode": "RUB",
    "invoiceAmount": "10.2334",
    "amountInExpected": "43.11",
    "amountInFact": "44",
    "amountOutExpected": "43.11,",
    "amountOutFact": "44",
    "hedgeRate": "44",
    "paymentTiming": "onTime",
    "amountValidity": "valid",
    "isDone": false,
    "apiMode": "ui",
    "risk": "2",
    "requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "serviceCommission": "0.565",
    "netCommission": "0.565",
    "serviceFeeCurrencyCode": "USDT",
    "netFeeCurrencyCode": "USDT",
    "billingTag": "example@mail.com",
    "balanceAfter": "44",
    "callbackUrl": "https://example/myCallback",
    "invoicePublicUrl": "https://example/myInvoice",
    "txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "expirationTime": "2024-05-20T06:58:55.873Z",
    "isImPayed": false
  }
}

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

Вывод средств на внешний адрес.

POST/api/v1/integration/orders/withdraw

Header parameters

Body

amount*string

Сумма для перевода

toCurrencyCode*string

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

recipient*string

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

callbackUrlstring

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

commentstring

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

Response

Успешное создание вывода

Body

message*string

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

countnumber

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

dataOrderSerializer (object)

Request

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

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2024-05-20T06:58:55.873Z",
    "updatedAt": "2024-05-20T06:58:55.873Z",
    "deletedAt": "2024-05-20T06:58:55.873Z",
    "comment": "Комментарий",
    "publicComment": "Публичный комментарий",
    "merchantUid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "merchantName": "Тестовый мерчант",
    "type": "invoice",
    "status": "created",
    "invoiceCurrencyCode": "BTC",
    "currencyInCode": "USDT",
    "currencyOutCode": "RUB",
    "invoiceAmount": "10.2334",
    "amountInExpected": "43.11",
    "amountInFact": "44",
    "amountOutExpected": "43.11,",
    "amountOutFact": "44",
    "hedgeRate": "44",
    "paymentTiming": "onTime",
    "amountValidity": "valid",
    "isDone": false,
    "apiMode": "ui",
    "risk": "2",
    "requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "serviceCommission": "0.565",
    "netCommission": "0.565",
    "serviceFeeCurrencyCode": "USDT",
    "netFeeCurrencyCode": "USDT",
    "billingTag": "example@mail.com",
    "balanceAfter": "44",
    "callbackUrl": "https://example/myCallback",
    "invoicePublicUrl": "https://example/myInvoice",
    "txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "expirationTime": "2024-05-20T06:58:55.873Z",
    "isImPayed": false
  }
}

Создание обмена

Конвертация на сумму amountIn в валюте assetCodeIn в валюту assetCodeOut.

POST/api/v1/integration/orders/exchange

Header parameters

Body

assetCodeIn*string

Ассет на входе в обмен

amountIn*number

Обмениваемая сумма

assetCodeOut*string

Ассет на выходе

amountOut*number

Ожидаемая сумма

commentstring

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

Response

Успешное создание обмена

Body

message*string

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

countnumber

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

dataOrderSerializer (object)

Request

const response = await fetch('/api/v1/integration/orders/exchange', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "assetCodeIn": "USDT",
      "amountIn": 10,
      "assetCodeOut": "USDT",
      "amountOut": 10
    }),
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2024-05-20T06:58:55.873Z",
    "updatedAt": "2024-05-20T06:58:55.873Z",
    "deletedAt": "2024-05-20T06:58:55.873Z",
    "comment": "Комментарий",
    "publicComment": "Публичный комментарий",
    "merchantUid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "merchantName": "Тестовый мерчант",
    "type": "invoice",
    "status": "created",
    "invoiceCurrencyCode": "BTC",
    "currencyInCode": "USDT",
    "currencyOutCode": "RUB",
    "invoiceAmount": "10.2334",
    "amountInExpected": "43.11",
    "amountInFact": "44",
    "amountOutExpected": "43.11,",
    "amountOutFact": "44",
    "hedgeRate": "44",
    "paymentTiming": "onTime",
    "amountValidity": "valid",
    "isDone": false,
    "apiMode": "ui",
    "risk": "2",
    "requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "serviceCommission": "0.565",
    "netCommission": "0.565",
    "serviceFeeCurrencyCode": "USDT",
    "netFeeCurrencyCode": "USDT",
    "billingTag": "example@mail.com",
    "balanceAfter": "44",
    "callbackUrl": "https://example/myCallback",
    "invoicePublicUrl": "https://example/myInvoice",
    "txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "expirationTime": "2024-05-20T06:58:55.873Z",
    "isImPayed": false
  }
}

Создание перевода между аккаунтами

Перевод средств на другой аккаунт внутри системы.

POST/api/v1/integration/orders/account-transfer

Header parameters

Body

amount*number

Сумма для перевода

asssetCode*string

Отправляемый ассет

recipient*string

Реципиент (UID мерчанта)

commentstring

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

Response

Успешное создание перевода

Body

message*string

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

countnumber

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

dataOrderSerializer (object)

Request

const response = await fetch('/api/v1/integration/orders/account-transfer', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "amount": 10,
      "asssetCode": "USDT",
      "recipient": "uuuuu-xxxx-zzzzz"
    }),
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2024-05-20T06:58:55.873Z",
    "updatedAt": "2024-05-20T06:58:55.873Z",
    "deletedAt": "2024-05-20T06:58:55.873Z",
    "comment": "Комментарий",
    "publicComment": "Публичный комментарий",
    "merchantUid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "merchantName": "Тестовый мерчант",
    "type": "invoice",
    "status": "created",
    "invoiceCurrencyCode": "BTC",
    "currencyInCode": "USDT",
    "currencyOutCode": "RUB",
    "invoiceAmount": "10.2334",
    "amountInExpected": "43.11",
    "amountInFact": "44",
    "amountOutExpected": "43.11,",
    "amountOutFact": "44",
    "hedgeRate": "44",
    "paymentTiming": "onTime",
    "amountValidity": "valid",
    "isDone": false,
    "apiMode": "ui",
    "risk": "2",
    "requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "serviceCommission": "0.565",
    "netCommission": "0.565",
    "serviceFeeCurrencyCode": "USDT",
    "netFeeCurrencyCode": "USDT",
    "billingTag": "example@mail.com",
    "balanceAfter": "44",
    "callbackUrl": "https://example/myCallback",
    "invoicePublicUrl": "https://example/myInvoice",
    "txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "expirationTime": "2024-05-20T06:58:55.873Z",
    "isImPayed": false
  }
}

Оценка входа

  Метод предназначен для оценки суммы, которую необходимо заплатить в валюте fromCurrencyCode       для получения суммы amountTo в валюте toCurrencyCode (с учетом курса обмена и комиссии).

POST/api/v1/integration/orders/estimate-invoice-in

Header parameters

Body

toCurrencyCode*string

Валюта на выходе

amountTo*number

Сумма на выходе

fromCurrencyCodestring

Валюта на входе

Response

Успешная оценка входа

Body

message*string

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

countnumber

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

dataEstimationSerializer (object)

Request

const response = await fetch('/api/v1/integration/orders/estimate-invoice-in', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "toCurrencyCode": "USDTBEP20",
      "amountTo": 10
    }),
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "currencyCode": "BTC",
    "amount": "2.334"
  }
}

Оценка выхода

  Метод предназначен для оценки суммы, которая будет получена в валюте toCurrencyCode       при оплате суммы amountFrom в валюте fromCurrencyCode (с учетом курса обмена и комиссии).

POST/api/v1/integration/orders/estimate-invoice-out

Header parameters

Body

toCurrencyCode*string

Выходная валюта

fromCurrencyCode*string

Отдаваемая валюта

amountFrom*number

Отдаваемая сумма

Response

Успешная оценка выхода

Body

message*string

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

countnumber

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

dataEstimationSerializer (object)

Request

const response = await fetch('/api/v1/integration/orders/estimate-invoice-out', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "toCurrencyCode": "USDTBEP20",
      "fromCurrencyCode": "BTC",
      "amountFrom": 10
    }),
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "currencyCode": "BTC",
    "amount": "2.334"
  }
}

Создание инвойса без суммы

  Создание инвойса без указания суммы оплаты.
  Инвойс формируется в валюте invoiceAssetCode. 
  Платеж производится в валюте, указанной в параметре currencyInCode. 
  Если не заполнено - покупателю будет предложен список доступных для оплаты валют.

POST/api/v1/integration/orders/invoice/without-amount

Header parameters

Body

currencyInCodestring

Валюта, выбранная для оплаты покупателем

commentstring

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

publicCommentstring

Публичный комментарий к ордеру. Опциональное поле

callbackUrlstring

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

redirectUrlstring

Url для перенаправления покупателя после оплаты

Response

Успешное создание инвойса без суммы

Body

message*string

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

countnumber

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

dataOrderSerializer (object)

Request

const response = await fetch('/api/v1/integration/orders/invoice/without-amount', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2024-05-20T06:58:55.873Z",
    "updatedAt": "2024-05-20T06:58:55.873Z",
    "deletedAt": "2024-05-20T06:58:55.873Z",
    "comment": "Комментарий",
    "publicComment": "Публичный комментарий",
    "merchantUid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "merchantName": "Тестовый мерчант",
    "type": "invoice",
    "status": "created",
    "invoiceCurrencyCode": "BTC",
    "currencyInCode": "USDT",
    "currencyOutCode": "RUB",
    "invoiceAmount": "10.2334",
    "amountInExpected": "43.11",
    "amountInFact": "44",
    "amountOutExpected": "43.11,",
    "amountOutFact": "44",
    "hedgeRate": "44",
    "paymentTiming": "onTime",
    "amountValidity": "valid",
    "isDone": false,
    "apiMode": "ui",
    "risk": "2",
    "requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "serviceCommission": "0.565",
    "netCommission": "0.565",
    "serviceFeeCurrencyCode": "USDT",
    "netFeeCurrencyCode": "USDT",
    "billingTag": "example@mail.com",
    "balanceAfter": "44",
    "callbackUrl": "https://example/myCallback",
    "invoicePublicUrl": "https://example/myInvoice",
    "txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "expirationTime": "2024-05-20T06:58:55.873Z",
    "isImPayed": false
  }
}

Получение доступных пар обмена мерчанта

GET/api/v1/integration/assets/exchange-rate

Query parameters

Header parameters

Response

Успешное получение пар обмена мерчанта

Body

message*string

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

countnumber

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

dataarray of PairSerializer (object)

Request

const response = await fetch('/api/v1/integration/assets/exchange-rate', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": [
    {
      "pairCode": "BTC/BNB",
      "fromAssetCode": "BTC",
      "toAssetCode": "BNB",
      "fromCurrencyType": "COIN",
      "toCurrencyType": "COIN",
      "minIn": 1,
      "minOut": 0.000001,
      "rate": 123.70237506185059,
      "isTurnRate": false
    }
  ]
}

Получение включенных ассетов мерчанта

GET/api/v1/integration/assets/enabled

Header parameters

Response

Успешное получение включенных ассетов мерчанта

Body

message*string

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

countnumber

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

dataarray of AssetSerializer (object)

Request

const response = await fetch('/api/v1/integration/assets/enabled', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": [
    {
      "code": "BNB",
      "type": "COIN",
      "usdPrice": "2000",
      "currencies": [
        {
          "assetCode": "BNB",
          "fiatCode": "RUB",
          "isInternal": false,
          "publicName": "BinanceCoin(BNB) Internal",
          "publicCode": "BNB-INTERNAL",
          "example": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
          "depositFee": "text",
          "withdrawFee": 1,
          "exponent": 5,
          "re": "xxx",
          "currencyType": "COIN",
          "minSell": 1,
          "maxSell": 1000,
          "minBuy": 1,
          "maxBuy": 1000,
          "expiryDurationMinutes": 30
        }
      ]
    }
  ]
}

Получение настроек ассетов мерчанта

GET/api/v1/integration/assets/settings

Header parameters

Response

Успешное получение настроек ассетов мерчанта

Body

message*string

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

countnumber

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

dataarray of AssetSettingsSerializer (object)

Request

const response = await fetch('/api/v1/integration/assets/settings', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": [
    {
      "code": "BTC",
      "invoiceHedge": true,
      "invoiceHedgeToAsset": "USDT",
      "autoWithdraw": true,
      "autoWithdrawToAddress": "1N4Qbzg6LSXUXyXu2MDuGfzxwMA7do8AyL",
      "autoWithdrawCurrencyCode": "USDT",
      "createdByUid": "xx"
    }
  ]
}

Получение валют мерчанта

GET/api/v1/integration/assets/currencies

Header parameters

Response

Успешное получение валют мерчанта

Body

message*string

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

countnumber

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

dataarray of CurrencySerializer (object)

Request

const response = await fetch('/api/v1/integration/assets/currencies', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": [
    {
      "assetCode": "BNB",
      "fiatCode": "RUB",
      "isInternal": false,
      "publicName": "BinanceCoin(BNB) Internal",
      "publicCode": "BNB-INTERNAL",
      "example": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
      "depositFee": "text",
      "withdrawFee": 1,
      "exponent": 5,
      "re": "xxx",
      "currencyType": "COIN",
      "minSell": 1,
      "maxSell": 1000,
      "minBuy": 1,
      "maxBuy": 1000,
      "expiryDurationMinutes": 30
    }
  ]
}

Получение списка доступных ассетов

GET/api/v1/integration/assets

Header parameters

Response

Успешное получение списка доступных ассетов

Body

message*string

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

countnumber

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

dataarray of AssetSerializer (object)

Request

const response = await fetch('/api/v1/integration/assets', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": [
    {
      "code": "BNB",
      "type": "COIN",
      "usdPrice": "2000",
      "currencies": [
        {
          "assetCode": "BNB",
          "fiatCode": "RUB",
          "isInternal": false,
          "publicName": "BinanceCoin(BNB) Internal",
          "publicCode": "BNB-INTERNAL",
          "example": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
          "depositFee": "text",
          "withdrawFee": 1,
          "exponent": 5,
          "re": "xxx",
          "currencyType": "COIN",
          "minSell": 1,
          "maxSell": 1000,
          "minBuy": 1,
          "maxBuy": 1000,
          "expiryDurationMinutes": 30
        }
      ]
    }
  ]
}

Получение комиссий для вывода ассетов

GET/api/v1/integration/assets/withdraw-fee

Header parameters

Response

Успешное получение комиссий для вывода

Body

message*string

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

countnumber

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

dataarray of AssetWithdrawFee (object)

Request

const response = await fetch('/api/v1/integration/assets/withdraw-fee', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": [
    {
      "toAssetCode": "BNB",
      "toCurrencyCode": "BNBINTERNAL",
      "toCurrencyName": "BinanceCoin(BNB) Internal",
      "fixFee": 0,
      "rate": 123.70237506185059,
      "isTurnRate": false,
      "minOut": 0.000001,
      "maxOut": 1
    }
  ]
}

Получение информации о мерчанте

GET/api/v1/integration/merchant

Header parameters

Response

Успешное получение информации по мерчанту

Body

message*string

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

countnumber

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

dataMerchantSerializer (object)

Request

const response = await fetch('/api/v1/integration/merchant', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2024-05-20T06:58:55.873Z",
    "updatedAt": "2024-05-20T06:58:55.873Z",
    "deletedAt": "2024-05-20T06:58:55.873Z",
    "name": "MyMerchant.",
    "enabledAssets": [
      "BTC",
      "USDT",
      "BNB"
    ],
    "status": "active",
    "pricing": {
      "name": "testPricing",
      "percentIn": 1,
      "percentOut": 1,
      "percentExchange": 1
    },
    "merchantInfo": {
      "projectName": "My project name",
      "projectLink": "https://projectSite/",
      "projectDescription": "Платформа продажи кросовок",
      "country": "france",
      "turnover": "$1000000-$10000000",
      "activity": "Маркетплейс",
      "email": "serviceName@mail.com",
      "phone": "+7(999)123-23-34",
      "otherCommunications": "telegram: @serviceName_for_you",
      "comment": "Это комментарий",
      "updatedByUid": "xx"
    },
    "merchantSettings": {
      "callbackUrl": "https://api.myip.com",
      "isBayerPaysService": false,
      "secretKey": "some-secret-value",
      "updatedByUid": "xx"
    },
    "createdByUid": "xx",
    "updatedByUid": "xx"
  }
}

Получение тарифа мерчанта

GET/api/v1/integration/merchant/pricing

Header parameters

Response

Успешное получение тарифа мерчанта

Body

message*string

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

countnumber

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

dataPricingSerializer (object)

Request

const response = await fetch('/api/v1/integration/merchant/pricing', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "name": "testPricing",
    "percentIn": 1,
    "percentOut": 1,
    "percentExchange": 1
  }
}

Получение валют мерчанта

GET/api/v1/integration/merchant/balances

Header parameters

Response

Успешное получение балансов мерчанта

Body

message*string

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

countnumber

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

dataarray of BalanceDto (object)

Request

const response = await fetch('/api/v1/integration/merchant/balances', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": [
    {
      "code": "BNB",
      "rate": "99.99",
      "balance": "100",
      "pendingWds": "100"
    }
  ]
}

Получить крипто адреса мерчанта

GET/api/v1/integration/merchant/deposit-wallets

Header parameters

Response

Успешное получение крипто адресов мерчанта

Body

message*string

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

countnumber

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

dataDepositWalletDto (object)

Request

const response = await fetch('/api/v1/integration/merchant/deposit-wallets', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "assetCode": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB"
  }
}

Получить список биллингов мерчанта

GET/api/v1/integration/merchant/billings

Query parameters

Header parameters

Response

Успешное получение списка биллингов мерчанта

Body

message*string

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

countnumber

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

dataarray of BillingsSerializer (object)

Request

const response = await fetch('/api/v1/integration/merchant/billings', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": [
    {
      "id": 1,
      "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
      "createdAt": "2024-05-20T06:58:55.873Z",
      "updatedAt": "2024-05-20T06:58:55.873Z",
      "deletedAt": "2024-05-20T06:58:55.873Z",
      "tag": "test@example.com",
      "publicName": "Аккаунт BlackGod8675",
      "totalDeposits": [
        {
          "assetCode": "BTC",
          "amount": "2.334"
        }
      ],
      "wallets": [
        {
          "currencyCode": "BTC",
          "address": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB"
        }
      ]
    }
  ]
}

Получить/создать биллинг

POST/api/v1/integration/merchant/billings/{billingTag}

Path parameters

billingTag*string

Header parameters

Body

publicNamestring

Публичное имя счета (показывается покупателю)

Response

Успешное получение списка биллингов мерчанта

Body

message*string

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

countnumber

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

dataBillingsSerializer (object)

Request

const response = await fetch('/api/v1/integration/merchant/billings/{billingTag}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "message": "ok",
  "count": 1,
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2024-05-20T06:58:55.873Z",
    "updatedAt": "2024-05-20T06:58:55.873Z",
    "deletedAt": "2024-05-20T06:58:55.873Z",
    "tag": "test@example.com",
    "publicName": "Аккаунт BlackGod8675",
    "totalDeposits": [
      {
        "assetCode": "BTC",
        "amount": "2.334"
      }
    ],
    "wallets": [
      {
        "currencyCode": "BTC",
        "address": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB"
      }
    ]
  }
}

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

Last updated 1 month ago