Bereich Entwickler

Webhook-API-Dokumentation

Implementieren Sie inprimepay in jeder App, Plattform oder jedem Checkout mithilfe der Open-Source-API-Dokumentation. Senden Sie diese Seite an Ihren Entwickler.

Externes Zahlungsgateway: „Mit InPrimePay bezahlen“
Kurzanleitung zur Integration über Hosted Checkout & Webhooks.
1
Linkkonfiguration

Leiten Sie den Endkunden zur sicheren Zahlungs-URL weiter. Die Daten werden zur Integration über eine Abfragezeichenfolge übergeben. Low-Code schnell und sicher.

Basis-URL: https://app.inprimepay.com/#/cp1/{MERCHANT_ID}

Abfrageparameter:
  • BetragBetrag z.B. 198.50. Sofern angegeben, wird das entsprechende Feld in der Zahlungsschnittstelle vorausgefüllt und deaktiviert (vom Benutzer nicht bearbeitbar).
  • NameName/Firmenname des Kunden, z. B. Mario Rossi. Sofern angegeben, wird das entsprechende Feld in der Benutzeroberfläche vorausgefüllt und deaktiviert (vom Benutzer nicht bearbeitbar).
  • Beschreibung: Kausal z.B. Rechnung Nr. %123. Das Feld „Grund“ ist vorab ausgefüllt (vom Benutzer bearbeitbar).
  • tippeZahlungsart zur Vorausauswahl: Jetzt bezahlen (Jetzt bezahlen), Raten (Installationen), Abonnement (Abonnement).
  • Callback-URLURL für die Webhook-Benachrichtigung (POST). Muss URL-codiert sein.
Beispiel für einen vollständigen Link:
https://app.inprimepay.com/#/cp1/24718?amount=150.00&name=Mario%20Rossi&description=Fattura%20%23123&type=installments&callback_url=https%3A%2F%2Fapi.tuo-sito.it%2Fcallback
2
Zahlungsbenachrichtigung (Webhook)

Nach Abschluss der Transaktion sendet unser Server eine Benachrichtigung. jetzt lesen asynchron zu Ihrem Endpunkt.

{ "event": "payment_succeeded", "chargeId": "pj_3Pabc...", "amount": 198.50, "currency": "eur", "status": "success", "merchant": "Mario Rossi", "timestamp": "2024-05-13T10:35:42Z", "paymentMethod": "Visa •••• 4242" }
3
Stärken
Maximale Sicherheit: PCI-DSS Level 1-Konformität.
Mehrere Methoden: Karten, Klarna, Satispay.
Geschwindigkeit: Die Integration kann in wenigen Minuten abgeschlossen werden.
Verlässlichkeit: 99.9 % Verfügbarkeit garantiert.
4
Voraussetzungen für den Start

Zur Durchführung der Aktivierung muss der Partner Folgendes bereitstellen:

  • Die URL des Webhooks, z.B. https://api.vostrosito.it/callback/payments