Was Sie brauchen
| Feld | Was es tut |
|---|---|
| API Key ID | Identifiziert Ihren MakePay-API-Schlüssel, sodass wir das richtige Konto aufrufen. |
| API Key Secret | Lässt uns MakePay-Checkouts auf Ihrem Konto erstellen. Geheim. |
| Webhook Secret | Bestätigt, dass ein Webhook wirklich von MakePay kam. Geheim. |
| Erfolgs-URL | Wohin der Käufer nach einer abgeschlossenen Zahlung landet. |
| Fehler-URL | Wohin der Käufer landet, falls die Zahlung fehlschlägt oder er abbricht. |
MakePay gibt die API Key ID und das Secret zusammen aus, wenn Sie einen Schlüssel erzeugen. Das Webhook Secret ist ein separater Wert aus den Callback-Einstellungen.
Warum wir nach jedem Feld fragen
API Key ID
Benennt, welcher MakePay-Schlüssel sich authentifiziert. Nicht geheim an sich, aber mit dem unten stehenden Secret gepaart.
API Key Secret
Autorisiert das Erstellen des Checkouts, sodass die Zahlung über Ihr MakePay-Konto läuft und auf Ihr Wallet geht. MakePay zeigt es einmal, gleich nach der Schlüssel-Erzeugung.
Webhook Secret
Beweist, dass ein eingehender Webhook echt von MakePay stammt, sodass niemand ein "bezahlt"-Ereignis fälschen kann. Es ist ein vom API Key getrennter Wert.
Erfolgs- und Fehler-URL
Schlichte Einstellungen: wohin der Käufer nach dem Zahlen oder nach einem Fehler oder Abbruch landet. Nicht geheim.
Einrichten
- Einen API-Schlüssel in MakePay erzeugen
Melden Sie sich bei MakePay an und öffnen Sie API & SDK → API integrations. Klicken Sie unter API keys auf Generate API Key, geben Sie einen Namen ein (zum Beispiel "Coin Moebius") und erzeugen Sie ihn. MakePay zeigt die API Key ID und das Secret einmal, direkt nach der Erzeugung — kopieren Sie beide sofort, denn das Secret wird danach nicht mehr angezeigt.
MakePay → API & SDK → API integrations → Generate API Key Behandeln Sie das API Key Secret wie ein Passwort. Wenn Sie es verlieren, erzeugen Sie einen neuen Schlüssel, anstatt zu versuchen, den alten wiederherzustellen.
- Ihre Coin-Moebius-Projekt-ID suchen
Öffnen Sie in einem separaten Tab Ihr Projekt im Coin-Moebius-Dashboard und kopieren Sie die Projekt-ID unter dem Projektnamen. Ihre MakePay-Callback-URL ist diese ID in der unten stehenden Adresse — Sie werden sie im nächsten Schritt in MakePay einfügen.
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → Ihr Projekt → Projekt-ID Die verbundene Anbieterkarte (letzter Schritt) zeigt dieselbe URL, sodass Sie sie jederzeit erneut kopieren können.
- Die Callback-URL einstellen und das Webhook Secret kopieren
Gehen Sie zurück zu MakePay und scrollen Sie zu Delivery → Callback URL configuration. Klicken Sie Edit Callback URL, fügen Sie Ihre Coin-Moebius-Webhook-URL als aktive Destination ein und speichern Sie. Unter Webhook signing kopieren Sie dann das Signing Secret (nutzen Sie Regenerate secret, falls es noch keinen Wert gibt) — das ist das Webhook Secret, das Coin Moebius verlangt.
MakePay → Delivery → Callback URL configuration MakePay sendet Lieferaktualisierungen an diese Adresse, nachdem jede für den Kunden sichtbare Statusänderung. Das Signing Secret ist unabhängig vom API Key — Sie brauchen beides.
- Im Coin-Moebius-Dashboard verbinden
Öffnen Sie in Coin Moebius Anbieter hinzufügen → MakePay. Fügen Sie Ihre API Key ID, Ihr API Key Secret und Ihr Webhook Secret ein, stellen Sie dann die Erfolgs-URL und die Fehler-URL ein (wohin Käufer nach dem Zahlen oder nach einem Fehler landen). Klicken Sie Speichern.
Coin Moebius → Anbieter hinzufügen → MakePay Gespeicherte Secrets bleiben verborgen. Um eines später zu ändern, wählen Sie Ersetzen und geben Sie den neuen Wert ein.
- Sie sind verbunden
MakePay erscheint jetzt im Reiter Anbieter mit dem Verbindungsdatum und der Webhook-URL, die es erwartet. Geben Sie diese URL in MakePays Callback-Einstellungen ein, falls noch nicht geschehen. Nutzen Sie Bearbeiten, um Schlüssel zu rotieren, oder Trennen, um es zu entfernen. Der Testmodus-Schalter lässt Sie eine Bestellung durchgehen, ohne Ihre echten Zahlen zu beeinflussen.
Coin Moebius → Anbieter → MakePay (verbunden)
Nachdem Sie verbunden haben
Führen Sie eine Bestellung durch, bevor Sie live gehen:
- Schalten Sie den Testmodus-Schalter auf der verbundenen MakePay-Karte ein, um eine Bestellung durchzugehen, ohne Ihre echten Zahlen zu beeinflussen.
- Erstellen Sie ein Produkt und setzen Sie den Buy-Button auf eine Seite (eine lokale HTML-Datei reicht), die auf Ihr Projekt zeigt.
- Schließen Sie den Checkout über MakePay ab.
- Öffnen Sie den Reiter Transaktionen. Wenn der Status der neuen Zeile succeeded erreicht, funktionieren Ihre Schlüssel und der Webhook beide von Ende zu Ende.
Schalten Sie den Testmodus aus, wenn Sie für echte Zahlungen bereit sind.
Fehlerbehebung
Beginnen Sie mit dem Dashboard: Bestätigen Sie, dass die MakePay-Karte als verbunden angezeigt wird und dass die Webhook-URL mit der Callback-Destination in MakePay übereinstimmt.
Zahlung wird abgeschlossen, aber die Bestellung bleibt ausstehend.
Der Webhook kommt nicht an oder wird nicht verifiziert. Bestätigen Sie, dass die Callback-URL in MakePay Ihrer Projekt-Webhook-URL genau entspricht und dass das Webhook Secret in Coin Moebius mit dem Signing Secret in MakePay übereinstimmt.
Das Speichern des Anbieters wird abgelehnt.
Die API Key ID, das API Key Secret und das Webhook Secret sind alle erforderlich. Kopieren Sie sie erneut aus MakePay — das Secret wird nur einmal angezeigt, erzeugen Sie einen neuen Schlüssel, wenn Sie es nicht mehr haben.
Eine Test-Bestellung erscheint nie in den Transaktionen.
Schalten Sie den Testmodus-Schalter für die MakePay-Karte ein, bevor Sie den Buy-Button starten, und stellen Sie sicher, dass das Produkt auf dasselbe Projekt zeigt.
Gut zu wissen
Kein Custody (Non-custodial). MakePay überweist Krypto direkt auf Ihr eigenes Wallet. Coin Moebius hält die Gelder nie und kann sie nicht bewegen.
Secrets rotieren. Erzeugen Sie jederzeit einen neuen API Key oder generieren Sie das Webhook Signing Secret neu, wählen Sie dann Ersetzen im Dashboard und fügen Sie den neuen Wert ein. Geheime Felder bleiben beim Bearbeiten leer.
Fragen? Join our Discord