Оплата брони через номинальный счёт Сбербанка
Игрок оплачивает корт при бронировании — картой или по СБП. Деньги поступают на номинальный счёт ООО «ЭЙАЙ СОЛЮШНС» в Сбербанке в пользу клуба и выплачиваются клубу полностью: платформа ничего из оплаты не удерживает.
Как это устроено
- Номинальный счёт ООО «ЭЙАЙ СОЛЮШНС» в Сбербанке; клуб — бенефициар этого счёта: его реквизиты заводятся один раз, после чего у клуба есть идентификатор бенефициара.
- Игрок бронирует корт и оплачивает на странице банка картой или по QR-коду СБП. Деньги сразу учитываются в пользу клуба.
- Неоплаченная бронь снимается, когда истекает срок оплаты клуба: слот не держится без денег.
- При отмене по правилам клуба оформляется возврат игроку. Возврат с номинального счёта проводит банк: пока он не проведён, в журнале клуба платёж отмечен как «возврат оформлен».
- Работает в одной цепочке с бронированием, условиями отмены и журналом оплат клуба.
Подключение клуба
- Передать реквизиты клуба для заведения бенефициара номинального счёта.
- В панели клуба: «Оплата и условия брони» → номинальный счёт Сбербанка → идентификатор бенефициара.
- Выбрать номинальный счёт способом оплаты брони. С этого момента приложение предлагает оплату онлайн в этом клубе.
API платёжного сервиса
Партнёры со своим приложением или сайтом бронирования могут работать с платёжным сервисом напрямую. Адрес сервиса и ключ выдаются вместе с доступом к API. Ключ партнёра действует только для клубов, под которые он выдан: выставить оплату, узнать статус, QR и журнал. Подключение клуба и возвраты — из панели клуба. Ключ передаётся в каждом запросе:
Authorization: Bearer <ключ платёжного сервиса>
Суммы в запросах — в рублях (3500 = 3 500,00 ₽), в ответах — в копейках (amount_minor: 350000).
| Метод | Что делает |
|---|---|
POST /v1/accounts | Подключить клуб: идентификатор бенефициара. Только из панели клуба. |
GET /v1/accounts/{club_id} | Подключён ли клуб: ready, валюта. |
POST /v1/payments | Выставить оплату брони; в ответе payment_url — страница оплаты, sbp_payload — ссылка для QR СБП. |
GET /v1/payments/{id} | Статус платежа; с ?refresh=1 — сначала спросить банк. |
GET /v1/payments/{id}/qr | QR-код СБП картинкой. |
POST /v1/payments/{id}/refund | Заявка на возврат игроку, полный или частичный; ответ 202. Только из панели клуба. |
GET /v1/clubs/{club_id}/payments | Журнал оплат клуба, последние 100. |
GET /health | Состояние сервиса, без ключа. |
Полный справочник со всеми полями сервис отдаёт сам по адресу /docs.
Выставить оплату
curl -X POST "<платёжный сервис>/v1/payments" \
-H "Authorization: Bearer <ключ платёжного сервиса>" -H "Content-Type: application/json" \
-d '{"club_id": "<клуб>", "amount": 3500, "description": "Корт 4 · 19:00",
"booking_ref": "<номер брони>", "success_url": "<страница возврата>"}'
# → {"id": "9a2e…", "status": "pending", "amount_minor": 350000, "currency": "RUB",
# "payment_url": "…", "sbp_payload": "…"}
| Статус | Что значит |
|---|---|
pending | Ждём оплаты игрока. |
succeeded | Оплачено: деньги на номинальном счёте в пользу клуба. |
failed | Срок оплаты истёк или банк отказал; ничего не списано. |
Заявка на возврат не меняет статус платежа, пока банк её не провёл: сумма к возврату — в поле refund_pending_minor.
Ошибки
| Код | Что значит |
|---|---|
401 unauthorized | Нет ключа или ключ неверный. |
409 club_not_connected | Клуб не подключён к номинальному счёту. |
400 only_rub | Оплата через номинальный счёт — только в рублях. |
409 payment_not_paid | Возврат по неоплаченному платежу. |
409 refund_already_requested | Вся сумма уже заявлена к возврату. |
503 sber_gateway_not_configured | Связь с банком не настроена. |