Erfolgreiche Bezahlung der Bestellung (ohne Zahlungs- und Transaktionsdetails)Webhook POST
Xsolla sendet den Webhook order_paid an die angegebene URL, wenn
die folgenden Bedingungen erfüllt sind:
- Der Benutzer hat die Bestellung erfolgreich bezahlt.
- Xsolla hat eine Antwort über die erfolgreiche Verarbeitung des Webhooks Zahlung erhalten.
Der Webhook order_paid enthält Informationen zu den gekauften
Artikeln und Transaktionsdetails.
Der Webhook order_paid wird nicht gesendet, wenn:
- die Zahlung nicht erfolgreich war, zum Beispiel:
- die Zahlungsmaske geöffnet wurde, aber der Benutzer die Bestellung nicht bezahlt hat
- die Zahlungsmaske geöffnet wurde, aber während der Zahlung Fehler auftraten
- die Antwort über die erfolgreiche Verarbeitung des Webhooks Zahlung nicht eingegangen ist.
Es wird empfohlen, den Webhook order_paid in weniger als drei
Sekunden zu verarbeiten.
Die erwarteten Antworten sind im Abschnitt Antworten beschrieben. Sie können andere Antwortcodes verwenden. Abhängig vom Antwortcode und je nachdem, ob die automatische Zahlungserstattung aktiviert ist oder nicht, sieht die Webhook-Verarbeitungslogik aufseiten von Xsolla wie folgt aus:
| Antwortcode | Automatische Zahlungserstattung ist deaktiviert (standardmäßig) | Automatische Zahlungserstattung ist aktiviert |
|---|---|---|
400, 401, 402, 403, 404, 409, 422, 415 |
Keine Aktionen | Benutzer erhält automatische eine Erstattung |
200, 201, 204 |
Keine Aktionen | Keine Aktionen |
| Anderer Code oder keine Antwort auf Webhook | Mehrere Webhooks werden innerhalb eines bestimmten Zeitintervalls gesendet: Zwei Versuche im Abstand von 5 Minuten, sieben Versuche im Abstand von jeweils 15 Minuten, zehn Versuche im Abstand von jeweils 60 Minuten. | Mehrere Webhooks werden innerhalb eines bestimmten Zeitintervalls gesendet: Zwei Versuche im Abstand von 5 Minuten, sieben Versuche im Abstand von jeweils 15 Minuten, zehn Versuche im Abstand von jeweils 60 Minuten. Wurden alle Webhooks gesendet, ohne eine erfolgreiche Antwort erhalten zu haben, wird dem Benutzer automatisch eine Erstattung ausgestellt. |
Wenden Sie sich an Ihre Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, um die automatische Erstattungsfunktion zu verknüpfen.
Request Body schema: application/json
| notification_type required | string Benachrichtigungstyp. | ||||||||||||||||||||||||||||||||||||||
required | Array of Version = 1 (object) or Version = 2 (object) Liste der vom Nutzer gekauften Artikel. Die im Array enthaltenen Parameter hängen von der Webhook-Version ab. In
Version 2 sind zusätzliche Parameter enthalten: | ||||||||||||||||||||||||||||||||||||||
Array One of: | |||||||||||||||||||||||||||||||||||||||
required | object Bestellinformationen. | ||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
required | object Benutzerinformationen. | ||||||||||||||||||||||||||||||||||||||
| custom_parameters | object Zusätzliche Informationen. | ||||||||||||||||||||||||||||||||||||||
Zur Signalisierung einer erfolgreiche Verarbeitung.
Im Falle eines Fehlers in den bereitgestellten Daten (z. B. fehlender erforderlicher Parameter, fehlgeschlagene Autorisierung usw.).
- CURL
- HTTP
curl -v 'https://your.hostname/your/uri' \ -X POST \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -H 'Authorization: Signature d09695066c52c1b8bdae92f2d6eb59f5b5f89843' \ -d '{ "notification_type": "order_paid", "items": [ { "sku": "com.xsolla.v.item_1", "type": "virtual_good", "is_pre_order": false, "quantity": 3, "amount": "1000", "promotions": [ { "amount_without_discount": "6000", "amount_with_discount": "5000", "sequence": 1 }, { "amount_without_discount": "5000", "amount_with_discount": "4000", "sequence": 2 } ], "custom_attributes": { "purchased": 0, "attr": "value" } }, { "sku": "com.xsolla.v.item_new_1", "type": "bundle", "is_pre_order": false, "quantity": 1, "amount": "1000", "promotions": [] }, { "sku": "com.xsolla.gold_1", "type": "virtual_currency", "is_pre_order": false, "quantity": 1500, "amount": "[null]", "promotions": [] } ], "order": { "id": 1, "mode": "default", "currency_type": "virtual", "currency": "sku_currency", "amount": "2000", "status": "paid", "platform": "xsolla", "comment": null, "invoice_id": "1", "promotions": [ { "amount_without_discount": "4000", "amount_with_discount": "2000", "sequence": 1 } ], "promocodes": [ { "code": "promocode_some_code", "external_id": "promocode_sku" } ], "coupons": [ { "code": "WINTER2021", "external_id": "coupon_sku" } ] }, "user": { "external_id": "id_xsolla_login_1", "email": "gc_user@xsolla.com" } }'