You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 33 Next »

Introduction and Prerequisites

Use your web-based ERP or shop system to accept card payments in stationery businesses. The communication of your terminals at the point of sale occurs via the Internet directly through Computop Paygate and makes traditional interfaces such as OPI or ZVT superfluous.

Process diagram




Paygate interface

Definitions

Data formats

Format

Description

a

alphabetical

as

alphabetical with special characters

n

numeric

an

alphanumeric

ans

alphanumeric with special characters

ns

numeric with special characters

bool

boolean expression (true or false)

3

fixed length with 3 digits/characters

..3

variable length with maximum 3 digits/characters

enum

enumeration of allowed values

dttm

ISODateTime (YYYY-MM-DDThh:mm:ss)


Abbreviations

Abbreviation

Description

Comment

CND

condition


M

mandatory

If a parameter is mandatory, then it must be present

O

optional

If a parameter is optional, then it can be present, but it is not required

C

conditional

If a parameter is conditional, then there is a conditional rule which specifies whether it is mandatory or optional


Notice: Please note that the names of parameters can be returned in upper or lower case.


Calling the interface for POS  Computop Cloud POS Interface

In order to use the Cloud POS Interface, please use the following URL:


Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter.

The following table describes the encrypted payment request parameters:

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

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescription

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

Key

Format

CND

Description

Beschreibung

MessageType

an2

M

Defines the type of payment:

Supported values are:

  • 01 - Sale
  • 02 - Reverse
  • 03 - Credit
  • 05 - Authorization/Reservation
  • 0B - Capture
  • 0C - Card Read
  • 0D - Diagnose
  • A1 - Terminal Startup

Definiert die Art der Zahlung:

Unterstützte Werte sind:

  • 01 - Verkauf (Sale)
  • 02 - Storno
  • 03 - Gutschrift
  • 05 - Autorisierung/Reservierung
  • 0B - Buchung
  • 0C - Karte lesen
  • 0D - Diagnose
  • A1 - Terminal Startup

CardReadMode

ans..10

C

Defines the technology to be used to read the card. Valid values are

  • msr
    Required for MessageType=0C (CardRead)

Definiert die Technologie, die zum Lesen der Karte verwendet werden soll. Gültige Werte sind

  • msr
    Erforderlich für MessageType=0C (CardRead)

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

Key

Format

CND

Description

Beschreibung

RefNr

ans..21

O

Merchant reference number

Händler-Referenznummer

POSTerminalID

an..20

M

TerminalID of pin entry device

TerminalID des PIN-Eingabegeräts

Printer

an1

M

Possible values that the merchant POS application can send are:

1 - Printer is ready

0 - Printer is not ready

Should be populated with 1 (further clarifications are in progress for usage of value 0)

Mögliche Werte, welche die POS-Anwendung des Händlers senden kann:

1 - Drucker ist bereit

0 - Drucker ist nicht bereit

Sollte mit 1 ausgefüllt werden (Weitere Abklärungen zur Verwendung des Wertes 0 sind in Arbeit)

KeyFormatCNDDescription
Amountn..10M

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

KeyFormatCNDDescription
Currency

a3

M

Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

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

Key

Format

CND

Description

Beschreibung

localDate

n8

M

Transaction date: YYYYMMDD

Transaktionsdatum: JJJJMMTT

localTime

n6

M

Transaction time: hhmmss

Transaktionszeit: hhmmss

TraceNr

ans8

C

Mandatory for subsequent functions Reversal or Capture (MessageType=02/08).

It must be equal to the value TraceNr received from the original authorization response.

Merchant POS system must provide this in the request.

Pflicht für Folgefunktionen Storno oder Buchung (MessageType=02/08).

Muss gleich dem Wert TraceNr sein, der von der ursprünglichen Autorisierungsantwort empfangen wurde.

Das POS-System des Händlers muss dies in der Anfrage übermitteln.

AppCode

ans6

C

Mandatory for subsequent function Capture (MessageType=08).

It must be equal to the value Approvalcode received from the original authorization response.

Merchant POS system must provide this in the request.

Pflicht für Folgefunktion Buchung (MessageType=08).

Muss gleich dem Wert Approvalcode sein, der von der ursprünglichen Autorisierungsantwort empfangen wurde.

Das POS-System des Händlers muss dies in der Anfrage übermitteln.

RTF

a1

O

Host protocol specific COF: RTF parameter.
Possible values: I or E

Host-Protokoll-spezifisch COF: RTF-Parameter.
Mögliche Werte: I oder E

ContractID

n..12

O

Special merchant ID at the acquirer to overrule the default merchant ID

Spezielle Händler-ID beim Acquirer, um die Standard-Händler-ID außer Kraft zu setzen

Parameters for payments with POS Computop Cloud POS Interface


The following table describes the result parameters with which the Computop Paygate responds to your system

(info) pls. be prepared to receive additional parameters at any time and do not check the order of parameters

(info) the key (e.g. mid, RefNr) should not be checked case-sentive

(Note: List of parameters in response may differ based on the Computop Cloud POS Interface function called and the final POS transaction result.)

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

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescription

mid

ans..30

M

MerchantID, assigned by Computop

KeyFormatCNDDescription
TransID

ans..64

MTransactionID provided by you which should be unique for each payment

KeyFormatCNDDescription
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

Key

Format

CND

Description

Beschreibung

RefNr

ans..21

O
Merchant reference number

Händler-Referenznummer

Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the CATCode parameter for the transaction status analysis!

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern CATCode für die Auswertung des Transaktionsstatus!

CATCodeans3MCode from the POS Server or POS device

Code vom POS-Server oder POS-Gerät

MaskedPANan12..19C

Masked card number (6X4).

Only in case of successful credit card transactions.

Maskierte Kartennummer (6X4).

Nur bei erfolgreichen Kreditkarten-Transaktionen.

BankAccountan64CMasked Bank account number for EC transactions

Maskierte Kontonummer für EC-Transaktionen

additionalresponsedataan..128OAdditional text which the operator’s processing system can send optionally in replies to payment/cutover requests.

Zusätzlicher Text, den das Verarbeitungssystem des Betreibers optional als Antwort auf Zahlungs-/Umstellungsanforderungen senden kann.

Approvalcodeans6C

Approval code from authorization host in the response message to the client.

Only in case of successful credit card transactions.

Merchant must save this value form the response and use it when referencing Capture subsequent action.

Genehmigungscode vom Autorisierungshost in der Antwortnachricht an den Client.

Nur bei erfolgreichen Kreditkarten-Transaktionen.

Der Händler muss diesen Wert aus der Antwort speichern und ihn verwenden, wenn er in der Folgeaktion Buchung darauf verweist.

CCSeqNrn3OCard sequence number

Kartenfolgenummer

Brandan..22OBrand: VISA, MasterCard, Maestro, AMEX, DINERS, JCB, CUP

Marke: VISA, MasterCard, Maestro, AMEX, DINERS, JCB, CUP

CodeExtn3CFinancial transaction Authorization Host response code (Payment).

Antwortcode vom Autorisierungs-Host der Finanztransaktion (Zahlung)

TraceNrans8CMerchant must save this value form the response and use it when referencing subsequent actions i.e Reverse, Capture

Der Händler muss diesen Wert aus der Antwort speichern und ihn verwenden, wenn er in Folgetransaktionen darauf verweist, z.B. Storno, Buchung

VUNrn8OAcquirer Contract ID number on which the transaction was processed

Vertrags-ID-Nummer des Acquirers, bei dem die Transaktion verarbeitet wurde

ReceiptobjectCReceipt content for the Merchant and the cardholder. The information should be than used from Merchant Printer system to print out the respective receipts.

Quittungsinhalt für den Händler und den Karteninhaber. Die Informationen sollten dann vom Drucksystem des Händlers verwendet werden, um die entsprechenden Quittungen auszudrucken.

ReceiptNran..10OReceipt Number

Quittungsnummer

schemeReferenceID / TransactionIDan..22OUnique transaction identifier provided by Schemes/Issuer to reference the transaction in MIT or COF scenarios

Eindeutige Transaktionskennung, die von Schemes/Issuern bereitgestellt wird, um die Transaktion in MIT- oder COF-Szenarien zu referenzieren

dccForeignAmountn..10OOnly when DCC was performed

Nur wenn DCC durchgeführt wurde

dccCommissionans..7OOnly when DCC was performed

Nur wenn DCC durchgeführt wurde

dccForeignCurrencyCoden..4OOnly when DCC was performed

Nur wenn DCC durchgeführt wurde

dccDisclaimer (new Param)ans..1024OOnly when DCC was performed

Nur wenn DCC durchgeführt wurde

dccMarginans..5OOnly when DCC was performed

Nur wenn DCC durchgeführt wurde

dccRateValuen..13OOnly when DCC was performed

Nur wenn DCC durchgeführt wurde

dccSourceans..32OOnly when DCC was performed

Nur wenn DCC durchgeführt wurde

dccTimestampans..20OOnly when DCC was performed

Nur wenn DCC durchgeführt wurde

ExpiryDaten..6OYYYYMM

JJJJMM

Nur wenn DCC durchgeführt wurde

KeyFormatCNDDescription
PCNr

n16

O

Pseudo Card Number: Random number generated by Computop Paygate which represents a genuine credit card number. The pseudo card number (PCN) starts with 0 and the last 3 digits correspond to those of the real card number. The PCN can be used like a genuine card number for authorisation, capture and credits.

PCNr is a response value from Computop Paygate and is sent as CCNr in Request or part of card-JSON.

KeyFormatCNDDescription
PCNr

n16

O

Pseudo Card Number: Random number generated by Computop Paygate which represents a genuine credit card number. The pseudo card number (PCN) starts with 0 and the last 3 digits correspond to those of the real card number. The PCN can be used like a genuine card number for authorisation, capture and credits.

PCNr is a response value from Computop Paygate and is sent as CCNr in Request or part of card-JSON.

Key

Format

CND

Description

Beschreibung

VerificationCode

an..40

O
Used authentication mode. Possible values:
  • Signature
  • PIN
  • On consumer device
  • NoAuth
Verwendeter Authentifizierungsmodus. Mögliche Werte:
  • Signature
  • PIN
  • On consumer device
  • NoAuth
PayID

an..32

O

Computop PayID of the respective payment completed and linked with this CPI command

Computop PayID der jeweiligen Zahlung, die abgeschlossenen und mit diesem CPI-Befehl verknüpft ist

aidParameters

ans..1024

O
Authorisation parameters: if these are present, the authorisation parameters must be printed out on the terminal receipt in unpacked form as 10 hexadecimal numbers. Aid-parameters can contain up to 130 characters for electronic cash payments.

Autorisierungsparameter: Sofern diese vorhanden sind, müssen die Autorisierungsparameter auf dem Kassenbon unverschlüsselt als 10 Hexadezimalzahlen ausgedruckt werden. Bei elektronischen Barzahlungen können die Hilfsparameter bis zu 130 Zeichen lang sein.

localDate

n..8

O
Transaction date: YYYYMMDD

Transaktionsdatum: JJJJMMTT

localTime

n..6

O
Transaction time: hhmmss

Transaktionszeit: hhmmss

RTF

a1

O
Echoed from the request parameter

Echo vom Aufrufparameter

ContractID

n..12

O
Echoed from the request parameter

Echo vom Aufrufparameter

POSTerminalId

an..20

O
Echoed from the request parameter

Echo vom Aufrufparameter

TerminalID

an..12

O
Terminal ID which is forwarded towards acquirer authorization host

Terminal-ID, die an den Acquirer-Autoriserungshost weitergeleitet wird

Result parameters for payments with POS Computop Cloud POS Interface


JSON Object (Receipt)

Please note that the data within this JSON object is encoded using ISO-8859-1 in contrast to the standard encoding of JSON objects with UTF-8 and then must be also Base64 encoded. This applies in particular to special characters such as "Umlaute" and diactrics.

"receipt"

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

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

Beschreibung

receiptCopies

integer

O

Number of receipt copies to be printed 

Anzahl der zu druckenden Quittungskopien 

receiptCustomer

string

O

Customer receipt data

Kundenquittungsdaten

receiptMerchant

string

O

Merchant receipt data

Händlerquittungsdaten

receiptNumber

integer

O

Receipt number

Quittungsnummer


JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "http://json-schema.org/draft-07/schema#",
  "title": "receipt",
  "description": "Data containing the receipt information which can be printed out by the merchant system",
  "type": "object",
  "properties": {
    "receiptMerchant": {
      "type": "string",
      "description": "Merchant Receipt data"
    },
    "receiptCustomer": {
      "type": "string",
      "description": "Customer Receipt data"
    },
    "receiptCopies": {
      "type": "integer",
      "description": "Number of receipt copies to be printed"
    },
    "receiptNumber": {
      "type": "integer",
      "description": "Receipt Number "
    },
      
  },
  "additionalProperties": false
}






  • No labels