إلى المحتوى
Perly
ابدأابدأ مجانًا

الأدلة

Make

المدفوعات في أي سيناريو Make: مشغّلات فورية للفواتير المدفوعة والاستردادات والاشتراكات والعملاء؛ ووحدات تنشئ الفواتير وروابط الدفع وتجدها.

افتح بصيغة Markdown

يجلب تطبيق Perly Pay مدفوعاتك إلى Make. يمكن لفاتورة مدفوعة أن تملأ جدولًا، أو تحدّث نظام CRM، أو تمنح دورًا في Discord؛ ويمكن لنموذج أن ينشئ فاتورة ويرسل صفحة الدفع. لا شيء لاستضافته، ولا كود.

مفتاح الاختبار والمفتاح الحقيقي اتصالان منفصلان. السيناريو على اتصال الاختبار يرى مدفوعات الاختبار فقط.

الاتصال

  1. 1

    خذ مفتاحًا

    في Perly Pay: Dashboard → Developers → API keys. sk_test_… لـوضع الاختبار، وsk_live_… للأموال الحقيقية.

  2. 2

    أضف Perly Pay إلى السيناريو

    التطبيق في طريقه إلى قائمة تطبيقات Make. وحتى يصل، راسلنا للحصول على رابط الدعوة؛ افتحه مرة، ثم ابحث عن Perly Pay حين تضيف وحدة.

  3. 3

    اربط

    اضغط Add لإضافة اتصال والصق المفتاح. سمّه بحيث تميّز الاختباري من الحقيقي.

المشغّلات الفورية

الوحدةمتىالحدث
Watch paid invoicesدُفعت بالكامل، وفُحص المُرسل. حان وقت منح الوصول أو شحن الطلب.invoice.fulfilled
Watch underpaid invoicesأرسل المشتري أقل مما تطلبه الفاتورة.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 كل تسليم مرة واحدة فقط: لا يشغّل أي طلب ليس من 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بريدًا إلكترونيًا، أو لا شيء — للجميعالعملاء، الأحدث أولًا
Make an API callمسار مثل /invoices، وطريقة، ومحتوى JSON إن لزمردّ الـ API كما هو، لكل ما لا تفعله الوحدات الأخرى

وصفات

دفعة ← صف في Google Sheets

  1. 1

    المشغّل

    Perly Pay → Watch paid invoices. أضف الويب هوك؛ شغّل السيناريو مرة وادفع فاتورة اختبار ليتعرف Make على الحقول.

  2. 2

    الإجراء

    Google Sheets → Add a Row، في جدول بأعمدة مثل التاريخ، والبريد، والمبلغ، والعملة.

  3. 3

    اربط الحقول

    التاريخ ← Invoice: Paid at، البريد ← Customer email، المبلغ ← Total (cents) / 100، العملة ← Payment: Coin. فعّل.

دفعة ← دور في Discord

يجب أن يعرف Discord من دفع. ضع معرّف Discord للمشتري في الفاتورة حين تنشئها، واقرأه مجددًا حين تُدفع.

  1. 1

    السيناريو 1: الفاتورة

    المشغّل: نموذج التسجيل لديك مع البريد ومعرّف Discord. Perly Pay → Create an invoice، مفتاح البيانات الوصفية discord_user_id، والقيمة — الإجابة من النموذج. ثم أرسل إلى المشتري Payment page URL.

  2. 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. 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 الأخرى.
  • ادفع فاتورة حقيقية صغيرة وشاهد وصولها.