Speend API Documentation
На данном портале представлена вся необходимая информация по работе с API Speend.
Если у вас где-то возникли сложности свяжитесь со своим персональным менеджером или напишите в чат поддержки.
Прежде чем читать остальную документацию стоит понимать разницу между Static wallet и Invoice
Два способа принять платёж ведут себя принципиально по-разному при недоплате и частичной оплате.
Статический кошелёк — постоянный крипто-адрес, закреплённый за клиентом/пользователем один раз. Клиент может отправлять на него платежи многократно, в любое время, без создания отдельного счёта под каждый платёж.
Инвойс — разовый счёт на конкретную сумму, создаваемый под конкретный заказ.
Когда что использовать
| Сценарий | Тип |
|---|---|
| Пополнение внутреннего баланса пользователя, без привязки к конкретной сумме | Статический кошелёк |
| Периодические/повторяющиеся депозиты от одного и того же клиента | Статический кошелёк |
| Оплата конкретного заказа/счёта на точную сумму (интернет-магазин, разовая услуга) | Инвойс |
| Нужно отслеживать частичную оплату и ждать доплату от клиента | Инвойс |
Особенности
Статический кошелёк
- Недостаточная сумма — транзакция молча игнорируется: нет webhook, нет зачисления
- Несколько платежей на адрес не суммируются — каждый проверяется отдельно
- Подходит для пополнения баланса / многократных депозитов
Инвойс
- Недостаточная сумма — webhook приходит со статусом ожидания доплаты
- Несколько платежей суммируются до полной оплаты счёта
- Переплата по платежу засчитывается мерчанту автоматически