Stripe: подключение и права ключа
Какой ключ Stripe вписать в POSitive, какие права включить для приёма оплат, отчёта о выплатах и возврата денег на карту гостя.
POSitive работает с вашим аккаунтом Stripe по ключу, который вы создаёте сами. От прав ключа зависит, что будет доступно: приём оплат, отчёт о выплатах и возврат денег на карту гостя.
Шаг 1. Создайте ключ в Stripe
- Откройте кабинет Stripe → Developers → API keys.
- Нажмите Create restricted key и назовите ключ, например «POSitive».
- Включите права из таблицы ниже.
- Нажмите Create и скопируйте ключ. Он начинается с
rk_live_.
Шаг 2. Включите права
Включите все строки сразу, чтобы не возвращаться в кабинет Stripe для каждой функции.
| Для чего | Право в Stripe | Уровень |
|---|---|---|
| Приём: ссылка на оплату картой | Checkout Sessions | Write |
| Приём: QR банка (PromptPay) | PaymentIntents | Write |
| Просмотр: баланс и деньги в обработке | Balance | Read |
| Просмотр: выплаты на банк | Payouts | Read |
| Просмотр: из каких оплат сложилась выплата, карта гостя | Balance transaction sources | Read |
| Просмотр: предупреждения о спорах по оплатам | Disputes | Read |
| Просмотр: расписание выплат и предупреждения об остановке выплат | Connect → Accounts | Read |
| Возврат на карту гостя | Charges and Refunds | Write |
Для возврата нужны ещё PaymentIntents и Checkout Sessions, но они уже включены строками приёма.
В кабинете Stripe откройте меню «⋯» рядом с ключом → Edit и добавьте права. Значение ключа не меняется, вписывать его в POSitive заново не нужно.
Не пересылайте его в мессенджерах и не храните в заметках. Если ключ мог попасть к посторонним, удалите его в кабинете Stripe и создайте новый. Publishable key (pk_live_) не подойдёт. Полный Secret key (sk_live_) сработает, но у него есть все права, поэтому лучше ограниченный.
Шаг 3. Впишите ключ в POSitive
- В бэк-офисе выберите заведение и откройте Настройки → Деньги.
- В блоке «Ссылка на оплату — из чата и с кассы» включите Разрешить ссылки на оплату.
- Вставьте ключ в поле Секретный ключ Stripe. Валюта для Таиланда —
thb. - Выберите способы оплаты, которыми касса запишет деньги: отдельно для карты и для QR банка.
- Нажмите Сохранить. Сохранённый ключ показывается точками.
Ключ вписывается в каждом заведении отдельно. Если у двух заведений один ключ, их деньги приходят на один банковский счёт.
Для QR банка включите PromptPay в кабинете Stripe: Settings → Payment methods.
Где смотреть деньги
Отчёт находится в разделе Деньги → Stripe: что в пути на банк, что готово к выплате, что в обработке и из каких оплат сложилась каждая выплата. Открыть его может сотрудник с доступом к финансам.
Как вернуть деньги на карту гостя
Для возврата нужны право роли «Возврат и отмена чека из бэк-офиса» и приложение-аутентификатор. Подключается оно один раз: меню профиля справа вверху → Аутентификатор → отсканируйте QR-код приложением, например Google Authenticator.
- Откройте Деньги → Чеки и нажмите на нужный чек.
- В карточке чека нажмите Возврат.
- Выберите позиции и укажите причину.
- Отметьте Вернуть деньги гостю на карту через Stripe.
- Введите 6 цифр из приложения и подтвердите.
Деньги уходят сразу, а возврат записывается в чек. На карту гостя они обычно приходят за 5–10 дней. Один код подтверждает только одно действие.
Вернуть на карту из POSitive можно только чек, оплаченный ссылкой Stripe с кассы:
- если чек оплачен частично наличными или другим способом, сделайте обычный возврат, а деньги верните сами;
- заказы, оплаченные на сайте, возвращаются в кабинете Stripe;
- чек, оплаченный QR банка (PromptPay), этой кнопкой не возвращайте. Stripe запрашивает реквизиты счёта у гостя по почте, а QR на кассе создаётся без почты гостя. Переведите деньги гостю сами и сделайте обычный возврат.
Если что-то не работает
| Что видно | Что сделать |
|---|---|
| В «Деньги → Stripe» перечислены права | Добавьте эти права ключу в кабинете Stripe |
| В окне возврата написано, что у ключа не хватает прав | Добавьте Charges and Refunds — Write |
| Stripe не принял ключ | Проверьте, что ключ вставлен целиком и не удалён в кабинете Stripe |
| Нет кнопки «Возврат» | Чек ещё открыт, полностью возвращён, тестовый, относится к другому заведению, либо у роли нет права |
| Нет отметки «Вернуть на карту» | Чек оплачен не ссылкой Stripe с кассы |
| QR банка не создаётся | Проверьте PaymentIntents — Write, включённый PromptPay и валюту thb |