Verfügbare Integration · Hutko
Hutko-Zahlungen ohne manuelle Dateneingabe verfolgen
Verfügbar
Nach jeder Zahlung erfasst das CRM das Ergebnis, benachrichtigt Ihr Team und ordnet die Zahlung entweder einer vorhandenen Bestellung zu oder hält sie in einer übersichtlichen Abgleichswarteschlange bereit.
Hutko-Ereignis
SHA1 verifiziert · Bestellung zugeordnet
- Bestellung
- SHOP-2048
- Betrag
- 5 000.00 UAH
- Zahlungseintrag
- bezahlt
Das CRM erfasst das signierte Ergebnis von Hutko. Die Zahlungsabwicklung bleibt bei Hutko.
So wird eine Zahlung erfasst
Signierter Callback
Hutko sendet das Zahlungsergebnis per POST an die eindeutige URL, die für Ihre Integration erzeugt wurde.
Händlerprüfung
Die merchant_id des Callbacks muss mit dem konfigurierten Hutko-Händler übereinstimmen.
Zahlungseintrag
Das CRM speichert den abgerechneten Betrag und die Währung im Zahlungsjournal und erfindet niemals allein aus einer Zahlung eine Bestellung.
Abgleich
Eine vorhandene, vollständig gedeckte Bestellung kann auf „Bestätigt“ wechseln; eine nicht zugeordnete Zahlung bleibt im Journal.
Technischer Vertrag
- CRM-Endpoint
- POST /api/v1/adapters/hutko/{configId}
- Zugangsdaten
- {"merchantId":"1703986","password":"..."}
- Signatur
- SHA1 über sortierte, nicht leere Callback-Felder mit dem Händlerpasswort
- Gespeicherte Daten
- Bestellung, Zahlungsstatus, Betrag, Währung, Anbieter-IDs, optional E-Mail/Telefon des Käufers
Sicherheitsmodell
- Lehnt Callbacks für eine andere merchant_id ab
- Lehnt nicht signierte oder falsch signierte Payloads ab
- Speichert weder PAN noch CVV oder rohe Kartentokens
- Schwärzt sensible Hutko-Metadaten, bevor Diagnosedaten gespeichert werden
- Eine optionale lokale Prüfung validiert gespeicherte Angaben und die Signatur, ohne eine Zahlung zu erstellen
Das CRM erfasst das Ergebnis; es steuert die Zahlung nicht
Das CRM empfängt die Status „erstellt“, „in Bearbeitung“, „genehmigt“, „abgelehnt“, „abgelaufen“ und „rückgängig gemacht“ und erfasst den abgerechneten Betrag samt Währung. Stimmt order_id mit einer vorhandenen Bestellung überein, wird die Zahlung ihr zugeordnet; ohne Übereinstimmung bleibt sie unter Commerce → Zahlungen zum Abgleich. Die Integration erstellt keine Bestellungen und bucht niemals Geld ab oder erstattet es. Ein Hutko-Zahlungslink wird in der Bestellkarte über die Schaltfläche „Zahlungslink“ erstellt. Außerdem speichert sie niemals PAN, CVV oder Kartentokens.
Einrichtung
- 01
Hutko-Adapter erstellen
Wählen Sie unter Einstellungen → Integrationen → Plattform-Adapter Hutko, geben Sie die Merchant-ID und den Zahlungsschlüssel in getrennten Feldern ein und klicken Sie dann auf „Erstellen“.
- 02
URL im Hutko-Portal einfügen
Für alle Händlerzahlungen: Händlereinstellungen → Zahlungseinstellungen → Server-Callback-URL. Für einen einzelnen Link: Zahlungslösungen → Zahlungslinks → Erweiterte Funktionen → Server-Callback-URL. Der Wert am Link überschreibt den Standardwert des Händlers.
- 03
Oder die URL über die API übergeben
Wenn Ihre Website oder Ihr Backend den Checkout erstellt, übergeben Sie die erzeugte URL in jeder Anfrage als server_callback_url.
- 04
Kontrollzahlung durchführen
Die lokale Verbindungsprüfung ist optional. Um Ihre eigene Einrichtung im Hutko-Portal zu überprüfen, zahlen Sie mit einer neuen order_id und prüfen Sie Commerce → Zahlungen; um die Zahlung einer vorhandenen Bestellung zuzuordnen, übergeben Sie deren externalId.
Häufig gestellte Fragen
- Ist das dieselbe Hutko-Integration, die für Obriym-Abonnements verwendet wird?
- Nein. Diese Integration dient den Zahlungen Ihrer Kunden. Die Abrechnung der Obriym-Abonnements ist davon getrennt und vermischt sich nie mit Ihrem Zahlungsjournal.
- Werden hier wiederkehrende Zahlungen verwaltet?
- Nein. Die Integration erfasst nur Zahlungsergebnisse. Checkout, Abbuchungen, Rückerstattungen und wiederkehrende Zahlungen verbleiben bei Hutko.
- Was geschieht, wenn Hutko die E-Mail-Adresse des Käufers nicht sendet?
- Die Zahlung wird trotzdem erfasst. E-Mail-Adresse oder Telefonnummer des Käufers werden nur gespeichert, wenn Hutko sie tatsächlich sendet; die sichere Diagnose zeigt nur, ob diese Felder vorhanden waren, niemals ihre Werte.
- Erstellt ein Callback eine Bestellung?
- Nein. Stimmt order_id mit der externalId einer vorhandenen Bestellung überein, wird die Zahlung ihr zugeordnet. Andernfalls wird sie separat für den Abgleich gespeichert.
- Wo finde ich das Callback-Feld im Hutko-Portal?
- Global: Händlereinstellungen → Zahlungseinstellungen → Server-Callback-URL. Öffnen Sie für einen einzelnen Zahlungslink dessen erweiterte Funktionen; die dortige URL überschreibt den Wert auf Händlerebene.
Hutko-Zahlungsstatus verbinden
Bestätigte Hutko-Zahlungen erfassen und mit Bestellungen abgleichen – ohne Duplikate.