GET
/integration/transactions/{uuid}/h2hВозвращает платёжные реквизиты транзакции от провайдера: сумму и строку qr(QR-код СБП или платёжную ссылку). Используйте этот метод, если хотите встроить оплату в свой UI (host-to-host), а не отправлять клиента на payment_url.
Когда использовать
Обычный сценарий — редирект на payment_url из ответа создания платежа. H2H нужен, когда вы рендерите QR/реквизиты сами: в приложении, боте или на собственной странице оплаты.
Параметры пути
| Поле | Тип | Описание |
|---|---|---|
uuidобяз. | string | Идентификатор транзакции из ответа создания платежа. |
Пример
curl https://api.cashera.cash/api/v1/integration/transactions/9b1f2c4e-7a01-4b9d-8f1c-2eab57d90c11/h2h \-H "X-Api-Key: $CASHERA_API_KEY"
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
amountопц. | number | Сумма к оплате, как её возвращает провайдер. |
qrопц. | string | Строка QR-кода СБП или платёжная ссылка. Отрендерьте её как QR или кнопку оплаты. |
Реквизиты появляются не сразу
Метод работает только после того, как провайдер инициировал платёж и присвоил ему идентификатор. Сразу после создания транзакции реквизиты могут быть ещё не готовы — в этом случае вернётся422. Повторите запрос через короткую паузу.
Ошибки
| Поле | Тип | Описание |
|---|---|---|
401опц. | Unauthorized | Неверный или отсутствующий X-Api-Key. |
404опц. | Not Found | Транзакция не найдена или принадлежит другому мерчанту. |
422опц. | Unprocessable Entity | Реквизиты ещё не готовы (провайдер не присвоил идентификатор платежа). |
502опц. | Bad Gateway | Не удалось получить реквизиты от провайдера. |