Приём фиата

Получить список фиатных способов пополнения

get
Path parameters
currencystringRequired
Header parameters
x-api-keystringRequired
Responses
200
Эндпоинт позволяет получить список доступных способов для приема фиатных средств для мерчанта. Эти данные необходимы для формирования запроса API метода fiat-deposit
application/json
Responseall of
and
get
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",
      "providersOut": [
        {
          "name": "Сбербанк",
          "code": "111000011",
          "aliasCode": "sber"
        }
      ],
      "amountMin": "10.00",
      "amountMax": "1000.00",
      "feePercent": "1.5"
    }
  ],
  "count": 1
}

Создание фиатного инвойса

post

Эндпоинт позволяет создать заявку на оплату фиатного инвойса. Основные параметры инвойса: invoiceAssetCode - валюта invoiceAmount - сумма providerInAliasCode - код банка приема платежа code - код способа оплаты Для получения данных по доступным способам, банкам, лимитам, кодам оплаты и тд. обратитесь к API методу fiat-deposit-config.

Header parameters
x-api-keystringRequired
Body
invoiceAssetCodestringRequired

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

Example: USDT
commentstring · min: 5Optional

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

Example: Заказ №234
publicCommentstring · min: 5Optional

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

Example: Заказ №234
callbackUrlstring · min: 5Optional

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

Example: https://api.myip.com
redirectUrlstring · min: 5Optional

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

Example: https://marketplace.com/cart
isBayerPaysServicebooleanOptional

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

Example: true
isAwaitRequisitesbooleanOptional

Ожидать реквизиты для оплаты в респонсе (по дефолту false)

Example: true
expiryDurationMinutesnumberOptional

Время жизни инвойса, в минутах (по дефолту 20)

Example: 20
invoiceTplall of | nullableOptional

Шаблон макета формы оплаты

codestringOptional

Способ вывода

Example: CURRENCY_CARD_65
providerInAliasCodestringOptional

Банк приема платежа

Example: BANK
invoiceAmountstringRequired

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

Example: 5000
Responses
200
Успешное создание фиатного инвойса
application/json
Responseall of
and
post
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-30T23:43:20.666Z",
    "updatedAt": "2025-06-30T23:43:20.666Z",
    "deletedAt": "2025-06-30T23:43:20.666Z",
    "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-30T23:43:20.666Z",
    "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
}
PreviousВывод фиатаNextAPI Reference

Last updated