Webhooks empfangen

Sie können die Adressen für den Versand von Benachrichtigungen über eingegangene Zahlungen auf der Einstellungsseite des Projekts konfigurieren.

Bitte beachten Sie, dass beim Senden eines Webhooks folgende Antwort zurückgegeben werden muss:

json

{
  "success": true
}

Andernfalls wird der Dienst weiterhin versuchen, den Webhook zu senden. Die maximale Anzahl der Versuche beträgt 30.

Beispiel für einen Webhook über eine eingegangene Zahlung:

json

{
  "amount": "2.395", - Zahlungsbetrag in USD
  "created_at": "2025-03-17T12:57:52.449795Z", - Zeitpunkt der Zahlungserstellung
  "paid_at": "2025-03-17T12:57:19Z",- Zeitpunkt der Zahlungsdurchführung
  "status": "completed", - Zahlungsstatus
  "transactions": {
    "amount": "0.02552778", - Zahlungsbetrag in Kryptowährung
    "amount_usd": "2.395", - Zahlungsbetrag in USD
    "bc_uniq_key": "0", - Transaktionsreihenfolge, besonders wichtig in BTC-ähnlichen Netzwerken; bc_uniq_key + tx_hash ergibt eine eindeutige Zahlung
    "blockchain": "litecoin", - Name der Blockchain
    "created_at": "2025-03-17T12:57:52.449795Z",- Zeitpunkt der Zahlungserstellung
    "currency": "LTC", - Kryptowährung
    "currency_id": "LTC.Litecoin", - Kryptowährungskennung
    "tx_hash": "2be41b0cad76bc5699c3da5d5a1d390f9fb4038e5bfe49aec3b675f9dd4515fd", - Transaktionshash
    "tx_id": "4bbc91fd-a950-4fd0-83f3-9f1c09a6b54f" - Transaktions-ID beim Händler
  },
  "type": "PaymentReceived",  - Webhook-Typ
  "wallet": {
    "id": "9a07b545-f99e-4f51-bf37-a84fcbe4df4d", - Interne Benutzer-ID
    "store_external_id": "1" - Externe Benutzer-ID
  }
}

Überprüfung der Idempotenz beim Empfang eines Webhooks

Beim Verarbeiten eingehender Webhooks muss die Idempotenz sichergestellt werden, um eine doppelte Verarbeitung desselben Ereignisses zu vermeiden. Verwenden Sie dazu zwei Felder:

tx_hash — die Hashsumme des Anforderungsinhalts oder Ereignisses;
bc_uniq_key — eine vom Absender des Webhooks bereitgestellte eindeutige Ereignis-ID.

Vor der Verarbeitung des Webhooks muss überprüft werden, dass die Kombination aus hash und uniq_key noch nicht verarbeitet wurde. Wenn ein solches Ereignis bereits aufgezeichnet wurde, sollte es als Duplikat ignoriert werden.

Webhooks empfangen ​

Überprüfung der Idempotenz beim Empfang eines Webhooks ​

Webhooks empfangen

Überprüfung der Idempotenz beim Empfang eines Webhooks