/integration/transactions/{uuid}/h2hВозвращает платёжные реквизиты транзакции от провайдера: сумму и строку qr(QR-код СБП или платёжную ссылку). Используйте этот метод, если хотите встроить оплату в свой UI (host-to-host), а не отправлять клиента на payment_url.
Обычный сценарий - редирект на payment_url из ответа создания платежа. H2H нужен, когда вы рендерите QR/реквизиты сами: в приложении, боте или на собственной странице оплаты.
H2H доступен для sbp, card и crypto. Недоступен для mastercard (международный эквайринг) и cryptobot - эти методы работают только через редирект на страницу провайдера, поэтому реквизиты для собственного UI не выдаются.
Для mastercard оплата картой проходит через защищённую страницу провайдера (3-D Secure), для cryptobot - через Telegram-бота. В обоих случаях отправляйте клиента на payment_url из ответа создания платежа.
Параметры пути
| Поле | Тип | Описание |
|---|---|---|
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 |
403 | Forbidden | Мерчант отключён или удалён, либо запрос пришёл с IP вне разрешённого списка (IP-allowlist). Ключ при этом может быть валидным |
404 | Not Found | Транзакция не найдена или принадлежит другому мерчанту |
422 | Unprocessable Entity | Реквизиты ещё не готовы (провайдер не присвоил идентификатор платежа). Для mastercard и cryptobot H2H не поддерживается - различайте по тексту message |
429 | Too Many Requests | Превышен лимит запросов. При опросе реквизитов делайте паузу между попытками |
502 | Bad Gateway | Не удалось получить реквизиты от провайдера |