Справка / Настройки

Stripe: подключение и права ключа

Какой ключ Stripe вписать в POSitive, какие права включить для приёма оплат, отчёта о выплатах и возврата денег на карту гостя.

POSitive работает с вашим аккаунтом Stripe по ключу, который вы создаёте сами. От прав ключа зависит, что будет доступно: приём оплат, отчёт о выплатах и возврат денег на карту гостя.

Шаг 1. Создайте ключ в Stripe

  1. Откройте кабинет Stripe → Developers → API keys.
  2. Нажмите Create restricted key и назовите ключ, например «POSitive».
  3. Включите права из таблицы ниже.
  4. Нажмите Create и скопируйте ключ. Он начинается с rk_live_.

Шаг 2. Включите права

Включите все строки сразу, чтобы не возвращаться в кабинет Stripe для каждой функции.

Для чегоПраво в StripeУровень
Приём: ссылка на оплату картойCheckout SessionsWrite
Приём: QR банка (PromptPay)PaymentIntentsWrite
Просмотр: баланс и деньги в обработкеBalanceRead
Просмотр: выплаты на банкPayoutsRead
Просмотр: из каких оплат сложилась выплата, карта гостяBalance transaction sourcesRead
Просмотр: предупреждения о спорах по оплатамDisputesRead
Просмотр: расписание выплат и предупреждения об остановке выплатConnect → AccountsRead
Возврат на карту гостяCharges and RefundsWrite

Для возврата нужны ещё PaymentIntents и Checkout Sessions, но они уже включены строками приёма.

Ключ уже подключён, а прав не хватает

В кабинете Stripe откройте меню «⋯» рядом с ключом → Edit и добавьте права. Значение ключа не меняется, вписывать его в POSitive заново не нужно.

Ключ с правом Write на возвраты может вернуть деньги

Не пересылайте его в мессенджерах и не храните в заметках. Если ключ мог попасть к посторонним, удалите его в кабинете Stripe и создайте новый. Publishable key (pk_live_) не подойдёт. Полный Secret key (sk_live_) сработает, но у него есть все права, поэтому лучше ограниченный.

Шаг 3. Впишите ключ в POSitive

  1. В бэк-офисе выберите заведение и откройте Настройки → Деньги.
  2. В блоке «Ссылка на оплату — из чата и с кассы» включите Разрешить ссылки на оплату.
  3. Вставьте ключ в поле Секретный ключ Stripe. Валюта для Таиланда — thb.
  4. Выберите способы оплаты, которыми касса запишет деньги: отдельно для карты и для QR банка.
  5. Нажмите Сохранить. Сохранённый ключ показывается точками.

Ключ вписывается в каждом заведении отдельно. Если у двух заведений один ключ, их деньги приходят на один банковский счёт.

Для QR банка включите PromptPay в кабинете Stripe: Settings → Payment methods.

Где смотреть деньги

Отчёт находится в разделе Деньги → Stripe: что в пути на банк, что готово к выплате, что в обработке и из каких оплат сложилась каждая выплата. Открыть его может сотрудник с доступом к финансам.

Как вернуть деньги на карту гостя

Для возврата нужны право роли «Возврат и отмена чека из бэк-офиса» и приложение-аутентификатор. Подключается оно один раз: меню профиля справа вверху → Аутентификатор → отсканируйте QR-код приложением, например Google Authenticator.

  1. Откройте Деньги → Чеки и нажмите на нужный чек.
  2. В карточке чека нажмите Возврат.
  3. Выберите позиции и укажите причину.
  4. Отметьте Вернуть деньги гостю на карту через Stripe.
  5. Введите 6 цифр из приложения и подтвердите.

Деньги уходят сразу, а возврат записывается в чек. На карту гостя они обычно приходят за 5–10 дней. Один код подтверждает только одно действие.

Вернуть на карту из POSitive можно только чек, оплаченный ссылкой Stripe с кассы:

  • если чек оплачен частично наличными или другим способом, сделайте обычный возврат, а деньги верните сами;
  • заказы, оплаченные на сайте, возвращаются в кабинете Stripe;
  • чек, оплаченный QR банка (PromptPay), этой кнопкой не возвращайте. Stripe запрашивает реквизиты счёта у гостя по почте, а QR на кассе создаётся без почты гостя. Переведите деньги гостю сами и сделайте обычный возврат.

Если что-то не работает

Что видноЧто сделать
В «Деньги → Stripe» перечислены праваДобавьте эти права ключу в кабинете Stripe
В окне возврата написано, что у ключа не хватает правДобавьте Charges and Refunds — Write
Stripe не принял ключПроверьте, что ключ вставлен целиком и не удалён в кабинете Stripe
Нет кнопки «Возврат»Чек ещё открыт, полностью возвращён, тестовый, относится к другому заведению, либо у роли нет права
Нет отметки «Вернуть на карту»Чек оплачен не ссылкой Stripe с кассы
QR банка не создаётсяПроверьте PaymentIntents — Write, включённый PromptPay и валюту thb