До змісту

Посібники

Zapier

Оплати в Google Sheets, Notion, CRM чи Discord без коду: тригери на сплачені рахунки, повернення, підписки й клієнтів; дії, що створюють рахунки й платіжні посилання.

Відкрити як Markdown

Застосунок Perly Pay з'єднує ваші оплати з тисячами застосунків у Zapier. Сплачений рахунок може додати рядок у таблицю, контакт у CRM чи роль у Discord; форма може створити рахунок і надіслати сторінку оплати. Нічого не треба розміщувати, коду немає.

Тестовий і живий ключ — це два підключення. Zap на тестовому підключенні бачить лише тестові оплати.

Підключення

  1. 1

    Візьміть ключ

    У Perly Pay: Dashboard → Developers → API keys. sk_test_… для тестового режиму, sk_live_… для справжніх грошей.

  2. 2

    Додайте Perly Pay у Zap

    Застосунок уже на шляху до каталогу Zapier. Доки його там немає, напишіть нам по посилання-запрошення; далі знайдіть Perly Pay у Zap.

  3. 3

    Підключіть

    Вставте ключ. Підключення назветься за режимом і чотирма останніми знаками ключа, наприклад Test mode · …4f2a.

Тригери

ТригерКолиПодія
Invoice PaidСплачено повністю, відправника перевірено. Час дати доступ чи відправити товар.invoice.fulfilled
Payment UnderpaidПокупець надіслав менше, ніж просить рахунок.invoice.underpaid
Refund OpenedВи відкрили повернення.refund.requested
Refund ConfirmedНадіслане вами повернення підтверджено в мережі.refund.confirmed
Subscription StartedПочалася підписка.subscription.created
Subscription RenewedПідписник сплатив наступний період.subscription.renewed
Subscription EndedПідписка скінчилася. Час забрати доступ.subscription.ended
New CustomerНовий покупець.customer.created

Коли ви вмикаєте Zap, у Dashboard → Developers → Webhooks з'являється вебхук на кшталт Zapier: Invoice Paid; коли вимикаєте — зникає. Не змінюйте такі вебхуки: Zapier зберігає їхній секрет і ним перевіряє підпис кожної доставки. Тригер кожного Zap займає один із 16 вебхуків, що їх може мати режим.

Кожен тригер віддає об'єкт, про який подія, — рахунок, повернення, підписку чи клієнта — з усіма полями API. Суми приходять двічі: як їх тримає API, у центах (total 4900), і готовими для таблиці (total_decimal 49.00). Items каже, що купили.

Дії

ДіяЩо датиЩо отримаєте
Create InvoiceСуму (як 49.00), опис; за бажанням валюту, пошту клієнта, адресу повернення, метаданіРахунок зі сторінкою оплати (Payment Page URL) для покупця
Create Payment LinkЦіну або назву й суму нового товаруСторінку, що його продає, — поширюйте де завгодно
Find CustomerПоштуКлієнта або нічого

Рецепти

Оплата → рядок у Google Sheets

  1. 1

    Тригер

    Perly Pay → Invoice Paid. Перевірте: Zapier покаже останні сплачені рахунки (у тестовому режимі спершу сплатіть один).

  2. 2

    Дія

    Google Sheets → Create Spreadsheet Row, у таблиці зі стовпцями на кшталт Дата, Пошта, Що купили, Сума, Монета.

  3. 3

    Зіставте

    Дата → Paid At, Пошта → Customer Email, Що купили → Items, Сума → Total, Монета → Coin. Увімкніть.

Оплата → роль у Discord

Discord має знати, хто заплатив. Покладіть Discord-ідентифікатор покупця в рахунок, коли створюєте його, і прочитайте назад, коли рахунок сплачено.

  1. 1

    Zap 1: рахунок

    Тригер: ваша форма реєстрації (Typeform, Google Forms, Tally) з поштою й Discord-ідентифікатором. Дія: Perly Pay → Create Invoice, метадані discord_user_id = відповідь із форми. Дія: надішліть покупцеві Payment Page URL.

  2. 2

    Zap 2: роль

    Тригер: Perly Pay → Invoice Paid. Дія: Discord → Add Role to User: ваш сервер, роль, а User = метадані рахунку discord_user_id.

  3. 3

    Заберіть роль

    Для підписки третій Zap на Subscription Ended так само знімає роль.

Перевірка

На тестовому підключенні створіть рахунок (дією або в дашборді) і сплатіть тестовими монетами чи через API за ідентифікатором рахунку:

bash
curl -X POST https://pay.perly.io/api/v1/invoices/inv_…/simulate \
  -H "Authorization: Bearer $PERLY_PAY_SECRET_KEY" -H "Content-Type: application/json" -d '{}'

За кілька секунд спрацює Invoice Paid. Zap History показує кожен запуск і що він надіслав.

Справжні оплати

  • Увімкніть живий режим у Perly Pay і підключіть публічні ключі гаманця.
  • У кожному Zap переведіть крок Perly Pay на нове підключення з ключем sk_live_…, вимкніть і ввімкніть Zap, щоб його вебхук перейшов у живий режим.
  • Сплатіть один невеликий справжній рахунок і подивіться, як він прийде.