Платёжная форма

Платежная форма AlfaBit Pay предоставляет пользователю всю необходимую информацию для осуществления платежа, включая реквизиты, QR-код, лимиты депозита и курсы обмена.

Типы форм оплаты:

1. Форма с фиксированной суммой:

   • Создается автоматически на стороне Alfabit Pay.

   • Содержит адрес одноразового кошелька, QR-код и сумму для оплаты.

2. Форма без фиксированной суммы:

   • Создается автоматически на стороне Alfabit Pay.

   • Содержит выбор валют для оплаты.

   • Адрес одноразового кошелька, QR-код и поле для ввода суммы.

Мерчант может создать платежную форму из интерфейса сервиса, нажав кнопку “Получить платеж”

Или используя метод:

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

post

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

Header parameters

x-api-keystringOptional

Body

application/json

currencyInCodestringOptional

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

Example: BTC

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

invoiceAssetCodestringRequired

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

Example: RUB

invoiceAmountstringRequired

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

Example: 5000

Responses

200

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

application/json

messagestringRequired

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

Example: ok

countnumberOptional

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

Example: 1

400

Некорректный запрос

application/json

401

Необходимо авторизоваться для запроса

application/json

403

Недостаточно прав

application/json

500

Системная ошибка

application/json

post

/client/v1/api/orders/invoice

HTTPcURLJavaScriptPython

POST /client/v1/api/orders/invoice HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 218

{
  "currencyInCode": "BTC",
  "comment": "Заказ №234",
  "publicComment": "Заказ №234",
  "callbackUrl": "https://api.myip.com",
  "redirectUrl": "https://marketplace.com/cart",
  "invoiceAssetCode": "RUB",
  "invoiceAmount": 5000
}

{
  "message": "ok",
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2026-03-21T11:56:32.914Z",
    "updatedAt": "2026-03-21T11:56:32.914Z",
    "deletedAt": "2026-03-21T11:56:32.914Z",
    "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": "[e-mail]",
    "balanceAfter": "44",
    "callbackUrl": "https://example/myCallback",
    "invoicePublicUrl": "https://example/myInvoice",
    "txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "expirationTime": "2026-03-21T11:56:32.914Z",
    "isImPayed": false
  },
  "count": 1
}

Bладелец мерчанта может создать платежную форму по своему усмотрению, используя параметры, включенные в соответствующий API метод.