Maintenance Work Notice!

We will carry out maintenance work on this documentation on Thursday, 28.10.2021 between 1:30 pm and 2:30 pm CEST. During this time, this documentation will not be available to you. Thank you for your understanding.

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEWORK and version Dokumentation

Über Unified Barcode payment

Allgemeine Informationen über General information about Unified Barcode payment

Seitdem Alipay Spot Payment sowie Quick Pay von WeChat Pay in das Paygate integriert sind, gibt es 2 Schnittstellen für Barcode-Zahlungen. Um eine Zahlung auszulösen, muss der Händler den Kunden vorab fragen, welche Zahlungsmethode verwendet werden soll, Alipay oder WeChat Pay.

Um den Prozess auf der Händlerseite zu vereinfachen und dem Händler einen bequemen Ablauf von Barcode-Zahlungen mit dem Paygate anzubieten, kann eine einheitliche Schnittstelle für beide Barcode-Zahlungsarten verwendet werden. Basierend auf dem "Barcode" kamm vom Paygate erkannt werden, um welche Zahlungsmethode es sich handelt, und dann wird der Prozess an das entsprechende Schema weitergeleitet.

Page properties
Logo
Info
Excerpt

Seitdem Alipay Spot Payment sowie Quick Pay von WeChat Pay in das Paygate integriert sind, gibt es 2 Schnittstellen für Barcode-Zahlungen. Um eine Zahlung auszulösen, muss der Händler den Kunden vorab fragen, welche Zahlungsmethode verwendet werden soll, Alipay oder WeChat Pay.

TypZahlungen per eWallet

Diagramm zum Prozessablauf

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameProcessFlow
DisableCachingtrue
PageWithExcerptEN:Unified Barcode payment

Auf dieser Seite

Table of Contents
exclude(Auf dieser Seite|In diesem Abschnitt|On this page|In this section).*


Paygate-Schnittstelle

Multiexcerpt include
SpaceWithExcerptDEWORK
MultiExcerptNameDefinition
PageWithExcerptDefinition DE


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

Amountn..10M

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.

Currencya3MWährung, drei Zeichen DIN / ISO 4217
MACan64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

OrderDesc

ans..256

M

Name der Transaktion, der in der Transaktionsliste angezeigt wird

OrderDesc2ans..256OTransaktionshinweis

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop

BuyerIDCodeans..32MCVon der Alipay-App erzeugter Code. Er dient zur Identifikation des Nutzers.
TimeOutn..14OC

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.
GoodsCategoryan..32OC

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.
LimitboolOC

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.