Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel3
outlinefalse
styledefault
typelist
printabletrue

...

Operation type

CD

Fixed length. 1

Defines the type of operation requested by the cash register

Processing on cash register side:

Processing on terminal side:
List of types of transaction actions:

  • ‘0’ = Debit (Purchase)

  • ‘1’ = Credit (Refund)

  • ‘2’ = Cancellation

  • ‘3’ = Duplicate

  • '7' = Deferred debit

List of types of Selection/Input Actions:

‘B’ = Telecollection

  • ‘I’ = Identification

  • ‘P’ = Printing on the terminal of a buffer transmitted by the cash register

  • 'R' = (On Castles) Reboot the POS - Only compatible with Castles Devices

  • 'C' = (On Castles) CTMS Status - Only compatible with Castles Devices

  • 'T' = Transaction Status

Remarks:

If the type of operation cannot be carried out, the terminal responds with ‘Status: Operation not carried out’ andin the complementary info Tag AF ‘Operation not carried out - type of action requested unknown’. In the case of printing a buffer (ASCII encoded base 64) sent by the cash register, the tag CD type of action ‘P’ will be completed with a constructed Tag ZT containing the buffer to be printed.

Example - Perform a debit. See example

Example - for printing: see this examplePrint buffer action

CD0010

CD001C

...

Private field

CF

Variable length. 1-99

Private data destined for the application on the terminal or sent back to the cash register in the response message

Processing on cash register side:

Indicate the data to be transmitted to the payment (or information retrieval) application.

Processing on terminal side:
Specific to PayXpress.Private data that can be used by merchant/integrator and would like to be stored by PayXpress as part of the transaction details.
The value is stored in PayXpress at the transaction level as part of the field “Order Id“ or “Merchant Id”

Remarks:

Example

CF020TEST CONCERT CN 3.XX

...

Cash register protocol version

CJ

Fixed length. 12

The version of the protocol that the cash register and/or terminal is using.

Processing on cash register side:

The version of the protocol the cash register is using. Sent in every message to terminal.

Processing on terminal side:
The version of the protocol the terminal is using. Sent in every message to cash register.

Remarks:

For reference only. Does not control anything.
By default we must put 323540032810.

Example

CJ012012345678901

...

Protocol version to use

CZ

Fixed length. 4

Tells the cash register and/or the terminal the version to use.

Processing on cash register side:

Tells the terminal what version the incoming communication is in.

Processing on terminal side:
Tells the cash register what version the incoming communication is in.

Remarks:
This Tag should be the first one in the messages transmitted by both cash register and terminal.
By Default it must be 0320.

Example - “I am sending this message in protocol version 3.20”

CZ0040320

...

Tag

Meaning

Rule

Example

CZ

Concert Protocol version

Taken from the initial message sent by the Cash Register

CZ0040320

CJ

Cash register protocol version

taken from the initial message sent by the Cash Register

CJ012323540032810

CA

Cash register number

taken from the initial message sent by the Cash Register

CA0011

CB

Amount

taken from the initial message sent by the Cash Register

CB0042500

CD

Action type

taken from the initial message sent by the Cash Register

CD0010

CE

Currency

taken from the initial message sent by the Cash Register

CE003978

AE

Status of the action

‘01’ = Operation not performed
‘10’ = Operation performed

AE00210

AF

Complementary info to the Action status

AF00201

CI

Card-reading mode (payment mode)

‘1’ contact
‘2’ contactless
‘3’ magenetic reader
‘4’ manual entry

CI0012

ZT

Ticket

Only the Customer Ticket is given in the response.

ZT617CK003100AK604VEFSSkVUQSBCQU5DQVJJQQpTSU4gQ09OVEFDVE8KQm9uam91ciAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKQTAwMDAwMDAwNDEwMTAKRGViaXRvCiAyMS8xMC8yNCAtIDIzOjEyOjI0Ckc3IFRFU1QgICAgICAgICAgMjEgCkRJSk9OICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgCjA4OTkwMTMKMjAwNDEKMzI0Mzc5ODY2MDAwMTkKWFhYWFhYWFhYWFhYMjg5NwpFQzNBRjY5QTE2QkI3NDM4CjY1NSAwMDIgMDAwMDA2ICAwMSAgQyAgQApOVU1FUk8gQVVUT1JJWkFDST9OOiA2NjQ4NDUKUkVGLiA6IDE5OTU1MjkwMTM0MTg3MzUKSU1QT1JURQoxLDAwP0VVUgpWRU5UQQpSRUNJQk8gUEFSQSBFTCBDTElFTlRFCkEgQ09OU0VSVkFSCkRVUExJQ0FETwpNZXJjaSwgYXUgcmV2b2lyLiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAo=

TODO David Guignard add Duplicata request and response.


Identification of the terminal - Ping Request to terminal

...