API Reference
https://pay.alfabit.org/
Страница
1
Кол-во элементов на странице
10
Сортировка по полю
-uid
Uid мерчантов
["3422b448-2460-4fd2-9183-8000de6f8343"]
Биллинг тэг
["test@example.com"]
Активы
["USDT"]
Сети
["ETH"]
Дата создания (начало периода) строка должна соответствовать формату ISO8601 и быть в экранированном URL-encoded format. Допустимо 2025-01-14T21:00:00.000%2b03:00 знак "+" -> "%2B" или 2025-01-14T21:00:00.000Z. Правильно 2025-01-14T21%3A00%3A00.000%2B03%3A00
1970-01-01T00:00:00.000Z
Дата создания (конец периода) строка должна соответствовать формату ISO8601 и быть в экранированном URL-encoded format. Допустимо 2025-01-14T21:00:00.000%2b03:00 знак "+" -> "%2B" или 2025-01-14T21:00:00.000Z. Правильно 2025-01-14T21%3A00%3A00.000%2B03%3A00
1970-01-01T00:00:00.000Z
Показать ордера защищаемых (внутренних) мерчантов
false
Поиск заявки по комментарию, id транзакции, UID заявки, имени мерчанта
test@mail.com
GET /api/v1/integration/orders HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
}
],
"count": 1
}
Страница
1
Кол-во элементов на странице
10
Сортировка по полю
-uid
Uid мерчантов
["3422b448-2460-4fd2-9183-8000de6f8343"]
Биллинг тэг
["test@example.com"]
Активы
["USDT"]
Сети
["ETH"]
Дата создания (начало периода) строка должна соответствовать формату ISO8601 и быть в экранированном URL-encoded format. Допустимо 2025-01-14T21:00:00.000%2b03:00 знак "+" -> "%2B" или 2025-01-14T21:00:00.000Z. Правильно 2025-01-14T21%3A00%3A00.000%2B03%3A00
1970-01-01T00:00:00.000Z
Дата создания (конец периода) строка должна соответствовать формату ISO8601 и быть в экранированном URL-encoded format. Допустимо 2025-01-14T21:00:00.000%2b03:00 знак "+" -> "%2B" или 2025-01-14T21:00:00.000Z. Правильно 2025-01-14T21%3A00%3A00.000%2B03%3A00
1970-01-01T00:00:00.000Z
Показать ордера защищаемых (внутренних) мерчантов
false
Тип реквизитов для поиска
Текст для поиска в реквизитах указанного типа
some_text
GET /api/v2/integration/orders HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text"
}
],
"count": 1
}
GET /api/v1/integration/orders/{orderUid} HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
},
"count": 1
}
Создание инвойса с указанием суммы оплаты. Инвойс формируется в валюте invoiceAssetCode. Платеж производится в валюте, указанной в параметре currencyInCode. Если не заполнено - покупателю будет предложен список доступных для оплаты валют.
Валюта, выбранная для оплаты покупателем
BTC
Ассет, в котором выстален счет покупателю
USDT
Комментарий к ордеру. Опциональное поле
Заказ №234
Публичный комментарий к ордеру. Опциональное поле
Заказ №234
Callback url для отправки хуков
https://api.myip.com
Url для перенаправления покупателя после оплаты
https://marketplace.com/cart
Включить комиссию сервиса в счет покупателю (если не указано, то берется из настроек мерчанта)
true
Ожидать реквизиты для оплаты в респонсе (по дефолту false)
true
Время жизни инвойса, в минутах (по дефолту 20)
20
Шаблон макета формы оплаты
Сумма для оплаты в $invoiceAssetCode
5000
POST /api/v1/integration/orders/invoice HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 334
{
"currencyInCode": "BTC",
"invoiceAssetCode": "USDT",
"comment": "Заказ №234",
"publicComment": "Заказ №234",
"callbackUrl": "https://api.myip.com",
"redirectUrl": "https://marketplace.com/cart",
"isBayerPaysService": true,
"isAwaitRequisites": true,
"expiryDurationMinutes": 20,
"invoiceTpl": {
"locales": [
"en",
"ru"
]
},
"invoiceAmount": 5000
}
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
},
"count": 1
}
Вывод средств на внешний адрес.
Сумма выхода
10
Валюта получения (с сетью)
USDTMATIC
Реципиент (адрес)
0x0000000000000000000000000000000000000000
Мемо тег (для XRP, TON и т.д.)
80576
Callback url для отправки хуков
https://api.myip.com
Комментарий к переводу. Опциональное поле
Оплата сервера за 07.2023
POST /api/v1/integration/orders/withdraw HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 217
{
"amount": 10,
"toCurrencyCode": "USDTMATIC",
"recipient": "0x0000000000000000000000000000000000000000",
"requisitesMemoTag": "80576",
"callbackUrl": "https://api.myip.com",
"comment": "Оплата сервера за 07.2023"
}
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
},
"count": 1
}
Эндпоинт позволяет создать заявку на вывод фиатных средств для мерчанта. Основные параметры вывода: currency - валюта amount - сумма paymentMethod - метод вывода, providerOutAliasCode - код банка вывода code - код способа вывода Для получения данных по доступным способам, банкам, лимитам, кодам вывода и тд. обратитесь к API методу fiat-withdraw-config.
Валюта
CODE
Possible values: Платежный метод
card
Possible values: Код банка вывода
BANK
Способ вывода
CURRENCY_CARD_65
Сумма выхода
10
Комментарий к переводу. Опциональное поле
Оплата сервера за 07.2023
Реквизиты реципиента
CARD NUMBER
Callback url для отправки хуков
https://api.myip.com
Доп поля для вывода
{"email":"payer@gmail.com"}
POST /api/v1/integration/orders/fiat-withdraw HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 270
{
"currency": "CODE",
"paymentMethod": "card",
"providerOutAliasCode": "BANK",
"code": "CURRENCY_CARD_65",
"amount": 10,
"comment": "Оплата сервера за 07.2023",
"recipient": "CARD NUMBER",
"callbackUrl": "https://api.myip.com",
"details": "{\"email\":\"payer@gmail.com\"}"
}
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
},
"count": 1
}
Эндпоинт позволяет создать заявку на оплату фиатного инвойса. Основные параметры инвойса: invoiceAssetCode - валюта invoiceAmount - сумма providerInAliasCode - код банка приема платежа code - код способа оплаты Для получения данных по доступным способам, банкам, лимитам, кодам оплаты и тд. обратитесь к API методу fiat-deposit-config.
Ассет, в котором выстален счет покупателю
USDT
Комментарий к ордеру. Опциональное поле
Заказ №234
Публичный комментарий к ордеру. Опциональное поле
Заказ №234
Callback url для отправки хуков
https://api.myip.com
Url для перенаправления покупателя после оплаты
https://marketplace.com/cart
Включить комиссию сервиса в счет покупателю (если не указано, то берется из настроек мерчанта)
true
Ожидать реквизиты для оплаты в респонсе (по дефолту false)
true
Время жизни инвойса, в минутах (по дефолту 20)
20
Шаблон макета формы оплаты
Способ вывода
CURRENCY_CARD_65
Банк приема платежа
BANK
Сумма для оплаты в $invoiceAssetCode
5000
POST /api/v1/integration/orders/fiat-invoice HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 366
{
"invoiceAssetCode": "USDT",
"comment": "Заказ №234",
"publicComment": "Заказ №234",
"callbackUrl": "https://api.myip.com",
"redirectUrl": "https://marketplace.com/cart",
"isBayerPaysService": true,
"isAwaitRequisites": true,
"expiryDurationMinutes": 20,
"invoiceTpl": {
"locales": [
"en",
"ru"
]
},
"code": "CURRENCY_CARD_65",
"providerInAliasCode": "BANK",
"invoiceAmount": 5000
}
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
},
"count": 1
}
Конвертация на сумму amountIn в валюте assetCodeIn в валюту assetCodeOut.
Ассет на входе в обмен
USDT
Обмениваемая сумма
10
Ассет на выходе
USDT
Ожидаемая сумма
10
Комментарий к обмену. Опциональное поле
Хеджирование за 07.2023
Приоритет обмена (по дефолту "in")
in
POST /api/v1/integration/orders/exchange HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 147
{
"assetCodeIn": "USDT",
"amountIn": 10,
"assetCodeOut": "USDT",
"amountOut": 10,
"comment": "Хеджирование за 07.2023",
"exchangePriority": "in"
}
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
},
"count": 1
}
Перевод средств на другой аккаунт внутри системы.
Сумма для перевода
10
Отправляемый ассет
USDT
Реципиент (ID мерчанта)
7647
Комментарий к переводу. Опциональное поле
С Днем Рождения!
POST /api/v1/integration/orders/account-transfer HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 93
{
"amount": 10,
"assetCode": "USDT",
"recipientId": 7647,
"comment": "С Днем Рождения!"
}
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
},
"count": 1
}
Метод предназначен для оценки суммы, которую необходимо заплатить в валюте fromCurrencyCode для получения суммы amountTo в валюте toCurrencyCode (с учетом курса обмена и комиссии).
Валюта на входе
BTC
Валюта на выходе
USDTBEP20
Сумма на выходе
15
POST /api/v1/integration/orders/estimate-in HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 69
{
"fromCurrencyCode": "BTC",
"toCurrencyCode": "USDTBEP20",
"amountTo": 15
}
{
"message": "ok",
"data": {
"currencyCode": "USDTERC20",
"assetCode": "USDT",
"amount": "2.334"
},
"count": 1
}
Метод предназначен для оценки суммы, которая будет получена в валюте toCurrencyCode при оплате суммы amountFrom в валюте fromCurrencyCode (с учетом курса обмена и комиссии).
Выходная валюта
USDT-INTERNAL
Отдаваемая валюта
BTC-INTERNAL
Отдаваемая сумма
15
POST /api/v1/integration/orders/estimate-out HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 84
{
"toCurrencyCode": "USDT-INTERNAL",
"fromCurrencyCode": "BTC-INTERNAL",
"amountFrom": 15
}
{
"message": "ok",
"data": {
"currencyCode": "USDTERC20",
"assetCode": "USDT",
"amount": "2.334"
},
"count": 1
}
Создание инвойса без указания суммы оплаты. Инвойс формируется в валюте invoiceAssetCode. Платеж производится в валюте, указанной в параметре currencyInCode. Если не заполнено - покупателю будет предложен список доступных для оплаты валют.
Валюта, выбранная для оплаты покупателем
BTC
Ассет, в котором выстален счет покупателю
USDT
Комментарий к ордеру. Опциональное поле
Заказ №234
Публичный комментарий к ордеру. Опциональное поле
Заказ №234
Callback url для отправки хуков
https://api.myip.com
Url для перенаправления покупателя после оплаты
https://marketplace.com/cart
Включить комиссию сервиса в счет покупателю (если не указано, то берется из настроек мерчанта)
true
Ожидать реквизиты для оплаты в респонсе (по дефолту false)
true
Время жизни инвойса, в минутах (по дефолту 20)
20
Шаблон макета формы оплаты
POST /api/v1/integration/orders/invoice/without-amount HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 313
{
"currencyInCode": "BTC",
"invoiceAssetCode": "USDT",
"comment": "Заказ №234",
"publicComment": "Заказ №234",
"callbackUrl": "https://api.myip.com",
"redirectUrl": "https://marketplace.com/cart",
"isBayerPaysService": true,
"isAwaitRequisites": true,
"expiryDurationMinutes": 20,
"invoiceTpl": {
"locales": [
"en",
"ru"
]
}
}
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
},
"count": 1
}
Заявка на конвертацию и перевод средств между различными сетями. Процесс включает три этапа: Получение -> Обмен -> Вывод. Например, при переводе USDTERC20 в BNBBEP20: 1. Предоставляется адрес для внесения USDTERC20 (fromCurrencyCode) в сети Ethereum 2. Полученные средства конвертируются в BNB 3. BNB выводятся как BNBBEP20 (toCurrencyCode) на указанный адрес (recipient) в сети Binance Smart Chain
Важно: Сумма перевода (amount) указывается в toCurrencyCode.
Совет: Для оценки суммы fromCurrencyCode можно воспользоваться методом "orders/estimate-in".
Сумма выхода
10
Валюта получения (с сетью)
USDTMATIC
Реципиент (адрес)
0x0000000000000000000000000000000000000000
Мемо тег (для XRP, TON и т.д.)
80576
Callback url для отправки хуков
https://api.myip.com
Комментарий к переводу. Опциональное поле
Оплата сервера за 07.2023
Детали для фиатных выводов
{"method":"card"}
Входная валюта
BTC
POST /api/v1/integration/orders/currency-to-currency HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 276
{
"amount": 10,
"toCurrencyCode": "USDTMATIC",
"recipient": "0x0000000000000000000000000000000000000000",
"requisitesMemoTag": "80576",
"callbackUrl": "https://api.myip.com",
"comment": "Оплата сервера за 07.2023",
"details": "{\"method\":\"card\"}",
"fromCurrencyCode": "BTC"
}
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
},
"count": 1
}
Заявка на вывод с конвертацией. Процесс включает два этапа: Обмен -> Вывод. Например, при выводе USDT в BTC: 1. USDT (fromAssetCode) с баланса мерчанта конвертируются в BTC 2. BTC (toCurrencyCode) выводятся на указанный адрес (recipient) в сети Bitcoin.
Важно:Сумма вывода (amount) указывается в toCurrencyCode.
Совет: Для оценки суммы currencyInCode можно воспользоваться методом "orders/estimate-in".
Сумма выхода
10
Валюта получения (с сетью)
USDTMATIC
Реципиент (адрес)
0x0000000000000000000000000000000000000000
Мемо тег (для XRP, TON и т.д.)
80576
Callback url для отправки хуков
https://api.myip.com
Комментарий к переводу. Опциональное поле
Оплата сервера за 07.2023
Ассет из которого конвертируется
BTC
POST /api/v1/integration/orders/withdraw-with-exchange HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 239
{
"amount": 10,
"toCurrencyCode": "USDTMATIC",
"recipient": "0x0000000000000000000000000000000000000000",
"requisitesMemoTag": "80576",
"callbackUrl": "https://api.myip.com",
"comment": "Оплата сервера за 07.2023",
"fromAssetCode": "BTC"
}
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
},
"count": 1
}
GET /api/v1/integration/orders/filters/assets HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
"text"
],
"count": 1
}
GET /api/v1/integration/orders/filters/networks HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
"text"
],
"count": 1
}
Код получаемого токена
QWRUB
Код отдаваемого токена
ETH
GET /api/v1/integration/assets/exchange-rate HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"pairCode": "BTC/BNB",
"fromAssetCode": "BTC",
"toAssetCode": "BNB",
"fromCurrencyType": "COIN",
"toCurrencyType": "COIN",
"minIn": "1",
"minOut": "0.000001",
"rate": "45.096",
"isTurnRate": false
}
],
"count": 1
}
GET /api/v1/integration/assets/enabled HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"code": "BNB",
"type": "COIN",
"usdPrice": "2000",
"eurPrice": "2000",
"rubPrice": "2000",
"exponent": 5,
"name": "Bitcoin",
"minDeposit": 1,
"maxDeposit": 1000,
"minWithdraw": 1,
"maxWithdraw": 1000,
"currencies": [
{
"assetCode": "BNB",
"fiatCode": "USD",
"isInternal": false,
"publicName": "BinanceCoin(BNB) Internal",
"publicCode": "BNB-INTERNAL",
"example": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"isUseMemoTag": false,
"storageProviderCode": "BSC",
"publicStorageProviderName": "Binance SC",
"depositFee": 0,
"withdrawFee": 1,
"exponent": 5,
"re": "xxx",
"currencyType": "COIN",
"minDeposit": 1,
"maxDeposit": 1000,
"minWithdraw": 1,
"maxWithdraw": 1000,
"expiryDurationMinutes": 30
}
]
}
],
"count": 1
}
GET /api/v1/integration/assets/settings HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"code": "BTC",
"invoiceHedge": true,
"invoiceHedgeToAsset": "USDT",
"autoWithdraw": true,
"autoWithdrawToAddress": "1N4Qbzg6LSXUXyXu2MDuGfzxwMA7do8AyL",
"autoWithdrawCurrencyCode": "USDT",
"createdByUid": "xx"
}
],
"count": 1
}
GET /api/v1/integration/assets/currencies HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"assetCode": "BNB",
"fiatCode": "USD",
"isInternal": false,
"publicName": "BinanceCoin(BNB) Internal",
"publicCode": "BNB-INTERNAL",
"example": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"isUseMemoTag": false,
"storageProviderCode": "BSC",
"publicStorageProviderName": "Binance SC",
"depositFee": 0,
"withdrawFee": 1,
"exponent": 5,
"re": "xxx",
"currencyType": "COIN",
"minDeposit": 1,
"maxDeposit": 1000,
"minWithdraw": 1,
"maxWithdraw": 1000,
"expiryDurationMinutes": 30
}
],
"count": 1
}
GET /api/v1/integration/assets HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"code": "BNB",
"type": "COIN",
"usdPrice": "2000",
"eurPrice": "2000",
"rubPrice": "2000",
"exponent": 5,
"name": "Bitcoin",
"minDeposit": 1,
"maxDeposit": 1000,
"minWithdraw": 1,
"maxWithdraw": 1000,
"currencies": [
{
"assetCode": "BNB",
"fiatCode": "USD",
"isInternal": false,
"publicName": "BinanceCoin(BNB) Internal",
"publicCode": "BNB-INTERNAL",
"example": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"isUseMemoTag": false,
"storageProviderCode": "BSC",
"publicStorageProviderName": "Binance SC",
"depositFee": 0,
"withdrawFee": 1,
"exponent": 5,
"re": "xxx",
"currencyType": "COIN",
"minDeposit": 1,
"maxDeposit": 1000,
"minWithdraw": 1,
"maxWithdraw": 1000,
"expiryDurationMinutes": 30
}
]
}
],
"count": 1
}
GET /api/v1/integration/assets/withdraw-fee HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"toAssetCode": "BNB",
"toCurrencyCode": "BNBINTERNAL",
"toCurrencyName": "BinanceCoin(BNB) Internal",
"fixFee": 0,
"rate": 123.70237506185059,
"isTurnRate": false,
"minOut": 0.000001,
"maxOut": 1
}
],
"count": 1
}
GET /api/v1/integration/merchant HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"name": "MyMerchant.",
"enabledAssets": [
"BTC",
"USDT",
"BNB"
],
"status": "active",
"balanceUsd": "43.11",
"equal": "187",
"pricing": {
"name": "testPricing",
"percentIn": 1,
"percentOut": 1,
"percentExchange": 1
},
"merchantInfo": {
"projectName": "My project name",
"projectLink": "https://project-site.com",
"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": true,
"secretKey": "some-secret-value",
"updatedByUid": "xx"
},
"createdByUid": "xx",
"updatedByUid": "xx"
},
"count": 1
}
GET /api/v1/integration/merchant/pricing HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": {
"name": "testPricing",
"percentIn": 1,
"percentOut": 1,
"percentExchange": 1
},
"count": 1
}
GET /api/v1/integration/merchant/balances HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"code": "BNB",
"rate": "99.99",
"equal": "100",
"balance": "100",
"pendingWds": "100",
"pendingIn": "100"
}
],
"count": 1
}
GET /api/v1/integration/merchant/deposit-wallets HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": {
"assetCode": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB"
},
"count": 1
}
Страница
1
Кол-во элементов на странице
10
Сортировка по полю
-uid
Поиск
test@mail.com
GET /api/v1/integration/merchant/billings HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"tag": "test@example.com",
"publicName": "Аккаунт BlackGod8675",
"totalDeposits": [
{
"currencyInCode": "USDTERC20",
"amount": "2.334"
}
],
"wallets": [
{
"currencyCode": "USDTERC20",
"address": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"assetCode": "USDT"
}
]
}
],
"count": 1
}
Публичное имя счета (показывается покупателю)
Аккаунт BlackKnight165
POST /api/v1/integration/merchant/billings/{billingTag} HTTP/1.1
Host:
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 46
{
"publicName": "Аккаунт BlackKnight165"
}
{
"message": "ok",
"data": {
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"tag": "test@example.com",
"publicName": "Аккаунт BlackGod8675",
"totalDeposits": [
{
"currencyInCode": "USDTERC20",
"amount": "2.334"
}
],
"wallets": [
{
"currencyCode": "USDTERC20",
"address": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"assetCode": "USDT"
}
]
},
"count": 1
}
GET /api/v1/integration/merchant/fiat-withdraw-config/{currency} HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"name": "Все карты",
"code": "RUB_CARD_32",
"paymentMethod": "card",
"currency": "RUB",
"currencyOutCode": "USD",
"paymentType": "deposit",
"providersOut": [
{
"name": "Сбербанк",
"code": "111000011",
"aliasCode": "sber"
}
],
"amountMin": "10.00",
"amountMax": "1000.00",
"feePercent": "1.5"
}
],
"count": 1
}
GET /api/v1/integration/merchant/fiat-deposit-config/{currency} HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"name": "Все карты",
"code": "RUB_CARD_32",
"paymentMethod": "card",
"currency": "RUB",
"currencyOutCode": "USD",
"paymentType": "deposit",
"providersOut": [
{
"name": "Сбербанк",
"code": "111000011",
"aliasCode": "sber"
}
],
"amountMin": "10.00",
"amountMax": "1000.00",
"feePercent": "1.5"
}
],
"count": 1
}
Страница
1
Кол-во элементов на странице
10
Сортировка по полю
-uid
Uid мерчантов
["3422b448-2460-4fd2-9183-8000de6f8343"]
Биллинг тэг
["test@example.com"]
Активы
["USDT"]
Сети
["ETH"]
Дата создания (начало периода) строка должна соответствовать формату ISO8601 и быть в экранированном URL-encoded format. Допустимо 2025-01-14T21:00:00.000%2b03:00 знак "+" -> "%2B" или 2025-01-14T21:00:00.000Z. Правильно 2025-01-14T21%3A00%3A00.000%2B03%3A00
1970-01-01T00:00:00.000Z
Дата создания (конец периода) строка должна соответствовать формату ISO8601 и быть в экранированном URL-encoded format. Допустимо 2025-01-14T21:00:00.000%2b03:00 знак "+" -> "%2B" или 2025-01-14T21:00:00.000Z. Правильно 2025-01-14T21%3A00%3A00.000%2B03%3A00
1970-01-01T00:00:00.000Z
Показать ордера защищаемых (внутренних) мерчантов
false
Поиск заявки по комментарию, id транзакции, UID заявки, имени мерчанта
test@mail.com
GET /api/v1/integration/orders HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text",
"paymentTiming": "onTime",
"amountValidity": "valid"
}
],
"count": 1
}
Страница
1
Кол-во элементов на странице
10
Сортировка по полю
-uid
Uid мерчантов
["3422b448-2460-4fd2-9183-8000de6f8343"]
Биллинг тэг
["test@example.com"]
Активы
["USDT"]
Сети
["ETH"]
Дата создания (начало периода) строка должна соответствовать формату ISO8601 и быть в экранированном URL-encoded format. Допустимо 2025-01-14T21:00:00.000%2b03:00 знак "+" -> "%2B" или 2025-01-14T21:00:00.000Z. Правильно 2025-01-14T21%3A00%3A00.000%2B03%3A00
1970-01-01T00:00:00.000Z
Дата создания (конец периода) строка должна соответствовать формату ISO8601 и быть в экранированном URL-encoded format. Допустимо 2025-01-14T21:00:00.000%2b03:00 знак "+" -> "%2B" или 2025-01-14T21:00:00.000Z. Правильно 2025-01-14T21%3A00%3A00.000%2B03%3A00
1970-01-01T00:00:00.000Z
Показать ордера защищаемых (внутренних) мерчантов
false
Тип реквизитов для поиска
Текст для поиска в реквизитах указанного типа
some_text
GET /api/v2/integration/orders HTTP/1.1
Host:
x-api-key: text
Accept: */*
{
"message": "ok",
"data": [
{
"id": 1,
"uid": "3422b448-2460-4fd2-9183-8000de6f8343",
"createdAt": "2025-06-30T16:25:29.195Z",
"updatedAt": "2025-06-30T16:25:29.195Z",
"deletedAt": "2025-06-30T16:25:29.195Z",
"serviceCommission": "0.565",
"netCommission": "0.565",
"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",
"isDone": false,
"apiMode": "ui",
"risk": "24",
"requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
"requisitesMemoTag": "80576",
"requisitesMemoTagIn": "80576",
"requisitesMemoTagOut": "80576",
"billingTag": "example@mail.com",
"requisitesQrCode": "https://example.com/img-name.png",
"assetInCode": "BTC",
"assetOutCode": "USDT",
"networkInCode": "ETH",
"networkOutCode": "NEAR",
"balanceAfter": "44",
"callbackUrl": "https://example/myCallback",
"invoicePublicUrl": "https://example/myInvoice",
"txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
"expirationTime": "2025-06-30T16:25:29.195Z",
"isImPayed": false,
"isBayerPaysService": false,
"serviceFeeCurrencyCode": "USDT",
"netFeeCurrencyCode": "USDT",
"requisitesInUrl": "https://example.com/requisites",
"orderCurrencyType": "crypto",
"paymentMethod": "sbp",
"providerCode": "123123123123",
"providerAliasCode": "text",
"providerName": "text"
}
],
"count": 1
}
Last updated