Implementation
Sicherheit
Um Sicherheit zu gewährleisten, verwendet Xsolla:
Hinweis
API-Schlüssel werden von Xsolla generiert und sind für jeden Anbieter einzigartig.
Headers
Eingehende Anfragen von Xsolla enthalten die folgenden Header:
| Header | Beschreibung | Erforderlich |
|---|---|---|
Request-Id | Eindeutige Anfrage-ID. | Ja. |
Content-Digest | Prüfsummenwerte für den Anfragetext. | Ja, wenn es einen Anfragerumpf gibt. |
Signature-Input | Parameter, die zur Generierung der Signatur verwendet werden. | Ja. |
Signature | Signatur anfordern. | Ja. |
Prefer | Zusätzliche Daten, z. B., environment=“sandbox”. | Nein. |
Hinweis
Sie müssen die gleichen Header in den Webhooks, die Sie Xsolla übermitteln, einfügen.
Verifizierung eingehender Anfragen
Wenn Sie eine Anfrage von Xsolla erhalten:
- Extrahieren Sie den geheimen Schlüssel, der dem
keyid-Wert aus demSignature-Input-Header entspricht. - Validieren Sie das
created/expires-Zeitfenster. - Rufen Sie den Anfragerumpf auf.
- Rekonstruieren Sie den Signatur-String gemäß
Signature-Inputund überprüfen Sie die Signatur mit HMAC-SHA256.
Copy
- http
1sig1=("@method" "@target-uri" "content-digest" "request-id");alg="hmac-sha256";created=1700000000;expires=1700000600;keyid="acc_123"
- Verwenden Sie
Request-Id, um nach der Anfrage in den Log-Dateien zu suchen.
Erforderliche Funktionalität
Für eine erfolgreiche Integration müssen Sie mindestens die folgenden API-Methoden implementieren:
| Methode | Pfad | Beschreibung |
|---|---|---|
| POST | /v1/payments | Erstellt Zahlung. Gibt das action-Objekt zurück. |
| PATCH | /v1/payments/{transaction_id} | Bestätigt die Zahlung, wenn action.type=confirm zurückgegeben wurde. |
| GET | /v1/payments/{transaction_id} | Ruft den aktuellen Zahlungsstatus ab. |
payment.succeeded- Zahlung erfolgreichpayment.failed- Zahlung fehlgeschlagenpayment.refunded- Erstattung
Hinweis
Eine ausführliche Beschreibung von API-Methoden und Webhooks finden Sie in der Spezifikation.
War dieser Artikel hilfreich?
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.
