Anleitungen

Make

Zahlungen in jedes Make-Szenario: sofortige Trigger für bezahlte Rechnungen, Erstattungen, Abos und Kunden; Module, die Rechnungen und Zahlungslinks erstellen und finden.

Als Markdown ansehen

Die App von Perly Pay bringt Ihre Zahlungen nach Make. Eine bezahlte Rechnung kann eine Tabelle füllen, ein CRM aktualisieren oder eine Discord-Rolle vergeben; ein Formular kann eine Rechnung erstellen und die Zahlungsseite senden. Nichts zu hosten, kein Code.

Test- und Live-Schlüssel sind zwei Verbindungen. Ein Szenario auf der Testverbindung sieht nur Testzahlungen.

Verbinden

1
Schlüssel holen
In Perly Pay: Dashboard → Developers → API keys. sk_test_… für den Testmodus, sk_live_… für echtes Geld.
2
Perly Pay zum Szenario hinzufügen
Die App ist auf dem Weg in die App-Liste von Make. Bis sie dort ist, schreiben Sie uns für einen Einladungslink; öffnen Sie ihn einmal, danach finden Sie Perly Pay, wenn Sie ein Modul hinzufügen.
3
Verbinden
Mit Add eine Verbindung anlegen und den Schlüssel einfügen. Benennen Sie sie so, dass Test und Live unterscheidbar sind.

Sofortige Trigger

Modul	Wann	Ereignis
Watch paid invoices	Vollständig bezahlt, Absender geprüft. Zeit, Zugang zu geben oder zu versenden.	`invoice.fulfilled`
Watch underpaid invoices	Der Käufer hat weniger gesendet, als die Rechnung verlangt.	`invoice.underpaid`
Watch opened refunds	Sie haben eine Erstattung eröffnet.	`refund.requested`
Watch confirmed refunds	Ihre gesendete Erstattung ist im Netzwerk bestätigt.	`refund.confirmed`
Watch started subscriptions	Ein Abo hat begonnen.	`subscription.created`
Watch renewed subscriptions	Ein Abonnent hat den nächsten Zeitraum bezahlt.	`subscription.renewed`
Watch ended subscriptions	Ein Abo ist beendet. Zeit, den Zugang zu entziehen.	`subscription.ended`
Watch new customers	Ein neuer Käufer.	`customer.created`

Wenn Sie in Make den Webhook eines Triggers hinzufügen, erscheint unter Dashboard → Developers → Webhooks ein Webhook wie Make: Paid invoices; löschen Sie ihn in Make, verschwindet er. Bevor ein Szenario läuft, holt Make jede Zustellung mit Ihrem Schlüssel bei Perly Pay ab, und Perly Pay gibt jede nur einmal heraus: Eine Anfrage, die nicht von Perly Pay kommt oder erneut gesendet wird, löst nichts aus. Jeder Webhook ist einer der 16, die ein Modus haben kann.

Jeder Trigger liefert das Ereignis und das Objekt, um das es geht – Rechnung, Erstattung, Abo oder Kunde – so, wie die API sie hat. Währungsbeträge sind in Cent (total 4900 sind 49.00): Teilen Sie in der Zuordnung durch 100. Coin-Beträge sind in der kleinsten Einheit der Coin, daneben ihre decimals.

Module

Modul	Was Sie angeben	Was Sie erhalten
Create an invoice	Einen Betrag (etwa 49.00), eine Beschreibung; optional Währung, E-Mail des Kunden, Rückgabeadresse, Metadaten	Eine Rechnung mit Zahlungsseite (Payment page URL) für den Käufer
Create a payment link	Einen Preis oder Namen und Betrag eines neuen Produkts	Eine Seite, die es verkauft – teilen Sie sie überall
Get an invoice	Eine Rechnungs-ID	Ihren Status, was angekommen ist, die Zahlungsseite
Search customers	Eine E-Mail, oder nichts für alle	Kunden, die neuesten zuerst
Make an API call	Ein Pfad wie `/invoices`, eine Methode und, falls nötig, ein JSON-Body	Die Antwort der API, wie sie ist, für alles, was die anderen Module nicht tun

Rezepte

Zahlung → Zeile in Google Sheets

1
Trigger
Perly Pay → Watch paid invoices. Fügen Sie den Webhook hinzu; lassen Sie das Szenario einmal laufen und bezahlen Sie eine Testrechnung, damit Make die Felder kennenlernt.
2
Aktion
Google Sheets → Add a Row, in einer Tabelle mit Spalten wie Datum, E-Mail, Betrag, Coin.
3
Zuordnen
Datum → Invoice: Paid at, E-Mail → Customer email, Betrag → Total (cents) / 100, Coin → Payment: Coin. Einschalten.

Zahlung → Rolle in Discord

Discord muss wissen, wer bezahlt hat. Legen Sie die Discord-ID des Käufers beim Erstellen in die Rechnung und lesen Sie sie zurück, wenn die Rechnung bezahlt ist.

1
Szenario 1: die Rechnung
Trigger: Ihr Anmeldeformular mit E-Mail und Discord-ID. Perly Pay → Create an invoice, Metadaten-Schlüssel discord_user_id, Wert = die Antwort aus dem Formular. Dann senden Sie dem Käufer die Payment page URL.
2
Szenario 2: die Rolle
Perly Pay → Watch paid invoices. Discord → Add a Role to a Member (oder Make an API call an Discord): Ihr Server, die Rolle, und das Mitglied = Invoice: Metadata → discord_user_id.
3
Rolle entziehen
Für ein Abo nimmt Watch ended subscriptions die Rolle genauso wieder weg.

Testen

Erstellen Sie auf der Testverbindung eine Rechnung (per Modul oder im Dashboard) und bezahlen Sie sie mit Test-Coins oder über die API anhand der Rechnungs-ID:

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

Nach wenigen Sekunden läuft das Szenario. Seine History zeigt jeden Lauf und was angekommen ist.

Echte Zahlungen

Schalten Sie in Perly Pay den Live-Modus ein und verbinden Sie die öffentlichen Schlüssel Ihrer Wallet.
Fügen Sie eine Verbindung mit einem Schlüssel sk_live_… hinzu. Legen Sie in jedem Szenario darauf einen neuen Webhook für den Trigger an und stellen Sie die anderen Perly-Pay-Module darauf um.
Bezahlen Sie eine kleine echte Rechnung und sehen Sie zu, wie sie ankommt.