Über Bluecode

Allgemeine Informationen über Bluecode

Was ist Bluecode?

Bluecode ist die erste gesamteuropäische mobile Zahlungslösung, die bargeldlose Zahlungen per Android-Smartphone, iPhone und Apple Watch auf einer einheitlichen technologischen Plattform mit Mehrwertdiensten verbindet. Gemäß der europäischen Datenschutzgesetze werden mit den beteiligten Banken oder Händlern niemals persönliche Daten ausgetauscht und somit auch beim Zahlungsvorgang nicht übertragen oder auf dem Mobiltelefon gespeichert. Das sehr sichere auf TAN basierende Zahlungssystem funktioniert mit allen Girokonten und ist unabhängig von der Übertragungstechnologie (Barcode, QR-Code, Bluetooth).

Bluecode startete 2017 in Österreich. Seit 2018 profitieren auch Alipay-Nutzer von einer Kooperation zwischen Bluecode und Alipay. Die Expansion auf den deutschen Markt erfolgte im gleichen Jahr.

Wie verknüpfen Kunden Bluecode mit ihrem Bankkonto?

Bei Bluecode gibt es zwei Wege, wie App-Nutzer ihr Bankkonto verknüpfen können:

Bei den Partnerbanken können sie sich sofort und direkt in ihrer Bank-App oder bei Online-Banking registrieren. Diese Registrierung ist besonders schnell und bei allen Bluecode-Partnerbanken möglich.
Bei allen anderen Banken können sie sich mit einem SEPA-Lastschriftvorgang registrieren. Das Lastschriftmandat wird gespeichert und die Zahlung von SIX Payment Services Ltd verarbeitet. SIX ist ein von der Finanzmarktaufsicht testiertes Unternehmen und einer der größten Abwickler von Lastschriften in den deutschsprachigen Ländern.

Gibt es Zahlungslimits beim Bezahlen mit Bluecode?

Aus Sicherheitsgründen begrenzt Bluecode die Anzahl der Zahlungen auf vier pro Stunde und zehn Zahlungen pro Tag bei einem Transaktionslimit von 400€. Dieses ist abhängig vom Issuer (Bank des Endkunden) und kann ggf. abweichen.

Wie funktioniert die Bluecode QR-Code-Zahlung?

Die Bluecode QR-Code-Zahlung ist eine Variante der E-Commerce-Zahlung. Das Kassensystem (Shop des Händlers) erzeugt einen QR-Code mit den Zahlungsdaten, indem es die Bluecode-API über das Paygate aufruft. Dann scannt der Kunde den QR-Code mit seinem Mobilgerät, um die Zahlung abzuschließen.

Logo
Info	Bluecode ist die erste gesamteuropäische mobile Zahlungslösung, die bargeldlose Zahlungen per Android-Smartphone, iPhone und Apple Watch auf einer einheitlichen technologischen Plattform mit Mehrwertdiensten verbindet. Gemäß der europäischen Datenschutzgesetze werden mit den beteiligten Banken oder Händlern niemals persönliche Daten ausgetauscht und somit auch beim Zahlungsvorgang nicht übertragen oder auf dem Mobiltelefon gespeichert. Das sehr sichere auf TAN basierende Zahlungssystem funktioniert mit allen Girokonten und ist unabhängig von der Übertragungstechnologie (Barcode, QR-Code, Bluetooth).
Typ	Zahlungen per eWallet

Weitere Informatiomnen finden Sie auch auf der Webseite von Bluecode (https://bluecode.com/de-de/b2b/haendler/, https://bluecode.com/en/b2b/merchants/).

Anwendungsfälle

Unterstützte Anwendungsfälle			Unterstützte Schnittstellen
Anwendungsfall	Beschreibung	Einfacher Prozess	S-2-S	Formular	Batch	Analytics PayByLink	HPP
Autorisierung + Buchung	Händler wollen eine Zahlung autorisieren und bei Lieferung buchen	nicht unterstützt verwenden Sie stattdessen "Sale", um eine Zahlung in einem Schritt zu autorisieren und zu buchen
Verkauf (Sale)	Händler möchten per Bluecode Geld von einem Kunden erhalten	Shop des Händlers startet eine Bluecode-Zahlungsanfrage und empfängt die URL zum QR-Code Kunde scannt den QR-Code mit der Bluecode-App Kunde bestätigt die Zahlung in der Bluecode-App Shop des Händlers erhält eine Benachrichtigung über die erfolgreiche Zahlung
Voll- oder Teilgutschrift	Händler möchten einen Geldbetrag an den Kunden zurückerstatten, nachdem eine Zahlung erfolgreich abgeschlossen ist	Händler startet eine Gutschriftsanfrage Computop erfasst die Bluecode-Details aus der betreffenden Zahlung und veranlasst die Bluecode-Gutschrift Shop des Händlers erhält eine Benachrichtigung über die erfolgreiche Gutschrift
Voll- oder Teilstorno	Händler wollen eine nicht abgeschlossene Zahlung stornieren	wird nur für Zahlungen unterstützt, die nicht abgeschlossen sind für abgeschlossene Zahlungen verwenden Sie stattdessen eine Gutschrift

Diagramme zum Prozessablauf

Sale, Client-to-Server

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjQ1NzgzODg2IiwiZGlhZ3JhbU5hbWUiOiJCbHVlY29kZSBTYWxlIEMyUyIsImFzcGVjdCI6IiIsImxpbmtzIjoiYXV0byIsImNlb05hbWUiOiJCbHVlY29kZSIsInRic3R5bGUiOiJ0b3AiLCJjYW5Db21tZW50IjpmYWxzZSwiZGlhZ3JhbVVybCI6IiIsImNzdkZpbGVVcmwiOiIiLCJib3JkZXIiOnRydWUsIm1heFNjYWxlIjoiMSIsIm93bmluZ1BhZ2VJZCI6MjYyNDczMjEsImVkaXRhYmxlIjpmYWxzZSwiY2VvSWQiOjI2MjQ3MzIxLCJwYWdlSWQiOiIiLCJsYm94Ijp0cnVlLCJzZXJ2ZXJDb25maWciOnsiZW1haWxwcmV2aWV3IjoiMSJ9LCJvZHJpdmVJZCI6IiIsInJldmlzaW9uIjowLCJtYWNyb0lkIjoiZGM2ZTQyMWQtMjdmNS00MWIyLWJkODMtNjA4Y2UzODdjNDEzIiwicHJldmlld05hbWUiOiJCbHVlY29kZSBTYWxlIEMyUy5wbmciLCJsaWNlbnNlU3RhdHVzIjoiT0siLCJzZXJ2aWNlIjoiIiwiaXNUZW1wbGF0ZSI6IiIsIndpZHRoIjoiMTEwOSIsInNpbXBsZVZpZXdlciI6ZmFsc2UsImxhc3RNb2RpZmllZCI6Ik1hciA3LCAyMDIyLCA0OjE5OjUxIFBNIiwiZXhjZWVkUGFnZVdpZHRoIjpmYWxzZSwib0NsaWVudElkIjoiIn0=

Sale, Server-to-Server

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjQ1NzgzODc4IiwiZGlhZ3JhbU5hbWUiOiJCbHVlY29kZSBTYWxlIFMyUyIsImFzcGVjdCI6IiIsImxpbmtzIjoiYXV0byIsImNlb05hbWUiOiJCbHVlY29kZSIsInRic3R5bGUiOiJ0b3AiLCJjYW5Db21tZW50IjpmYWxzZSwiZGlhZ3JhbVVybCI6IiIsImNzdkZpbGVVcmwiOiIiLCJib3JkZXIiOnRydWUsIm1heFNjYWxlIjoiMSIsIm93bmluZ1BhZ2VJZCI6MjYyNDczMjEsImVkaXRhYmxlIjpmYWxzZSwiY2VvSWQiOjI2MjQ3MzIxLCJwYWdlSWQiOiIiLCJsYm94Ijp0cnVlLCJzZXJ2ZXJDb25maWciOnsiZW1haWxwcmV2aWV3IjoiMSJ9LCJvZHJpdmVJZCI6IiIsInJldmlzaW9uIjowLCJtYWNyb0lkIjoiYzZjNDNhYmYtNWZhYS00MDhiLThhYzYtZmQ5NGY4MzJmZWM2IiwicHJldmlld05hbWUiOiJCbHVlY29kZSBTYWxlIFMyUy5wbmciLCJsaWNlbnNlU3RhdHVzIjoiT0siLCJzZXJ2aWNlIjoiIiwiaXNUZW1wbGF0ZSI6IiIsIndpZHRoIjoiMTEwOSIsInNpbXBsZVZpZXdlciI6ZmFsc2UsImxhc3RNb2RpZmllZCI6Ik1hciA4LCAyMDIyLCAxMjo1MzoxNyBBTSIsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9

Reversal / Credit, Server-to-Server

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjQ1NzgzODgyIiwiZGlhZ3JhbU5hbWUiOiJCbHVlY29kZSBDcmVkaXQgUzJTIiwiYXNwZWN0IjoiIiwibGlua3MiOiJhdXRvIiwiY2VvTmFtZSI6IkJsdWVjb2RlIiwidGJzdHlsZSI6InRvcCIsImNhbkNvbW1lbnQiOmZhbHNlLCJkaWFncmFtVXJsIjoiIiwiY3N2RmlsZVVybCI6IiIsImJvcmRlciI6dHJ1ZSwibWF4U2NhbGUiOiIxIiwib3duaW5nUGFnZUlkIjoyNjI0NzMyMSwiZWRpdGFibGUiOmZhbHNlLCJjZW9JZCI6MjYyNDczMjEsInBhZ2VJZCI6IiIsImxib3giOnRydWUsInNlcnZlckNvbmZpZyI6eyJlbWFpbHByZXZpZXciOiIxIn0sIm9kcml2ZUlkIjoiIiwicmV2aXNpb24iOjAsIm1hY3JvSWQiOiJiYTFmODgzNC0wZDQ0LTRhNDgtOGNlYi1mM2Y4NDUxYTkxNTgiLCJwcmV2aWV3TmFtZSI6IkJsdWVjb2RlIENyZWRpdCBTMlMucG5nIiwibGljZW5zZVN0YXR1cyI6Ik9LIiwic2VydmljZSI6IiIsImlzVGVtcGxhdGUiOiIiLCJ3aWR0aCI6IjExMDkiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOiJNYXIgOCwgMjAyMiwgMTI6MjI6MzAgQU0iLCJleGNlZWRQYWdlV2lkdGgiOmZhbHNlLCJvQ2xpZW50SWQiOiIifQ==

Auf dieser Seite

Paygate-Schnittstelle

Definitionen

Datenformate

Format	Beschreibung
a	alphabetisch
as	alphabetisch mit Sonderzeichen
n	numerisch
an	alphanumerisch
ans	alphanumerisch mit Sonderzeichen
ns	numerisch mit Sonderzeichen
bool	Bool’scher Ausdruck (true oder false)
3	feste Länge mit 3 Stellen/Zeichen
..3	variable Länge mit maximal 3 Stellen/Zeichen
enum	Aufzählung erlaubter Werte
dttm	ISODateTime (JJJJ-MM-TTThh:mm:ss)

Abkürzungen

Abkürzung	Beschreibung	Kommentar
CND	Bedingung (condition)
M	Pflicht (mandatory)	Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein
O	optional	Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich
C	bedingt (conditional)	Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist

Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.

Aufruf der Schnittstelle für eine Bluecode-Webseitenzahlung mit QR-Code (Verkauf)

Für Bluecode-Zahlungen sind Stornierungen und Gutschriften möglich, wie in den nachstehenden Kapiteln beschrieben ist. Im Batch-Modus sind nur Gutschriften möglich. Für Transaktionen an der Verkaufsstelle verwenden Sie bitte die Verbindung für Bluecode QR-Code-Zahlung.

Um eine Bluecode QR-Code-Zahlung per Weiterleitung zu einem Bluecode-Formular abzuwickeln, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/Bluecode.aspx

Um eine Bluecode QR-Code-Zahlung per Server-zu-Server-Verbindung abzuwickeln, verwenden Sie bitte folgende URL – Sie müssen die Bluecode-URL in einen QR-Code umwandeln:

https://www.computop-paygate.com/BluecodeS2S.aspx

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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	O	Reference which must be unique for each payment - if present; this value may be printed on the consumers bank account (depending on the consumers bank).	Eindeutige Referenznummer für jede Zahlung – falls vorhanden, kann dieser Wert auf dem Kontoauszug des Kunden gedruckt werden (je nach Bank des Kunden).

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	A3	M	Three digits DIN / ISO 4217. Currently only EUR is supported. Please find an overview here: A1 Currency table EN	Währung, drei Zeichen DIN / ISO 4217. Derzeit wird nur EUR unterstützt. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..26	O	An optional further identifier for this transaction. Assumed to be printed on customer receipt and used to identify the transaction given the slip. The format of this ID can be freely chosen by the caller and is not validated.	Ein optionaler weiterer Bezeichner für diese Transaktion. Soll auf dem Kundenbeleg gedruckt werden und die Transaktion auf dem Zettel identifizieren. Das Format dieser ID ist frei wählbar und wird nicht geprüft.
ShopURL	an..128	O	URL of web shop, for example: https://testmerchant.com	URL des Web-Shops, zum Beispiel: https://testmerchant.com

AccOwner	ans..50	M	Name of account holder	Name des Kontoinhabers
IBAN	an..34	O	IBAN of the user which appears predefined in the transfer window (only possible for DE)	IBAN des Nutzers, die voreingestellt im Überweisungsfenster erscheint (nur für DE möglich)
BIC	an..11	O	BIC of the user which appears predefined in the transfer window	BIC des Nutzers, die voreingestellt im Überweisungsfenster erscheint
AddrCountryCode	a2	M	Two characters country code according to ISO 3166. Presently DE, AT, BE, NL, ES, CH, PL, IT permitted.	Ländercode zweistellig gemäß ISO 3166. Derzeit DE, AT, BE, NL, ES, CH, PL, IT zulässig.
Language	a2	O	Language: de – German, en – English, fr – French, nl – Dutch, pl – Polish	Sprache: de – deutsch, en – Englisch, fr – Französisch, nl – Niederländisch, pl – Polnisch

Key	Format	CND	Description	Beschreibung
URLSuccess	ans..256	M	Complete URL which calls up Paygate if payment has been successful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData. Common notes: We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.	Vollständige URL, die das Paygate aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von Paygate zu erhalten Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key	Format	CND	Description	Beschreibung
URLFailure	ans..256	M	Complete URL which calls up Paygate if payment has been unsuccessful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData. Common notes: We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.	Vollständige URL, die das Paygateaufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von Paygate zu erhalten Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key	Format	CND	Description	Beschreibung
Response	a7	O	Status response sent by Paygate to URLSuccess and URLFailure, should be encrypted. For this purpose, transmit Response=encrypt parameter.	Die Status-Rückmeldung, die das Paygate an URLSuccess und URLFailure sendet, sollte verschlüsselt werden. Dazu übergeben Sie den Parameter Response=encrypt.

Key	Format	CND	Description	Beschreibung
URLNotify	ans..256	M	Complete URL which Paygate calls up in order to notify the shop about the payment result. The URL may be called up only via port 443. It may not contain parameters: Use the UserData parameter instead. Common notes: Before follow-up actions (capture / credit / reversal) are carried out on an existing transaction, the first Notify must have been answered by the shop. Fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.	Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein. Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key	Format	CND	Description	Beschreibung
UserData	ans..1024	O	If specified at request, Paygate forwards the parameter with the payment result to the shop.	Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Key	Format	CND	Description	Beschreibung
ReqId	ans..32	O	To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly. Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.	Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Key

Format

CND

Description

Beschreibung

Channel

a9

O

Either value "ecommerce" or "mcommerce"

ecommerce = Browser (default)
mcommerce = App-Switch

Einer der Werte "ecommerce" oder "mcommerce"

ecommerce = Browser (Standardwert)
mcommerce = App-Switch

Key	Format	CND	Description	Beschreibung
Plain	ans..50	O	A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. "Plain"-parameter is part of encrypted "Data" in Computop Paygate and therefore protected against manipulation.	Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID. Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt.

Key	Format	CND	Description	Beschreibung
Custom	ans..1024	O	"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. The Custom-value is added to the Computop Paygate response in plain text and the "\|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. Please find a samples here: Custom	Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate Aufruf. Dadurch ist der Wert gegen Manipulation geschützt. Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "\|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück. Hier finden Sie ein Beispiel: Custom

Key	Format	CND	Description	Beschreibung
TotalAmount	n..10	O	The total price of the purchase before tip and discount	Gesamtpreis des Kaufs vor Trinkgeld und Rabatt
Discount	n..10	O	Discount offered on the TotalAmount – is a positive integer and may be zero.	Auf den TotalAmount angebotener Rabatt – ist eine positive Ganzzahl und kann auch Null sein.
TransactionDate	ans20	O	UTC time of transaction in format "YYYY-MM-DDThh:mm:ssZ"	UTC-Zeit der Transaktion im Format "JJJJ-MM-TTThh:mm:ssZ"

Parameter für Zahlungen mit Bluecode Webseitenzahlung

Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate an Ihre URLSuccess, URLFailure und URLNotify übergibt. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..30	M	Unique reference number for your accounts - it is the unique reference with Bluecode, too. It must be printed in consumers invoice/receipt.	Eindeutige Referenznummer für Ihre Buchhaltung – sie ist auch die eindeutige Referenz für Bluecode. Sie muss auf Rechnung/Beleg des Kunden gedruckt werden.
RefNr	ans..30	O	Unique reference number. It must be printed in consumers invoice/receipt, if value present.	Eindeutige Referenznummer. Falls vorhanden, muss sie auf Rechnung/Beleg des Kunden gedruckt werden.
TransactionID	ans..64	M	Unique transaction number returned by Bluecode (acquirer_tx_id): must be printed on the customer's invoice; customer can find the acqurier_tx_id in his Bluecode-App-history, too.	Eindeutige Transaktionsnummer von Bluecode (acquirer_tx_id): muss auf der Kundenrechnung gedruckt werden; der Kunde findet die acqurier_tx_id auch im Verlauf seiner Bluecode-App.
InvoiceText	ans..400	O	Optional text to the consumers invoice/receipt; it must be printed, if value is present.	Optionaler Text für Rechnung/Beleg des Kunden; falls vorhanden, muss er gedruckt werden.

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK or AUTHORIZED (URLSuccess) as well as FAILED (URLFailure)	OK oder AUTHORIZED (URLSuccess) sowie FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Key	Format	CND	Description	Beschreibung
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
UserData	ans..1024	O	If specified at request, Paygate forwards the parameter with the payment result to the shop.	Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
Plain	ans..50	O	A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. "Plain"-parameter is part of encrypted "Data" in Computop Paygate and therefore protected against manipulation.	Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID. Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt.

Key	Format	CND	Description	Beschreibung
Custom	ans..1024	O	"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. The Custom-value is added to the Computop Paygate response in plain text and the "\|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. Please find a samples here: Custom	Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate Aufruf. Dadurch ist der Wert gegen Manipulation geschützt. Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "\|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück. Hier finden Sie ein Beispiel: Custom

Key	Format		CND	Description	Beschreibung
CodeExt	ans..30		O	Bluecode error Code	Fehlercode von Bluecode
QRCodeUrl	ans..128		C	Only when calling BluecodeS2S.aspx: if request processed successfully, QR Code URL will be returned, which can be converted to QR Code	Nur beim Aufruf von BluecodeS2S.aspx: falls der Aufruf erfolgreich war, wird eine QR-Code-URL zruückgegeben, die in einen QR-Code umgewandelt werden kann

Ergebnis-Parameter für URLNotify, URLSuccess und URLFailure bei Bluecode Webseitenzahlung

Stornierung (falls ein Zahlungsprozess nicht erfolgreich abgeschlossen wurde)

Stornierungen von Zahlungen mit Bluecode QR-Code-Zahlung sind über eine Server-zu-Server-Kommunikation möglich. Das Paygate erlaubt nur Stornierungen, die sich auf eine zuvor über das Paygate erfolgte Autorisierung beziehen. Bei der Stornierung einer Zahlung für die gesamte Zahlung storniert. Für erfolgreich abgeschlossene Zahlungsvorgänge ist keine Stornierung möglich. Um dem Kunden Geld zu erstatten, verwenden Sie eine "Gutschrift".

Um eine Stornierung für eine Bluecode QR-Code-Zahlung über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/reverse.aspx

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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment to be reversed	Vom Paygate vergebene ID für die zu stornierende Zahlung

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	O	Unique reference number for your accounts. The value is not sent to Bluecode with a reverse.	Eindeutige Referenznummer für Ihre Buchhaltung. Der Wert wird bei einer Stornierung nicht an Bluecode gesendet.

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
UserData	ans..256	O	If specified at request, Paygate forwards the parameter with the payment result to the shop.	Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Key	Format	CND	Description	Beschreibung
ReqId	ans..32	O	To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly. Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.	Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Parameter für Storno von Bluecode QR-Code-Zahlungen

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	O	Unique reference number for your accounts. The value is not sent to Bluecode with a credit.	Eindeutige Referenznummer für Ihre Buchhaltung. Der Wert wird bei der Gutschrift nicht an Bluecode gesendet.

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Key	Format	CND	Description	Beschreibung
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
UserData	ans..256	O	If specified at request, Paygate forwards the parameter with the payment result to the shop.	Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Key	Format	CND	Description	Beschreibung
CodeExt	ans..30	O	Bluecode error Code	Fehlercode von Bluecode

Ergebnis-Parameter für Storno von Bluecode QR-Code-Zahlungen

Gutschrift mit Referenz

Gutschriften für Zahlungen mit alle Bluecode-Zahlungsvarianten sind über eine Server-zu-Server-Kommunikation möglich. Das Paygate erlaubt nur Gutschriften, die sich auf eine zuvor über das Paygate erfolgte Buchung beziehen. Die Höhe der Gutschrift ist auf die Höhe der vorangegangenen Buchung beschränkt.

Um eine Gutschrift (Credit) mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/credit.aspx

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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment to be credited	Vom Paygate vergebene ID für die gutzuschreibende Zahlung

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	O	Unique reference number for your accounts. The value is not sent to Bluecode with a credit.	Eindeutige Referenznummer für Ihre Buchhaltung. Der Wert wird bei der Gutschrift nicht an Bluecode gesendet.

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc2		O	Optional reason for refund / credit, e.g. "Warranty"	Optionaler Grund für die Gutschrift, z.B. "Garantie"

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
UserData	ans..256	O	If specified at request, Paygate forwards the parameter with the payment result to the shop.	Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Key	Format	CND	Description	Beschreibung
ReqId	ans..32	O	To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly. Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.	Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Key	Format	CND	Description	Beschreibung
Reason	ans..256	O	Reason of refund	Grund der Gutschrift

Parameter für Gutschriften von Bluecode-Zahlungen

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	O	Unique reference number for your accounts. The value is not sent to Bluecode with a credit.	Eindeutige Referenznummer für Ihre Buchhaltung. Der Wert wird bei der Gutschrift nicht an Bluecode gesendet.
TransactionID	ans..64	M	Unique transaction number with Bluecode (acquirer_tx_id): is printed on the customer's invoice	Eindeutige Transaktionsnummer von Bluecode (acquirer_tx_id): sie wird auf der Kundenrechnung gedruckt

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Key	Format	CND	Description	Beschreibung
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
UserData	ans..256	O	If specified at request, Paygate forwards the parameter with the payment result to the shop.	Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Key	Format	CND	Description	Beschreibung
CodeExt	ans..30	O	Bluecode error Code	Fehlercode von Bluecode

Ergebnis-Parameter für Gutschriften von Bluecode-Zahlungen

Batch-Nutzung der Schnittstelle

Grundsätzliche Informationen zur Arbeit mit Batch-Dateien sowie zu deren Aufbau erfahren Sie im separaten Handbuch zum Batchmanager. Im Batch-Verfahren sind nicht alle Funktionen verfügbar, die für die Online-Schnittstelle verfügbar sind.

Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer Kreditkartenzahlung übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.

Bei den Batch-Aufrufen ist die verwendete Batch-Version zu unterscheiden, wovon die optionalen Parameter abhängen. Alle mit „2.“ beginnen Versionsbezeichnungen betreffen Aufrufe für einen Konzern. Das bedeutet, innerhalb einer Batch-Datei mit einer bestimmten MerchantID können auch Transaktionen anderer Händler mit einer abweichenden Sub-MID übertragen werden.

Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Action	Version	Description	Beschreibung
Credit	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)

Beschreibung der möglichen Batch-Versionen

Der Aufbau für eine Bluecode-Gutschrift in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

HEAD,<MerchantID>,<Date>,<Version>
Bluecode,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>

Beispiel für Master-MID-Funktion:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

Die folgende Tabelle beschreibt die einzelnen Felder und Werte, die im Datensatz (Record) innerhalb der Batch-Datei verwendet werden:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
Type	a..11	M	HEAD for Header, FOOT for Footer, Bluecode for Bluecode	HEAD für Header, FOOT für Footer, Bluecode für Bluecode
Action	a..20	M	The parameter Action defines the type of transaction: Credit	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	O	Unique reference number for your accounts. The value is not sent to Bluecode with a credit.	Eindeutige Referenznummer für Ihre Buchhaltung. Der Wert wird bei der Gutschrift nicht an Bluecode gesendet.

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for this transaction	Vom Paygate vergebene ID für diese Transaktion

Beschreibung der Felder im Datensatz von Batch-Dateien

Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:

HEAD,<MerchantID>,<Date>,<Version>
Bluecode,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Die folgende Tabelle beschreibt die Antwort-Parameter, die der Batch-Manager im Record-Bereich zu jeder Transaktion speichert (hier nicht erklärte Standardparameter wie etwa <TransID> oder <RefNR> und Aufrufparameter, werden unverändert zum Aufruf wieder zurückgegeben und sind vorstehend beschrieben):

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
Action	a..20	M	The parameter Action defines the type of transaction: Credit	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for this transaction	Vom Paygate vergebene ID für diese Transaktion

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien

Testdaten

Bluecode bietet zum Test der Funktionalität eine spezielle Sandbox-App ab. Diese Sandbox-App gibt es nicht in den offiziellen Appstores, aber hier:

Smartphone

Link und Anmerkungen

QR-Code für einfachen Download der Bluecode Sandbox-App

iOS

https://install.appcenter.ms/orgs/bluecode-organization/apps/at.secure-shopping.bluecode.sandbox-ios/distribution_groups/public

Hinweis zu iOS: Bei der ersten Installation der Sandbox-App muss der Firmen-App "bluesource" einmalig auf iOS-Geräten unter "Einstellungen> Allgemein> Profile & Gerätemanagement" vertraut werden. Erst danach kann die Sandbox-App auf iOS verwendet werden.

Preview of your QR Code

Android

https://install.appcenter.ms/orgs/bluecode-organization/apps/com.spt.bluecode.sandbox-android/distribution_groups/public

Preview of your QR Code (klicken zum Vergrößern)

Beachten Sie bitte:

Nach der Installation der Bluecode Sandbox-App muss der Bluecode mit einem Bankkonto verknüft werden:

Nach der Installation der Bluecode Sandbox-App müssen Sie eine PIN für die App einrichten
Klicken Sie dann auf "Bankkonto verknüpfen" und geben bei der Banksuche "test" ein.
Der Eintrag "Einen Testnutzer aktivieren" wird angezeigt. Durch Anklicken kann ein Testkonto hinzugefügt werden.
Dafür wählen Sie den ersten Eintrag "Hypo Tirol".
Dann wird ein Bluecode für die Zahlung angezeigt.
Zum Scannen eins QR-Codes mit Ihrem Smartphone tippen Sie auf das QR-Symbol links oben in der App, um die Kamera einzuschalten.
Dann wird der Betrag zur Bestätigung auf dem Smartphone angezeigt. Sie bestätigen das durch "Wischen".

In der Bluecode Sandbox-App werden keine "echten" Zahlungen ausgeführt, sie werden nur simuliert!

Die Bluecode Sandbox-App hat auch einige Transaktions-Limits (pro Stunde / pro Tag). Falls Sie die Transaktions-Limits deaktivieren müssen, senden Sie bitte eine E-Mail zusammen mit Ihrer Bluecode Sandbox-App "Bluecode ID" an devsupport@bluecode.com.

Die Bluecode ID finden Sie hier:

Wichtige Hinweise für den Wechsel zu Live-Zahlungen

Computop hat selbst eine zertifizierte Bluecode-Implementierung. Beim Umschalten vom Testbetrieb auf den Livebetrieb muss ein Händler jedoch sicherstellen, dass:

er die Computop-URL "Bluecode.aspx" nutzt, um eine Bluecode-Zahlung mit einer Weiterleitung zur Bluecode-Seite mit dem QR-Code auszulösen
er die Computop-URL "BluecodeS2S.aspx" nutzt, um eine Bluecode-URL zu erhalten, die vom Händlersystem in einen QR-Code umgewandelt werden muss
Werte für den Aufrufparameter "RefNr" für jeden Zahlungsvorgang eindeutig sind – doppelte Werte werden abgelehnt
Werte vom Antwortparameter "TransactionID" auf Rechnung / Beleg des Kunden gedruckt werden müssen
Werte vom Antwortparameter "TransID" auf Rechnung / Beleg des Kunden gedruckt werden müssen, sofern sie nicht leer sind

Space shortcuts

Page tree

Über Bluecode

Allgemeine Informationen über Bluecode

Was ist Bluecode?

Wie verknüpfen Kunden Bluecode mit ihrem Bankkonto?

Gibt es Zahlungslimits beim Bezahlen mit Bluecode?

Wie funktioniert die Bluecode QR-Code-Zahlung?

Anwendungsfälle

Diagramme zum Prozessablauf

Auf dieser Seite

Paygate-Schnittstelle

Definitionen

Datenformate

Abkürzungen

Aufruf der Schnittstelle für eine Bluecode-Webseitenzahlung mit QR-Code (Verkauf)

Stornierung (falls ein Zahlungsprozess nicht erfolgreich abgeschlossen wurde)

Gutschrift mit Referenz

Batch-Nutzung der Schnittstelle

Testdaten

Wichtige Hinweise für den Wechsel zu Live-Zahlungen

Paygate

Computop

Help

Intranet Tools