Посібники

Make

Оплати в будь-який сценарій Make: миттєві тригери на сплачені рахунки, повернення, підписки й клієнтів; модулі, що створюють рахунки й платіжні посилання та знаходять їх.

Відкрити як Markdown

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

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

Підключення

1
Візьміть ключ
У Perly Pay: Dashboard → Developers → API keys. sk_test_… для тестового режиму, sk_live_… для справжніх грошей.
2
Додайте Perly Pay у сценарій
Застосунок уже на шляху до списку застосунків Make. Доки його там немає, напишіть нам по посилання-запрошення; відкрийте його раз, далі знайдіть Perly Pay, коли додаєте модуль.
3
Підключіть
Add підключення і вставте ключ. Назвіть його так, щоб відрізняти тестове від живого.

Миттєві тригери

Модуль	Коли	Подія
Watch Paid Invoices	Сплачено повністю, відправника перевірено. Час дати доступ чи відправити товар.	`invoice.fulfilled`
Watch Underpaid Payments	Покупець надіслав менше, ніж просить рахунок.	`invoice.underpaid`
Watch Opened Refunds	Ви відкрили повернення.	`refund.requested`
Watch Confirmed Refunds	Надіслане вами повернення підтверджено в мережі.	`refund.confirmed`
Watch Started Subscriptions	Почалася підписка.	`subscription.created`
Watch Renewed Subscriptions	Підписник сплатив наступний період.	`subscription.renewed`
Watch Ended Subscriptions	Підписка скінчилася. Час забрати доступ.	`subscription.ended`
Watch New Customers	Новий покупець.	`customer.created`

Коли ви додаєте вебхук тригера в Make, у Dashboard → Developers → Webhooks з'являється вебхук на кшталт Make: Paid Invoices; коли видаляєте його в Make — зникає. Перш ніж сценарій запуститься, Make перечитує кожну доставку з Perly Pay вашим ключем, тож запит не від Perly Pay нічого не запускає. Кожен вебхук — один із 16, що їх може мати режим.

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

Модулі

Модуль	Що дати	Що отримаєте
Create an Invoice	Суму (як 49.00), опис; за бажанням валюту, пошту клієнта, адресу повернення, метадані	Рахунок зі сторінкою оплати (Payment page URL) для покупця
Create a Payment Link	Ціну або назву й суму нового товару	Сторінку, що його продає, — поширюйте де завгодно
Get an Invoice	Ідентифікатор рахунку	Його стан, що надійшло, сторінку оплати
Search Customers	Пошту, або нічого — для всіх	Клієнтів, найновіші першими

Рецепти

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

1
Тригер
Perly Pay → Watch Paid Invoices. Додайте вебхук; запустіть сценарій раз і сплатіть тестовий рахунок, щоб Make дізнався поля.
2
Дія
Google Sheets → Add a Row, у таблиці зі стовпцями на кшталт Дата, Пошта, Сума, Монета.
3
Зіставте
Дата → Invoice: Paid at, Пошта → Customer email, Сума → Total (cents) / 100, Монета → Payment: Coin. Увімкніть.

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

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

1
Сценарій 1: рахунок
Тригер: ваша форма реєстрації з поштою й Discord-ідентифікатором. Perly Pay → Create an Invoice, ключ метаданих discord_user_id, значення — відповідь із форми. Далі надішліть покупцеві Payment page URL.
2
Сценарій 2: роль
Perly Pay → Watch Paid Invoices. Discord → Add a Role to a Member (або Make an API Call до Discord): ваш сервер, роль, а учасник = Invoice: Metadata → discord_user_id.
3
Заберіть роль
Для підписки Watch Ended Subscriptions так само знімає роль.

Перевірка

На тестовому підключенні створіть рахунок (модулем або в дашборді) і сплатіть тестовими монетами чи через 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 '{}'

За кілька секунд сценарій запуститься. Його History показує кожен запуск і що надійшло.

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

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