Платёжная страница

У каждого инвойса и депозита есть готовая страница оплаты. Когда адрес готов, передайте клиенту payment_url из ответа API.

На странице уже есть токен, сеть, адрес, QR-код и статус. Делать собственный checkout не нужно.

Передайте ссылку

Используйте payment_url как есть. Не собирайте ссылку из issuance_id и не полагайтесь на фиксированный формат public_id.

Клиент должен отправить указанный токен в указанной сети. Перевод другого токена или в другой сети не оплачивает инвойс.

Настройте название и логотип

Измените оформление в интерфейсе или через API с сессией владельца:

PATCH /api/v1/shops/{shop_id}/branding
Authorization: Bearer <owner-session-token>
Idempotency-Key: <saved-unique-key>
Content-Type: application/json

{"name":"My shop"}

Оформление задаёт название магазина и логотип. Ссылку return_url укажите при создании инвойса или депозита. Адрес получателя от этого не меняется.

Подтвердите оплату на сервере

Ссылка возврата нужна для навигации. Сам переход по ней не доказывает оплату.

Проверьте статус инвойса и депозита с вашего бэкенда или подпись вебхука. API-ключ должен оставаться на сервере: не вставляйте его в ссылку или код браузера.