AI ПаделДокументация API На сайт

Оплата брони через номинальный счёт Сбербанка

Игрок оплачивает корт при бронировании — картой или по СБП. Деньги поступают на номинальный счёт ООО «ЭЙАЙ СОЛЮШНС» в Сбербанке в пользу клуба и выплачиваются клубу полностью: платформа ничего из оплаты не удерживает.

Как это устроено

Подключение клуба

  1. Передать реквизиты клуба для заведения бенефициара номинального счёта.
  2. В панели клуба: «Оплата и условия брони» → номинальный счёт Сбербанка → идентификатор бенефициара.
  3. Выбрать номинальный счёт способом оплаты брони. С этого момента приложение предлагает оплату онлайн в этом клубе.

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}/qrQR-код СБП картинкой.
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Связь с банком не настроена.