Bitsby documentation
Bitsby документация
Bitsby documentation
Bitsby документация
  • Общая информация
  • Баланс и тарифы
  • FAQ
  • Создание счетов
    • В личном кабинете
    • В telegram-боте
    • HTML формы и ссылки
    • Через API
  • Настройки
    • Кошельки
    • Оплата банковскими картами
  • Документация API
    • Общая информация
    • Список счетов
    • Создание счета
    • Отмена счета
    • Привязка платежа к счету
    • Список платежей
    • Статистика по счетам
    • Статистика по платежам
    • Балансы пользователя
    • История изменения балансов
    • Тарифы по проектам
  • Webhook URL
  • Плагины для интернет-магазинов и CMS
  • Documentation in English
Powered by GitBook
On this page
  • Запрос
  • Параметры запроса
  • Пример ответа
  • Параметры ответа
  1. Документация API

Создание счета

Запрос

curl -X POST https://api.bitsby.app/invoices/create \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "projectId=9deea1e2-0c08-41a3-bdc2-a34eada3892d" \
	-F "amountFiat=10.55" \
	-F "currencyFiat=EUR" \
	-F "description=12 months license for BITSBY" \
	-F "serviceData={\"userId\":100,\"orderId\":500}" \
	-F "timeToPay=6"

Параметры запроса

Параметр
Тип данных
Описание
Пример
Обязательный?

projectId

UUID

ID проекта в формате UUID

1c48b092-9878-48f5-b441-07a8a48e7b54

да

amountFiat

Float

Сумма в фиатной валюте

10.55

да

currencyFiat

String

Валюта фиата. Допустимые значения: USD, EUR, RUB

EUR

да

description

String

Описание товара или услуги. Отображается покупателю на платежной странице

Лицензия на 12 месяцев для BITSBY

нет

serviceData

String

Служебные данные. НЕ отображается покупателю. При оплате счета передается в webhook URL магазина. Эти данные используются для связи счета и платежа с покупателем в интернет магазине продавца. Удобно использовать данные в формате JSON

{"userId":100,"orderId":500}

нет

timeToPay

Float

Время в часах на оплату счета. Допустимые значения: 0.5, 1, 3, 6, 12

1

да

Пример ответа

{
   "result":"success",
   "data":{
      "id":"ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c",
      "uid":"MXNj4m8HhcM4",
      "createDatetime":"2024-02-29 15:20:24",
      "timeToPayDatetime":"2024-03-01 03:20:24",
      "commissionFiatUSD":"0.10",
      "amountFiatUSD":"10.00",
      "url":"https:\/\/dash.bitsby.app\/invoices\/pay\/MXNj4m8HhcM4",
   }
}

Параметры ответа

Параметр
Описание

id

ID счета в формате UUID

uid

ID счета (для покупателя)

createDatetime

Дата и время создания счета (UTC)

timeToPayDatetime

Дата и время, до которого действителен счет (UTC). До этой даты покупатель должен успеть оплатить счет

commissionFiatUSD

Сумма комиссии сервиса. Рассчитывается относительно суммы invoice.amountFiatUSD

amountFiatUSD

Сумма в валюте USD, рассчитанная при создании счета по текущему курсу относительно суммы invoice.amountFiat

url

Ссылка на платежную страницу для покупателя. Эту ссылку надо передать покупателю для оплаты счета

PreviousСписок счетовNextОтмена счета

Last updated 2 months ago