Gehosteten Checkout einrichten.
Beginnen Sie mit der Händler-ID-URL und fügen Sie die erforderlichen Abfrageparameter hinzu.
https://app.inprimepay.com/
#/cpl/{MERCHANT_ID}
?amount=150.00
&name=Cliente%20S.p.A.
&type=installments
Integrieren Sie „Pay with Inprimepay“ über Hosted Checkout, Query-Strings, serverseitige Generierung benutzerdefinierter Zahlungslinks und POST-Webhooks. Sie können den Checkout vorab ausfüllen, ein Echtzeit-Token generieren und Benachrichtigungen mit HMAC-SHA256-Signaturen validieren.
const Kasse = "https://app.inprimepay.com/#/cpl/{MERCHANT_ID}" + "?amount=150.00" + "&name=Customer%20S.pA" + "&description=Rechnung%20%23001" + "&type=installments" + "&callback_url=https%3A%2F%2Fmerchant-site.com%2Fcallback"window.location.href = checkout;
Die Dokumentation bietet zwei sich ergänzende Modi: eine Low-Code-Integration auf Basis von Hosted Checkout URLs und eine dynamische Server-zu-Server-Generierung über OpenAPI.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}.pay_now, installments o subscription.callback_url kann benutzerdefinierte Parameter enthalten, wie zum Beispiel order_id o reference.X-Api-Key.X-InPrimePay-Signature.Richten Sie Hosted Checkout ein, generieren Sie bei Bedarf einen benutzerdefinierten Zahlungslink von Ihrem Server und erhalten Sie asynchrone Transaktionsbenachrichtigungen.
Beginnen Sie mit der Händler-ID-URL und fügen Sie die erforderlichen Abfrageparameter hinzu.
https://app.inprimepay.com/
#/cpl/{MERCHANT_ID}
?amount=150.00
&name=Cliente%20S.p.A.
&type=installments
Senden Sie einen POST-Request an den OpenAPI-Endpunkt und verwenden Sie dabei Ihr Webhook-Geheimnis im X-Api-Key-Header.
POST /api/custom-payment-links/ openapi/generate X-Api-Key: {WEBHOOK_SECRET} Content-Type: application/json
Nach Abschluss der Zahlung erhalten Sie einen POST-Request mit dem Ereignis payment.succeeded und einer HMAC-SHA256-Signatur.
Ereignis: Zahlung erfolgreich, Header: X-InPrimePay-Signatur
Leiten Sie Ihre Kunden auf Ihre sichere Zahlungs-URL weiter und übergeben Sie Daten über Abfragezeichenfolgen für eine schnelle Integration mit geringem Codeaufwand.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}
amount100.50Falls angegeben, wird das entsprechende Feld vorausgefüllt und deaktiviert.
nameCliente%20S.p.A.Falls angegeben, wird das Feld vorausgefüllt und deaktiviert.
descriptionFattura%20%23A12Der Grund wird vorab eingetragen, kann aber vom Benutzer noch geändert werden.
typepay_now, installments oder subscription.
callback_url?order_id=12345
o reference: werden automatisch extrahiert und in der Webhook-Nutzlast zurückgegeben.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}?amount=150.00&name=Cliente%20S.p.A.&description=Fattura%20%23001&type=installments&callback_url=https%3A%2F%2Fmerchant-site.com%2Fcallback
Für jede neue Bestellung können Sie den OpenAPI-Endpunkt verwenden. Die Authentifizierung erfolgt über Ihr Webhook-Geheimnis, das Sie in Ihrem Plattformprofil finden.
POST https://api.inprimepay.com/api/custom-payment-links/openapi/generate
application/json
99.00.
X-API-Schlüssel: {WEBHOOK_SECRET} Content-Type: Anwendung / Json { "Menge": 99.00, "ClientName": "Client SpA", „Beschreibung“: „Premium-Service erwerben“ }
{
"Zeichen":
"d7a8e2b1-4f4c-11eb-ae93-0242ac130002"
}
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}?token=d7a8e2b1-4f4c-...&callback_url=https%3A%2F%2Fmerchant-site.com%2Fcallback%3Forder_id%3D12345
Nach Abschluss der Transaktion sendet der Inprimepay-Server eine asynchrone POST-Benachrichtigung an den im Callback angegebenen Endpunkt.
payment.succeeded.
eventId, chargeId, sessionId, customerId e orderId.
callback_urlals order_id, kann in der Nutzlast zurückgegeben werden.
{
"Ereignis": "Zahlung erfolgreich",
"eventId": "a1b2c3d4-e5f6-7890-1234-56789abcdef0",
„Zeitstempel“: 1696772400,
"chargeId": 14592,
"sessionId": "cs_test_a1b2c3d4...",
"Kunden-ID": "{MERCHANT_ID}",
"Bestellnummer": "12345",
"Menge": 100.50,
"Währung": "eur",
"Status": "Erfolg",
"Händler": "InPrime Pay",
"originalTimestamp": "2024-05-13T10:35:42Z",
"Zahlungsmethode": "Karte"
}
Um zu überprüfen, ob die POST-Benachrichtigung tatsächlich von den Inprimepay-Servern stammt, enthält die Anfrage eine Validierungssignatur.
X-InPrimePay-Signature
chargeId Es wird im Leitfaden als einzigartig und stabil bezeichnet.
Der beigefügte technische Leitfaden beschreibt Sicherheit, verfügbare Methoden, Integrationsgeschwindigkeit und Zuverlässigkeit der Infrastruktur.
Der Hosted Checkout + Webhook-Ablauf kann über mehrere digitale und stationäre Touchpoints hinweg genutzt werden, ohne dass die Integrationslogik geändert werden muss.
Generieren Sie einen Checkout direkt aus Ihrer ERP-, CRM- oder Branchensoftware und erfassen Sie das Ergebnis per Webhook in Ihrem Workflow.
Verknüpfen Sie die Zahlungsabwicklung mit einem Antragsprozess und behalten Sie gleichzeitig die Checkout-Oberfläche in der Inprimepay-Umgebung bei.
Integrieren Sie Sofortzahlung, Ratenzahlung und Abonnements in einen eigenen Checkout, ohne die Zahlungsseite selbst erstellen zu müssen.
Zahlungen können über Kioske, Touchscreens und andere physische Zahlungsströme, die mit Softwaresystemen verbunden sind, generiert werden.
Erstellen Sie einen Checkout, bei dem Betrag und Grund bereits festgelegt sind, und leiten Sie den Kunden von einem Shop-Touchpoint zur Zahlung weiter.
Verwenden Sie den Typ subscription in Zahlungsabläufen, bei denen die Händler- und Anbieterkonfiguration wiederkehrende Zahlungen unterstützt.
https://api.vostrosito.it/callback/payments.
X-Api-Key und für die HMAC-Validierung der Webhook-Signatur.
Die wichtigsten Antworten zur Integration, einschließlich der im Partner Technical Guide ergänzten Details.
Der Inprimepay API-Plan wird kostenlos angeboten. Gebühren für die genutzten Dienste und Zahlungsanbieter fallen jedoch weiterhin an.
Nein. Die Integration nutzt einen Inprimepay Hosted Checkout: Ihr System erstellt den Link und leitet den Kunden zur Zahlungs-URL weiter.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}.
Ja. Die Parameter amount e name Sie können über Abfragezeichenfolgen übergeben werden und werden, falls vorhanden, vorkompiliert und unveränderlich gemacht.
Die Dokumentation umfasst pay_now,
installments e subscriptionDie tatsächliche Verfügbarkeit der jeweiligen Zahlungsmethoden hängt von den vom Händler aktivierten Diensten ab.
Ja. Das steht so in der Anleitung. callback_url kann benutzerdefinierte Parameter enthalten, wie zum Beispiel order_id o reference; werden automatisch extrahiert und in der Webhook-Nutzlast zurückgegeben.
Erstelle einen Beitrag auf
https://api.inprimepay.com/api/custom-payment-links/openapi/generate
Verwendung des Webhook-Geheimnisses im Header X-Api-Key e
Content-Type: application/json.
amount e clientName sind als obligatorisch gekennzeichnet;
description Dies ist optional. Die Antwort enthält ein eindeutiges Token.
Übergabe eines callback_url Der Inprimepay-Server sendet nach Abschluss einer Transaktion eine asynchrone POST-Webhook-Benachrichtigung. Das im Leitfaden angegebene Ereignis ist payment.succeeded.
Berechnen Sie den HMAC-SHA256-Hash des rohen JSON-Anfragetextes mithilfe Ihres Webhook-Geheimnisses und vergleichen Sie das Hexadezimalergebnis mit dem Header.
X-InPrimePay-Signature.
Ja. Im Partner-Technikleitfaden ist Folgendes vermerkt: chargeId
Es ist einzigartig und stabil.
Ja. Das Hosted-Checkout- + Webhook-Modell eignet sich auch für Managementsysteme, Anwendungen, Plattformen, kundenspezifische E-Commerce-Lösungen und Einzelhandelsprozesse.
Hosted Checkout, Abfrageparameter, Server-zu-Server-Generierung, Tokens, POST-Webhooks und HMAC-SHA256-Validierung sind verfügbar. Technischer Support: assistenza@inprimepay.com.
