Привязка платежа к счету

Описание

В абсолютном большинстве случаев покупатели платят ровно указанную в счете сумму на ваш крипто кошелек. Но также бывают случаи, когда покупатель может ошибиться и оплатить не ровно зарезервированную сумму. В этом случае сервис не сможет автоматически связать платеж и счет, а также отметить счет как оплаченный. Если это произойдет, вы, как продавец, можете вручную связать платеж со счетом, если точно уверены, какой платеж ожидаете. Эту операцию можно сделать через личный кабинет на сайте, или через API.

Условия привязки

Привязка выполнится, только если одновременно соблюдены все условия:

1. Статус счета — unpaid или expired. Отмененные и уже оплаченные счета привязать нельзя. Отмена счета необратима.
2. Платеж еще не привязан к другому счету. Один платеж может быть связан только с одним счетом.
3. Платеж поступил на кошелек, задействованный в этом счете.
4. Платеж укладывается в окно доступных платежей — сутки до и сутки после создания счета. Платеж, поступивший раньше создания счета, привязать можно; за пределами окна — нельзя.

Если счет принадлежит чужому проекту, а ключ ограничен проектом, метод отвечает Restricted project. Если не выполнено любое другое условие, приходит общая ошибка без указания причины — проверяйте условия на своей стороне.

Что происходит после привязки

• Счет переходит в статус Оплачен.
• Отправляются уведомления на email, в Telegram-бот и на Webhook URL — так же, как при автоматической привязке.
• Сумма счета invoice.amountFiatUSD перезаписывается фактически поступившей суммой, приведенной к USD по курсу на момент привязки. Оригинальная сумма в invoice.amountFiat не меняется.
• Комиссия сервиса пересчитывается по ставке тарифа проекта от суммы, которую вы получили. При переплате она выше рассчитанной при создании счета, при недоплате — ниже.

Запрос

curl -X POST https://api.bitsby.app/invoices/bindPayment \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "invoiceId=ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c" \
	-F "paymentId=a4c9e2ee-9a03-43e5-a1a1-00caf679d16a"

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

Параметр	Тип данных	Описание	Пример	Обязательный?
invoiceId	UUID	ID счета в формате UUID	ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c	да
paymentId	UUID	ID платежа в формате UUID	a4c9e2ee-9a03-43e5-a1a1-00caf679d16a	да

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

{
   "result":"success",
   "data":"Invoice binded to payment"
}