Rehberler

Make

Ödemeler her Make senaryosunda: ödenen faturalar, iadeler, abonelikler ve müşteriler için anında tetikleyiciler; fatura ve ödeme bağlantısı oluşturan ve bulan modüller.

Markdown olarak aç

Perly Pay uygulaması ödemelerini Make'e getirir. Ödenen bir fatura bir tabloyu doldurabilir, CRM'i güncelleyebilir ya da Discord'da rol verebilir; bir form fatura oluşturup ödeme sayfasını gönderebilir. Barındırılacak bir şey yok, kod yok.

Test ve canlı anahtar iki ayrı bağlantıdır. Test bağlantısındaki bir senaryo yalnızca test ödemelerini görür.

Bağlantı

1
Anahtarı al
Perly Pay'de: Dashboard → Developers → API keys. Test modu için sk_test_…, gerçek para için sk_live_….
2
Perly Pay'i senaryoya ekle
Uygulama Make uygulama listesine yolda. Orada olana kadar davet bağlantısı için bize yaz; onu bir kez aç, sonra modül eklerken Perly Pay'i ara.
3
Bağla
Bir bağlantı ekle (Add) ve anahtarı yapıştır. Testi canlıdan ayırt edebileceğin bir ad ver.

Anında tetikleyiciler

Modül	Ne zaman	Olay
Watch paid invoices	Tamamen ödendi, gönderen kontrol edildi. Erişim verme ya da ürünü gönderme zamanı.	`invoice.fulfilled`
Watch underpaid invoices	Alıcı faturanın istediğinden az gönderdi.	`invoice.underpaid`
Watch opened refunds	Bir iade açtın.	`refund.requested`
Watch confirmed refunds	Gönderdiğin iade ağda onaylandı.	`refund.confirmed`
Watch started subscriptions	Bir abonelik başladı.	`subscription.created`
Watch renewed subscriptions	Abone sonraki dönemi ödedi.	`subscription.renewed`
Watch ended subscriptions	Abonelik sona erdi. Erişimi kaldırma zamanı.	`subscription.ended`
Watch new customers	Yeni bir alıcı.	`customer.created`

Make'te bir tetikleyicinin webhook'unu eklediğinde, Dashboard → Developers → Webhooks'ta Make: Paid invoices gibi bir webhook belirir; Make'te silince kaybolur. Senaryo çalışmadan önce Make her teslimatı senin anahtarınla Perly Pay'den alır ve Perly Pay her teslimatı yalnızca bir kez verir; bu yüzden Perly Pay'den gelmeyen ya da yeniden gönderilen bir istek hiçbir şeyi çalıştırmaz. Her webhook, bir modun sahip olabileceği 16 webhook'tan biridir.

Her tetikleyici olayı ve ilgili nesneyi — fatura, iade, abonelik ya da müşteri — API'deki haliyle verir. Para birimi tutarları sent cinsindendir (total 4900, 49.00 demek): eşlemede 100'e böl. Coin tutarları coinin en küçük biriminde, yanında decimals ile.

Modüller

Modül	Ne verirsin	Ne alırsın
Create an invoice	Tutar (49.00 gibi), açıklama; istersen para birimi, müşteri e-postası, dönüş adresi, metadata	Alıcı için ödeme sayfalı (Payment page URL) bir fatura
Create a payment link	Bir fiyat ya da yeni bir ürünün adı ve tutarı	Onu satan bir sayfa — istediğin yerde paylaş
Get an invoice	Fatura kimliği	Durumu, gelenler, ödeme sayfası
Search customers	E-posta ya da hiçbir şey — hepsi için	Müşteriler, en yeniler önce
Make an API call	`/invoices` gibi bir yol, bir yöntem ve gerekiyorsa JSON gövdesi	API'nin yanıtı olduğu gibi; diğer modüllerin yapmadığı her şey için

Tarifler

Ödeme → Google Sheets'te bir satır

1
Tetikleyici
Perly Pay → Watch paid invoices. Webhook'u ekle; senaryoyu bir kez çalıştır ve bir test faturası öde ki Make alanları öğrensin.
2
Eylem
Google Sheets → Add a Row, Tarih, E-posta, Tutar, Coin gibi sütunları olan bir tabloda.
3
Eşle
Tarih → Invoice: Paid at, E-posta → Customer email, Tutar → Total (cents) / 100, Coin → Payment: Coin. Aç.

Ödeme → Discord'da rol

Discord'un kimin ödediğini bilmesi gerekir. Faturayı oluştururken alıcının Discord kimliğini faturaya koy ve fatura ödendiğinde geri oku.

1
Senaryo 1: fatura
Tetikleyici: e-posta ve Discord kimliği soran kayıt formun. Perly Pay → Create an invoice, metadata anahtarı discord_user_id, değeri formdaki cevap. Sonra alıcıya Payment page URL'yi gönder.
2
Senaryo 2: rol
Perly Pay → Watch paid invoices. Discord → Add a Role to a Member (ya da Discord'a Make an API call): sunucun, rol ve üye = Invoice: Metadata → discord_user_id.
3
Rolü geri al
Abonelik için Watch ended subscriptions aynı şekilde rolü kaldırır.

Test

Test bağlantısında bir fatura oluştur (modülle ya da panelde) ve test coinleriyle ya da fatura kimliğiyle API üzerinden öde:

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 '{}'

Birkaç saniye içinde senaryo çalışır. History her çalışmayı ve neyin geldiğini gösterir.

Gerçek ödemeler

Perly Pay'de canlı modu aç ve cüzdanın açık anahtarlarını bağla.
sk_live_… anahtarıyla bir bağlantı ekle. Her senaryoda bu bağlantıda tetikleyici için yeni bir webhook ekle ve diğer Perly Pay modüllerini ona geçir.
Küçük, gerçek bir fatura öde ve gelişini izle.