На обоих рынках большинство гостей платят не картой, а электронным кошельком, национальным QR-кодом или банковским переводом. Все три провайдера отправляют гостя на свою платёжную страницу, где видны способы, включённые в вашем аккаунте.
Xendit (Индонезия, Филиппины)
Одна модель аккаунта в обеих странах, в рупиях или песо. TapTime открывает платёжную сессию Xendit на каждый счёт и перечитывает её у Xendit, прежде чем что-то отметить оплаченным.
-
1
Создайте API-ключ
В кабинете Xendit откройте Settings → API keys и создайте секретный ключ с правом записи для Money-in.
-
2
Направьте webhook на TapTime
В Settings → Webhooks укажите в Payment Session URL адрес callback, показанный для Xendit на экране «Интеграции».
-
3
Скопируйте токен проверки
Он показан на той же странице Webhooks и подтверждает, что каждое уведомление пришло от Xendit.
| Поле в TapTime | Откуда берётся |
|---|---|
| Секретный API-ключ | Settings → API keys. Начинается с xnd_. Секрет. |
| Токен проверки webhook | Settings → Webhooks. Секрет. |
Midtrans Snap (Индонезия)
Midtrans нужно одно значение. В тестовом режиме используйте серверный ключ sandbox, а после одобрения аккаунта — боевой ключ.
| Поле в TapTime | Откуда берётся |
|---|---|
| Серверный ключ | Кабинет Midtrans → Settings → Access keys. Секрет. |
PayMongo (Филиппины)
Платёжная страница PayMongo принимает карты, GCash, Maya, QR Ph и другое. Webhook создаётся один раз в кабинете PayMongo и подписывается собственным секретом.
| Поле в TapTime | Откуда берётся |
|---|---|
| Секретный ключ | Developers → API keys. sk_test_ в тестовом режиме, sk_live_ в боевом. Секрет. |
| Секретный ключ webhook | Developers → Webhooks, у endpoint, созданного для адреса callback TapTime с событием checkout_session.payment.paid. Начинается с whsk_. Секрет. |
| Способы оплаты | Необязательно. Включённые в аккаунте способы через запятую, например card, gcash, paymaya, qrph. Оставьте пустым для этих четырёх. |
Частые вопросы
Почему суммы в рупиях целые?
Индонезийские шлюзы списывают рупии целыми единицами. TapTime отправляет счёт, округлённый до ближайшей рупии, — на практике это сам счёт, ведь в ценах меню нет сенов.
Что быстрее всего подключить?
Xendit и PayMongo подключаются онлайн и сразу дают тестировать с тестовыми ключами. Midtrans проверяет аккаунт, прежде чем заработают боевые ключи, но sandbox доступен сразу.
Спасибо — так мы делаем эти руководства лучше.
Напишите нам и укажите страницу, на которой вы были. Каждое сообщение читает человек, а ответ приходит на том языке, на котором вы написали.
Напишите нам