Конвертация и перевод средств между различными сетями (Мост)

Создание заявки на Валюта -> Валюта (мост)

post

Заявка на конвертацию и перевод средств между различными сетями. Процесс включает три этапа: Получение -> Обмен -> Вывод. Например, при переводе USDTERC20 в BNBBEP20: 1. Предоставляется адрес для внесения USDTERC20 (fromCurrencyCode) в сети Ethereum 2. Полученные средства конвертируются в BNB 3. BNB выводятся как BNBBEP20 (toCurrencyCode) на указанный адрес (recipient) в сети Binance Smart Chain

  Важно: Сумма перевода (amount) указывается в toCurrencyCode.
 
  Совет: Для оценки суммы fromCurrencyCode можно воспользоваться методом "orders/estimate-in".
Header parameters
x-api-keystringRequired
Body
amountstringRequired

Сумма выхода

Example: 10
toCurrencyCodestringRequired

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

Example: USDTMATIC
recipientstringRequired

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

Example: 0x0000000000000000000000000000000000000000
requisitesMemoTagstringOptional

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

Example: 80576
callbackUrlstring · min: 5Optional

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

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

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

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

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

Example: {"method":"card"}
fromCurrencyCodestringRequired

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

Example: BTC
Responses
200
Успешное создание СТС заявки
application/json
Responseall of
and
post
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-07-01T17:49:29.238Z",
    "updatedAt": "2025-07-01T17:49:29.238Z",
    "deletedAt": "2025-07-01T17:49:29.238Z",
    "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-07-01T17:49:29.238Z",
    "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
}

Last updated