Eine kurze Zusammenfassung der HissPay Händler-API. Die vollständige Referenz ist die offizielle Dokumentation v1.13.0 (2026-10-27), derzeit auf vereinfachtem Chinesisch veröffentlicht.
Die vollständige und aktuelle Integrationsdokumentation finden Sie unter https://mch.hisspay.com/docs/ (v1.13.0 · 2026-10-27, laufend aktualisiert). Diese Seite fasst sie nur zusammen; bei Abweichungen gilt die offizielle Dokumentation.
HissPay bietet Payin (Zahlungseingang von Ihren Kunden) und Payout (Auszahlung auf ein Empfängerkonto) per HTTPS POST mit JSON-Body. Produktions-Gateway: https://transaction.hisspay.com; Sandbox-Gateway: https://sandbox-api.hisspay.com.
| Vorgang | Pfad |
|---|---|
| Payin-Auftrag anlegen | POST /transaction/payin/v1/apply |
| Payin-Auftrag abfragen | POST /transaction/payin/v1/query |
| Payout-Auftrag anlegen | POST /transaction/payout/v1/apply |
| Payout-Auftrag abfragen | POST /transaction/payout/v1/query |
| Kontostand abfragen | POST /transaction/payout/v1/balance |
Währungen im Produktkatalog: AUD, EUR, GBP, INR, JPY, THB, USD, USDT. Ein Katalogeintrag ist keine Freischaltung: Produktcodes, Betragsbereiche und Gebühren für Ihr Konto erhalten Sie mit der Freischaltungsmitteilung.
Vor der Integration: Ihr Händlerkonto ist geprüft und aktiv; Sie haben im Händlerportal (mch.hisspay.com → App-Schlüssel) eine API-Anwendung angelegt und deren appId und appSecret erhalten; Payin- und Payout-Produkte sind vertraglich vereinbart; die öffentlichen ausgehenden IP-Adressen Ihres Servers stehen für Payouts auf der Whitelist; eine öffentliche HTTPS-Benachrichtigungs-URL ist vorhanden. Testen Sie zuerst vollständig in der Sandbox.
Jede Anfrage enthält die Header appId, timestamp (Unix-Millisekunden, höchstens 30 Sekunden Abweichung zur Plattformzeit), nonce (mindestens 10 Zeichen, nie wiederverwendet) und sign. sign ist der SHA-256 in Kleinbuchstaben-Hex über die Body-Felder plus appId, timestamp und nonce, nach Namen sortiert als key=value-Paare mit & verbunden, mit direkt angehängtem appSecret. Es ist kein HMAC. Senden Sie keine null-Werte und legen Sie das appSecret nie in Browser oder App ab.
POST /transaction/payin/v1/apply legt einen Payin-Auftrag an und liefert payUrl für den Zahler. Bestätigen Sie die Zahlung nur anhand einer verifizierten Benachrichtigung oder Abfrage, nie anhand der Rückkehrseite im Browser.
POST /transaction/payout/v1/apply arbeitet asynchron: code=0 bedeutet angenommen, nicht ausgezahlt. Zeitüberschreitung oder Code 500 bedeuten ein unbestätigtes Ergebnis: Fragen Sie zuerst den ursprünglichen Auftrag ab und folgen Sie den Regeln der vollständigen Dokumentation, bevor Sie erneut etwas einreichen.
USDT-Payin verwendet currency=USDT und einen von der Plattform vergebenen netzwerkspezifischen Produktcode; Beträge haben höchstens 4 Nachkommastellen. Das Ergebnis wird per Benachrichtigung oder Abfrage bestätigt.
Thailand (THB): Payin per PromptPay-QR und Payout per thailändischer Banküberweisung. Bankcodes für Payin: SCB, KBANK, KTB, BAY, GSB, TTB; für Payout: SCB, KBANK, KTB, BAY, GSB, TTB, BBL (die für Ihr Konto nutzbaren Banken stehen in der Freischaltungsmitteilung). Standardbereich pro Transaktion: 500.00–49999.00 THB.
POST /transaction/payin/v1/query und POST /transaction/payout/v1/query akzeptieren merchantOrderNo oder orderNo. Höchstens 5 Abfragen pro Sekunde und appId; fragen Sie alle 3–5 Sekunden mit Backoff ab.
POST /transaction/payout/v1/balance liefert je Währung balance (Buchsaldo), balanceActive (verfügbar) und balanceFreeze (gesperrt).
Die Plattform sendet per POST JSON an Ihre notifyUrl mit denselben vier Signatur-Headern. Prüfen Sie die Signatur, verarbeiten Sie idempotent pro Auftrag und antworten Sie exakt mit SUCCESS oder OK. Unbestätigte Benachrichtigungen werden begrenzt oft wiederholt.
Verwenden Sie payStatus zusammen mit paymentStatus und isFinal. payStatus=0 bei einer Payin-Abfrage bedeutet nicht, dass die Zahlung fehlgeschlagen ist.
code=0 bedeutet, dass der API-Aufruf erfolgreich war; das Zahlungsergebnis ist ein separater Auftragsstatus. Alle Fehlercodes und empfohlenen Maßnahmen stehen in der vollständigen Dokumentation.
Legen Sie einen Sandbox-Händler an, führen Sie das Quickstart-Paket und den 5-Minuten-Selbsttest aus dem Sandbox-Leitfaden aus und folgen Sie dann der Go-live-Checkliste.
Eröffnen Sie Ihr Konto online und erhalten Sie Testzugangsdaten sowie Produktcodes – nach erfolgreichem Sandbox-Test wechseln Sie mit einem Klick in die Produktivumgebung.
HissPay bietet Technologie für Zahlungsintegration, Auftragsverwaltung, Benachrichtigungen und Abgleich. Zahlungsabwicklung, Clearing und Abrechnung erfolgen durch das vertraglich gebundene lizenzierte Zahlungsinstitut. HissPay nimmt keine Transaktionsgelder entgegen, verwahrt sie nicht und wickelt sie nicht ab.
Die angezeigten Sätze bestehen aus den Bearbeitungsgebühren des lizenzierten Zahlungsinstituts und der Technologiegebühr von HissPay. Sie entfallen nicht vollständig auf HissPay. Aufteilung, Abrechnung und Bedingungen stehen in den unterzeichneten Händlerverträgen und im Gebührenverzeichnis.