Платёжные ссылки

Что входит в счёт#

В интерфейсе для нового счёта USD доступны карты и Alipay, для RUB — СБП, для USDT — криптовалюта. API для совместимости может сохранить USD + crypto, но такая криптооплата не запускается и возвращает crypto_requires_usdt. USD и USDT различаются; автоматической конвертации или курса 1:1 нет. Для криптооплаты нужен отдельный счёт в USDT.

Не добавляйте в публичное описание пароли, API-ключи, реквизиты карт или банковские коды. Название и номер заказа должны быть понятны покупателю.

• Название магазина, заголовок заказа до 120 символов и описание до 500 символов.
• Базовая сумма и явная валюта USD, RUB или USDT.
• Совместимые способы оплаты, отдельные доли комиссии и НДС, номер заказа и срок ссылки.
• В ответах владельцу link.payment содержит сохранённый статус уже созданной операции; это отдельное поле от состояния самой ссылки.

Any — способ выбирает покупатель#

Any означает все способы, совместимые с валютой счёта: карты и Alipay для USD, СБП для RUB, криптовалюта для USDT. В API передаётся конкретный массив methods, а не строка any. Каждому способу соответствует собственный расчёт.

В интерфейсе для нового счёта USD доступны карты и Alipay, для RUB — СБП, для USDT — криптовалюта. API для совместимости может сохранить USD + crypto, но такая криптооплата не запускается и возвращает crypto_requires_usdt. USD и USDT различаются; автоматической конвертации или курса 1:1 нет. Для криптооплаты нужен отдельный счёт в USDT.

Для нового реального платежа картой или Alipay текущий шлюз поддерживает только feeCustomerPercent=0 и vatCustomerPercent=100: комиссию полностью покрывает магазин, НДС полностью добавляется покупателю. Остальные доли можно сохранить в счёте и рассчитать, но такой платёж не запускается и получает unsupported_allocation. Сервер не меняет сохранённые условия автоматически. Для СБП и USDT-криптооплаты доступны все доли комиссии; НДС у них отсутствует.

Как подготовить ссылку#

1. 1

   Откройте вкладку «Ссылки» в кабинете.

2. 2

   Заполните название, сумму, валюту и описание. Двумя ползунками задайте доли комиссии и НДС.

3. 3

   Оставьте Any для выбора покупателем или выберите конкретные способы. Укажите срок действия.

4. 4

   Сравните итог по каждому способу и проверьте страницу покупателя.

5. 5

   Сразу после создания получите готовую ссылку, скопируйте её и передайте покупателю или вставьте в виджет.

Условия сохраняются#

Уже созданный счёт не меняется вслед за настройками магазина. Цена, валюта, доли комиссии и НДС, номер заказа и метаданные принадлежат конкретному счёту. Это помогает избежать ситуации, когда покупатель открыл один итог, а затем получил другой.

Если цена, описание или распределение расходов изменились, создайте новую ссылку и остановите прежнюю. Не редактируйте сумму в адресной строке: параметры браузера не являются доверенным источником расчёта.

Отдельная страница оплаты#

Серверная ссылка хранится в базе и открывается на другом устройстве по адресу /pay/… без кабинета продавца. Покупателю не нужно регистрироваться в Kevmi, чтобы прочитать счёт. На странице нет баланса магазина, его настроек или списка других клиентов.

Демонстрационный счёт /pay/demo позволяет увидеть этот путь без списания. Браузерные ссылки старого демо остаются тестовыми и не должны отправляться как настоящие счета.

Управление доступностью#

Пауза, отмена и истечение срока ссылки запрещают запуск новой операции. Они не скрывают уже отправленный платёж: его статус, сверка и запрошенный банковский код продолжают работать. Состояние ссылки и финансовая операция проверяются отдельно.

Возобновление снимает паузу, но не меняет условия счёта. Отмена окончательна; срок истёкшей ссылки не продлевается. Создавайте новый счёт только для нового заказа или новых условий, а не для повторного списания при неизвестном результате.