Paygate-Schnittstelle
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Aufruf der Schnittstelle
Um eine Zahlung mit Unified Barcode payment über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.
Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter | Format | CND | Beschreibung |
---|---|---|---|
MerchantID | ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
TransID | ans..64 | M | TransaktionsID, die für jede Zahlung eindeutig sein muss |
RefNr | ans..30 | O | eindeutige Referenznummer |
Amount | n..10 | M | Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. |
Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217 |
MAC | an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus |
OrderDesc | ans..256 | M | Name der Transaktion, der in der Transaktionsliste angezeigt wird |
OrderDesc2 | ans..256 | O | Transaktionshinweis |
UserData | ans..1024 | O | Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop |
BuyerIDCode | ans..32 | MC | Von der Alipay-App erzeugter Code. Er dient zur Identifikation des Nutzers. |
TimeOut | n..14 | OC | Nur für WeChat: Zeitlimit für eine Transaktion. Einheit: Minuten. Mindestens 1 Minute. Optionaler Parameter von WeChat Pay: wird berücksichtigt, wenn es eine Zahlung mit WeChat Pay ist. |
GoodsCategory | an..32 | OC | Nur für WeChat: Product category. Meaning at WeChat Pay: Intended purpose on discount coupon. Optionaler Parameter vonWeChat Pay: wird berücksichtigt, wenn es eine Zahlung mit WeChat Pay ist. |
Limit | bool | OC | Nur für WeChat: If true, credit cards won't be accepted in the payment, otherwise credit cards will be accepted. Optionaler Parameter von WeChat Pay: wird berücksichtigt, wenn es eine Zahlung mit WeChat Pay ist. |
Parameter für Zahlungen mit Unified Barcode payment
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:
Parameter | Format | CND | Description |
---|---|---|---|
MID | ans..30 | M | HändlerID, die von Computop vergeben wird |
PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien |
XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
TransID | ans..64 | M | Transaktionsnummer des Händlers |
RefNr | ns..30 | O | Eindeutige Referenznummer |
Status | a..50 | M | OK, FAILED oder AUTHORIZE_REQUEST (Falls kein finaler Status von Alipay existiert. Kunden müssen die Zahlung eventuell in der App mit ihrem Kennwort bestätigen.) |
Description | ans..1024 | M | Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus! |
Code | n8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
UserData | ans..1024 | O | Wenn beim Aufruf angegeben, übergibt das Paygate den Parameter mit dem Zahlungsergebnis an den Shop |
CodeExt | ans..40 | OC | Nur für WeChat: Fehlercode von WeChat. Bei einer Zahlung mit Alipay nicht enthalten. |
ErrorText | ans..256 | O | Fehlertext vom nachgelagerten System, nur wenn mit dem Computop Support abgesprochen (in MAT konfiguriert). |
TID | ans..64 | OC | Only for Alipay: TransactionID generated by Alipay system. Bei einer Zahlung mit WeChat Pay Alipay nicht enthalten. |
Ergebnis-Parameter für Zahlungen mit Unified Barcode payment
Gutschrift / Storno
Gutschriften mit Referenz sowie Stornierungen hängen vom gewählten Zahlungssystem Alipay oder WeChat Pay ab. Zur Verarbeitung solcher nachfolgenden Transaktionen sehen Sie bitte in den jeweiligen Handbüchern für Alipay oder WeChat Pay nach.