Versions Compared

Version Old Version 46 New Version Current
Changes made by

Technical Writer

Juan BARRAZA

Saved on

Key

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

...

Cash register number

CA

Fixed length. 2

Cash register nº.

Processing on cash register side:

The cash register indicates its own cash register number in this Tag. Field composed of numeric characters: ‘0’ to ‘9’

Processing on terminal side:
No processing, returned in the response message as is.

Remarks:

This Tag is managed exclusively by the cash register. This number is not intended to be printed on the transaction ticket.

This value is stored in “MerchantIdentifier” in PayXpress.

Example - The cash register number is 1

CA00201

...

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)Refund by Credit. Not linked to original transaction of Debit.

  • ‘2’ = Cancellation. Linked to original transaction of Debit but can only be the original amount of the Debit.

  • ‘3’ = Duplicate

  • '7' = Deferred debit

List of types of Selection/Input Actions:

  • ‘I’ = Identification

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

  • 'R' = Reboot the POS - Only compatible with Castles devices

  • 'C' = 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 ‘Type of action requested unknown’. In the case of printing a buffer (ASCII encoded base 64) sent by the cash register, the tag CD with type of action ‘P’ will be completed with a constructed Tag ZT containing the buffer to be printed.

Example - Perform a debit. See example

CD0010

CD001C

...

Private field

CF

Variable length. 1-99

Private data destined for PayXpress or to be sent back to the cash register in the response message

Processing on cash register side:

Indicate the data you want to transmit to PayXpress.

Processing on terminal side:
Private data that can be used by the merchant/integrator which they 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

...

Tag

Meaning

Rule

Example

CZ

Concert Protocol version

Configurable, 0320 by default

CZ0040320

CJ

Cash register protocol version

Configurable, 323540032810 by default.
This is PayXpert’s Association du Paiement-assigned ID for this field.

CJ012323540032810

CA

Cash register number

Constant 1

CA0011

CB

Amount

Amount in cents. 25,00€

CB0042500

CD

Action type

Depends on what we want:
'0’ = Debit (Payment)
‘1’ = Refund by Credit (not linked to Original Transaction)
‘2’ = Cancellation
‘3’ = Duplicata

Debit: CD0010

Refund : CD0011

Cancellation: CD0012

Duplicata: CD0013

CE

Currency

Code for Euro.
Constant is 978.

CE003978

...

Tag

Meaning

Rule

Example

CZ

Concert protocol version

Configurable, 0320 by default

CZ0040320

CJ

Cash register protocol version

Configurable, 323540032810 by default.
This is PayXpert’s Association du Paiement-assigned ID for this field.

CJ012323540032810

CA

Cash register number

Constant 1

CA0011

CB

Amount

Amount in cents. 25,00€

CB0042500

CD

Action type

Depends on what we want:
'0’ = Debit (Payment)
‘1’ = Credit (Refund)
‘2’ = Annulation
‘3’ = Duplicata

Debit : CD0010

Refund : CD0011

Cancellation: CD0012

Duplicata : CD0013

CE

Currency

Code for Euro.
Constant is 978.

CE003978

CK

Ticket management

Position 1:

  • ‘1’ Ticket management supported; r4esponse in the ZT constructed field

Position 2:

  • ‘0’ Customer ticket

  • ‘1’ Merchant ticket

  • ‘2’ Customer and Merchant tickets

Position 3:

  • ‘0’: Extended ASCII format (Latin-1) encoded base 64

  • ‘1’: HTML format encoded base 64

CK003100

...

Tag

Meaning

Rule

Example

CZ

Concert protocol version

Configurable, 0320 by default

CZ0040320

CJ

Cash register protocol version

Configurable, 323540032810 by default.
This is PayXpert’s Association du Paiement-assigned ID for this field.

CJ012323540032810

CA

Cash register number

Constant 1

CA0011

CD

Action type

Depends on what we want :
'0’ = Debit (Payment)
‘1’ = Refund
‘2’ = Cancellation
‘3’ = Duplicata

Debit : CD0010

Refund : CD0011

Cancellation: CD0012

Duplicata : CD0013

CK

Ticket management

Position 1:

  • ‘1’ Ticket management supported, Response in the ZT constructed field

Position 2:

  • ‘0’ Customer ticket

  • ‘1’ Merchant ticket

  • ‘2’ Customer and Merchant tickets

Position 3:

  • ‘0’: Extended ASCII format (Latin-1) encoded base 64

  • ‘1’: HTML format encoded base 64

CK003100

...

Tag

Meaning

Rule

Example

CZ

Concert protocol version

Configurable, 0320 by default

CZ0040320

CJ

Cash register protocol version

Configurable, 323540032810 by default.
This is PayXpert’s ID, given to us by the Association du Paiement-assigned ID for this field.

CJ012323540032810

CA

Cash register number

Constant 1

CA0011

AE

Status of the action

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

AE00210

ZT

Ticket

Only the Customer Ticket is given in the response.

ZT617CK003100AK604VEFSSkVUQSBCQU5DQVJJQQpTSU4gQ09OVEFDVE8KQm9uam91ciAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAKQTAwMDAwMDAwNDEwMTAKRGViaXRvCiAyMS8xMC8yNCAtIDIzOjEyOjI0Ckc3IFRFU1QgICAgICAgICAgMjEgCkRJSk9OICAgICAgICAgICAgICAgCiAgICAgICAgICAgICAgICAgICAgCjA4OTkwMTMKMjAwNDEKMzI0Mzc5ODY2MDAwMTkKWFhYWFhYWFhYWFhYMjg5NwpFQzNBRjY5QTE2QkI3NDM4CjY1NSAwMDIgMDAwMDA2ICAwMSAgQyAgQApOVU1FUk8gQVVUT1JJWkFDST9OOiA2NjQ4NDUKUkVGLiA6IDE5OTU1MjkwMTM0MTg3MzUKSU1QT1JURQoxLDAwP0VVUgpWRU5UQQpSRUNJQk8gUEFSQSBFTCBDTElFTlRFCkEgQ09OU0VSVkFSCkRVUExJQ0FETwpNZXJjaSwgYXUgcmV2b2lyLiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIAo=

...

Tag

Meaning

Rule

Example

CZ

Concert Protocol version

Configurable, 0320 by default

CZ0040320

CJ

Cash register protocol version

Configurable, 323540032810 by default.
This is PayXpert’s Association du Paiement-assigned ID for this field.

CJ012323540032810

CA

Cash register number

Constant 1

CA0011

CD

Action type

I for Identification method

CD001I

...

Tag

Meaning

Rule

Example

CZ

Protocol version

Configurable, 0320 by default

CZ0040320

CJ

Cash register protocol version

Configurable, 323540032810 by default.
This is PayXpert’s ID, given to us by the Association du Paiement-assigned ID for this field.

CJ012323540032810

CA

Cash register number

Constant 1

CA0011

CD

Action type

P for Print method

CD001P

ZT

Constructed Tag composed of the data in CK and the (ASCII base64) buffer to print in AK

ZT0025CK003100AK0012Ym9uam91cg==

CK

'Print ticket?' selection

Position 1:

  • ‘1’ Ticket management supported, Response in ZT constructed field

Position 2:

  • ‘0’ Customer ticket

Position 3:

  • ‘0’: Extended ASCII format (Latin-1) encoded in base 64

CK003100

AK

Data to print

Base 64 encoding of the ticket to be printed, 900 max
Example: text "bonjour"

AK0012Ym9uam91cg==

...