TransactionStatus Request

HTTP Responses

• 200

  Content of the TransactionStatus Response message. It conveys Information related to the status of the last or current Payment, Loyalty or Reversal transaction.

  Show moreShow less

  Responseobject

  Result of a message request processing. If Result is Success, ErrorCondition is absent or not used in the processing of the message. In the other cases, the ErrorCondition has to be present and can refine the processing of the message response. AdditionalResponse gives more information about the success or the failure of the message request processing, for logging without real time involvements.

  Show childrenHide children

  Resultstring

  Result of the processing of the message. Possible values:

  • Failure
  • Partial
  • Success

  ErrorConditionstring

  Condition that has produced an error on the processing of a message request. Returned if Result is not Success. Possible values:

  • Aborted
  • Busy
  • Cancel
  • DeviceOut
  • InProgress
  • InsertedCard
  • InvalidCard
  • LoggedOut
  • MessageFormat
  • NotAllowed
  • NotFound
  • PaymentRestriction
  • Refusal
  • UnavailableDevice
  • UnavailableService
  • UnreachableHost
  • WrongPIN

  AdditionalResponsestring

  Additional information related to processing status of a message request. If present, the POI logs it for further examination.

  MessageReferenceobject

  Identification of a previous POI transaction. To abort a transaction in progress or to request the status of a transaction from which no response has been received. It identifies the message header of the message request to abort or request the status.

  Show childrenHide children

  MessageCategorystring

  Category of message. CardAcquisition, Display, Input, Loyalty, Payment, Print, CardReaderAPDU, CardReaderInit, CardReaderPowerOff. Possible values:

  • Abort
  • Admin
  • BalanceInquiry
  • Batch
  • CardAcquisition
  • CardReaderAPDU
  • CardReaderInit
  • CardReaderPowerOff
  • Diagnosis
  • Display
  • EnableService
  • Event
  • GetTotals
  • Input
  • InputUpdate
  • Login
  • Logout
  • Loyalty
  • None
  • PIN
  • Payment
  • Print
  • Reconciliation
  • Reversal
  • Sound
  • StoredValue
  • TransactionStatus
  • Transmit

  ServiceIDstring

  Identification of a message pair, which processes a transaction.

  DeviceIDstring

  Identification of a device message pair.

  SaleIDstring

  Identification of a Sale System or a Sale Terminal for the Sale to POI protocol. default MessageHeader.SaleID.

  POIIDstring

  Identification of a POI System or a POI Terminal for the Sale to POI protocol. Default MessageHeader.POIID.

  RepeatedMessageResponseobject

  Content of the requested Message Response. If Result is Success (process completed).

  Show childrenHide children

  MessageHeaderobject

  Message header of the Sale to POI protocol message. It conveys Information related to the Sale to POI protocol management.

  Show childrenHide children

  ProtocolVersionstring

  If MessageCategory is Login or Diagnosis.

  MessageClassstring

  Class of the message. Possible values:

  • Device
  • Event
  • Service

  MessageCategorystring

  Category of message. Possible values:

  • Abort
  • Admin
  • BalanceInquiry
  • Batch
  • CardAcquisition
  • CardReaderAPDU
  • CardReaderInit
  • CardReaderPowerOff
  • Diagnosis
  • Display
  • EnableService
  • Event
  • GetTotals
  • Input
  • InputUpdate
  • Login
  • Logout
  • Loyalty
  • None
  • PIN
  • Payment
  • Print
  • Reconciliation
  • Reversal
  • Sound
  • StoredValue
  • TransactionStatus
  • Transmit

  MessageTypestring

  Type of message of the Sale to POI protocol. Possible values:

  • Notification
  • Request
  • Response

  ServiceIDstring

  Identification of a message pair, which processes a transaction. Required if Service or Event MessageClass message or if Device MessageClass and request from POI or response from Sale.

  DeviceIDstring

  Identification of a device message pair. If Device MessageClass.

  SaleIDstring

  Identification of a Sale System or a Sale Terminal for the Sale to POI protocol.

  POIIDstring

  Identification of a POI System or a POI Terminal for the Sale to POI protocol.

  RepeatedResponseMessageBodyobject

  Show childrenHide children

  LoyaltyResponseobject

  It conveys Information related to the Loyalty transaction processed by the POI System. Content of the Loyalty Response message.

  Show childrenHide children

  Responseobject

  Result of a message request processing. If Result is Success, ErrorCondition is absent or not used in the processing of the message. In the other cases, the ErrorCondition has to be present and can refine the processing of the message response. AdditionalResponse gives more information about the success or the failure of the message request processing, for logging without real time involvements.

  Show childrenHide children

  Resultstring

  Result of the processing of the message. Possible values:

  • Failure
  • Partial
  • Success

  ErrorConditionstring

  Condition that has produced an error on the processing of a message request. Returned if Result is not Success. Possible values:

  • Aborted
  • Busy
  • Cancel
  • DeviceOut
  • InProgress
  • InsertedCard
  • InvalidCard
  • LoggedOut
  • MessageFormat
  • NotAllowed
  • NotFound
  • PaymentRestriction
  • Refusal
  • UnavailableDevice
  • UnavailableService
  • UnreachableHost
  • WrongPIN

  AdditionalResponsestring

  Additional information related to processing status of a message request. If present, the POI logs it for further examination.

  SaleDataobject

  Data associated with the Sale System, with a particular value during the processing of the payment by the POI, including the cards acquisition.

  Show childrenHide children

  OperatorIDstring

  Identification of the Cashier or Operator.

  OperatorLanguagestring

  Language of the Cashier or Operator. If different from the Login.

  ShiftNumberstring

  Shift number. If different from the Login, see Login SaleData.

  SaleTransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  SaleReferenceIDstring

  Identification of a Sale global transaction for a sequence of related POI transactions. If payment reservation.

  SaleTerminalDataobject

  Information related to the software and hardware features of the Sale Terminal. Sent in the Login Request if a Sale Terminal is involved in the login. In other messages, sent when a logical device is out of order (SaleCapabilities) or when other data have changed or were missing in the Login.

  Show childrenHide children

  TotalsGroupIDstring

  Identification of a group of transactions on a POI Terminal, having the same Sale features. Could be used to group POI for reconciliation or other purpose defined by the Sale System. The default value is assigned by the Login Request.

  TokenRequestedTypestring

  Type of token replacing the PAN of a payment card to identify the payment mean of the customer. It allows, for a merchant, to use a token for a transaction only or for a longer period. Possible values:

  • Customer
  • Transaction

  CustomerOrderIDstring

  Additional and optional identification of a customer order.

  CustomerOrderReqarray[string]

  List of customer order open, closed or both to be sent in the response messages. Possible values:

  • Both
  • Closed
  • Open

  SaleToPOIDatastring

  Sale information intended for the POI. Stored with the transaction.

  SaleToAcquirerDatastring

  Sale information intended for the Acquirer. Send to the Acquirer if present.

  SaleToIssuerDataobject

  Sale information intended for the Issuer. The POI System receives this information and sends it to the Acquirer for the Issuer without any change.

  Show childrenHide children

  StatementReferencestring

  Label to print on the bank statement.

  POIDataobject

  Data related to the POI System. In the Message Response, identification of the POI transaction.

  Show childrenHide children

  POITransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  POIReconciliationIDinteger

  Identification of the reconciliation period between Sale and POI. If Result is Success.

  LoyaltyResultarray[object]

  Data related to the result of a processed loyalty transaction. If loyalty account identified.

  Show childrenHide children

  LoyaltyAccountobject

  This data structure conveys the identification of the account and the associated loyalty brand. Data related to a loyalty account processed in the transaction.

  Show childrenHide children

  LoyaltyAccountIDobject

  Identification of a Loyalty account. In the Payment or the Loyalty Request message, it allows to identify the loyalty account by the Sale Terminal instead of the POI Terminal (e.g. because the account identification is a bar-code read by the Cashier on a scanner device).

  Show childrenHide children

  EntryModearray[string]

  Entry mode of the payment instrument information. In the Payment, Loyalty or StoredValue Request messages, it informs the POI System the entry mode of the payment instrument information when read by the Sale Terminal. In the Payment, Loyalty or StoredValue Response messages, it informs the Sale System the entry mode of the payment instrument. Possible values:

  • Contactless
  • File
  • ICC
  • Keyed
  • MagStripe
  • Manual
  • Mobile
  • RFID
  • Scanned
  • SynchronousICC
  • Tapped

  IdentificationTypestring

  Type of account identification. In a request message, it informs the POI System the type of the account or card identification, when provided by the Sale Terminal. (e.g. because the card information is a barcode read by the Cashier on a scanner device). In a response message, it informs the Sale System the type of the account or card identification. Possible values:

  • AccountNumber
  • BarCode
  • ISOTrack2
  • PAN
  • PhoneNumber

  IdentificationSupportstring

  Support of the loyalty account identification. Allows knowing where and how you have found the loyalty account identification. Possible values:

  • HybridCard
  • LinkedCard
  • LoyaltyCard
  • NoCard

  LoyaltyIDstring

  Loyalty account identification conforming to the IdentificationType.

  LoyaltyBrandstring

  Identification of a Loyalty brand. If a card is analysed.

  CurrentBalancenumber

  Maximum: 99999999.999999

  Balance of an account. If known (provided by the card or an external host).

  LoyaltyAmountobject

  Amount of a loyalty account. An awarded amount or an amount to redeem to the loyalty account might be sent in the Payment request message.

  Show childrenHide children

  LoyaltyUnitstring

  Unit of a loyalty amount. The amount could be expressed in point or in a monetary value and a currency. Possible values:

  • Monetary
  • Point

  Currencystring

  Currency of a monetary amount.

  AmountValuenumber

  Maximum: 99999999.999999

  Value of an amount.

  LoyaltyAcquirerDataobject

  Data related to the loyalty Acquirer during a loyalty transaction. If content not empty.

  Show childrenHide children

  LoyaltyAcquirerIDstring

  Identification of the loyalty Acquirer.

  ApprovalCodestring

  Code assigned to a transaction approval by the Acquirer. Could be an identifier of the approved transaction for the Acquirer. This data element is conditional for the Loyalty Acquirers. Used in the PaymentRequest request for a referral.

  LoyaltyTransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  HostReconciliationIDstring

  Identifier of a reconciliation period with a payment or loyalty host. Allows the assignment of a transaction to the Acquirer reconciliation (or batch).

  Rebatesobject

  Rebate form to an award. If rebates awarded.

  Show childrenHide children

  TotalRebatenumber

  Maximum: 99999999.999999

  The global awarded amount that is not attached to an item.

  RebateLabelstring

  Short text to qualify a rebate on an line item. Text to be printed on a receipt in front of the rebate on an item or the rebate on the totals.

  SaleItemRebatearray[object]

  The awarded amount that is attached to an item as a rebate. To be differentiated from the award which is the amount or quantity earned on the loyalty account.

  Show childrenHide children

  ItemIDinteger

  Item identification inside a transaction (0 to n).

  ProductCodeinteger

  Minimum: 1Maximum: 20

  Product code of item purchased with the transaction.

  EanUpcinteger

  Standard product code of item purchased with the transaction.

  UnitOfMeasurestring

  Unit of measure of a quantity. If Quantity present. Possible values:

  • Case
  • Centilitre
  • Centimetre
  • Foot
  • Gram
  • Inch
  • Kilogram
  • Kilometre
  • Litre
  • Meter
  • Mile
  • Other
  • Ounce
  • Pint
  • Pound
  • Quart
  • UKGallon
  • USGallon
  • Yard

  Quantitystring

  Product quantity. If rebate is additional units.

  ItemAmountnumber

  Maximum: 99999999.999999

  Total amount of the item line. If rebate on the line item amount.

  RebateLabelstring

  Short text to qualify a rebate on an line item. If provided by the Acquirer.

  PaymentReceiptarray[object]

  Show childrenHide children

  DocumentQualifierstring

  Qualification of the document to print to the Cashier or the Customer. SaleReceipt or CashierReceipt. Possible values:

  • CashierReceipt
  • CustomerReceipt
  • Document
  • Journal
  • SaleReceipt
  • Voucher

  IntegratedPrintFlagboolean

  Type of the print integrated to other prints.

  RequiredSignatureFlagboolean

  Indicate that the cardholder payment receipt requires a physical signature by the Customer.

  OutputContentobject

  Content to display or print. This is a sequence of elements if they have different formats.

  Show childrenHide children

  OutputFormatstring

  Format of the content to display or print. Display or print device function. Possible values:

  • BarCode
  • MessageRef
  • Text
  • XHTML

  PredefinedContentobject

  Reference of a predefined message to display or print. It conveys information related to the predefined message.

  Show childrenHide children

  ReferenceIDstring

  Identification of a predefined message to display or print.

  Languagestring

  Identification of a language.

  OutputTextarray[object]

  Content of text message to display or print. Mandatory, if OutputFormat is Text, not allowed otherwise. One instance of OutputText per shared format.

  Show childrenHide children

  Textstring

  Content of text message to display, print or play.

  CharacterSetinteger

  Character height of the text string to display or print. Absence of this data element means the characters have normal height.

  Fontstring

  Name of the font. Used to change character font of the output, as agreed between the POI and Sale Systems.

  StartRowinteger

  Minimum: 1Maximum: 500

  Row where the text string has to be displayed or printed.

  StartColumninteger

  Minimum: 1Maximum: 500

  Column where the text string has to be displayed or printed.

  Colorstring

  Color of the text string to display or print. Possible values:

  • Black
  • Blue
  • Cyan
  • Green
  • Magenta
  • Red
  • White
  • Yellow

  CharacterWidthstring

  Character width of the text string to display or print. Absence of this data element means the characters have normal width. Possible values:

  • DoubleWidth
  • SingleWidth

  CharacterHeightstring

  Character height of the text string to display or print. Absence of this data element means the characters have normal height. Possible values:

  • DoubleHeight
  • HalfHeight
  • SingleHeight

  CharacterStylestring

  Typographic style of the sequence of characters to display or print. Absence of this data element means the characters have normal style. Possible values:

  • Bold
  • Italic
  • Normal
  • Underline

  Alignmentstring

  Alignment of the text string on the display line or print line. Absence of this data element means the characters have normal alignment. Possible values:

  • Centred
  • Justified
  • Left
  • Right

  EndOfLineFlagboolean

  Indicates if the text is at the end of a line. Allows the display or the print of a new line and a carry-over return characters after the formatted text.

  OutputXHTMLstring

  XHTML document body containing the message to display or print. Mandatory if OutputFormat is XHTML, not allowed otherwise.

  OutputBarcodeobject

  Barcode content to display or print. Mandatory if OutputFormat is Barcode, not allowed otherwise.

  Show childrenHide children

  BarcodeTypestring

  Type of Barcode coding. Qualification of the barcode value to display or print. Possible values:

  • Code128
  • Code25
  • EAN13
  • EAN8
  • PDF417
  • QRCode
  • UPCA

  BarcodeValuestring

  Value with a Barcode coding. The barcode value to display or print.

  PaymentResponseobject

  It conveys Information related to the Payment transaction processed by the POI System. Content of the Payment Response message.

  Show childrenHide children

  Responseobject

  Result of a message request processing. If Result is Success, ErrorCondition is absent or not used in the processing of the message. In the other cases, the ErrorCondition has to be present and can refine the processing of the message response. AdditionalResponse gives more information about the success or the failure of the message request processing, for logging without real time involvements.

  Show childrenHide children

  Resultstring

  Result of the processing of the message. Possible values:

  • Failure
  • Partial
  • Success

  ErrorConditionstring

  Condition that has produced an error on the processing of a message request. Returned if Result is not Success. Possible values:

  • Aborted
  • Busy
  • Cancel
  • DeviceOut
  • InProgress
  • InsertedCard
  • InvalidCard
  • LoggedOut
  • MessageFormat
  • NotAllowed
  • NotFound
  • PaymentRestriction
  • Refusal
  • UnavailableDevice
  • UnavailableService
  • UnreachableHost
  • WrongPIN

  AdditionalResponsestring

  Additional information related to processing status of a message request. If present, the POI logs it for further examination.

  SaleDataobject

  Data associated with the Sale System, with a particular value during the processing of the payment by the POI, including the cards acquisition.

  Show childrenHide children

  OperatorIDstring

  Identification of the Cashier or Operator.

  OperatorLanguagestring

  Language of the Cashier or Operator. If different from the Login.

  ShiftNumberstring

  Shift number. If different from the Login, see Login SaleData.

  SaleTransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  SaleReferenceIDstring

  Identification of a Sale global transaction for a sequence of related POI transactions. If payment reservation.

  SaleTerminalDataobject

  Information related to the software and hardware features of the Sale Terminal. Sent in the Login Request if a Sale Terminal is involved in the login. In other messages, sent when a logical device is out of order (SaleCapabilities) or when other data have changed or were missing in the Login.

  Show childrenHide children

  TotalsGroupIDstring

  Identification of a group of transactions on a POI Terminal, having the same Sale features. Could be used to group POI for reconciliation or other purpose defined by the Sale System. The default value is assigned by the Login Request.

  TokenRequestedTypestring

  Type of token replacing the PAN of a payment card to identify the payment mean of the customer. It allows, for a merchant, to use a token for a transaction only or for a longer period. Possible values:

  • Customer
  • Transaction

  CustomerOrderIDstring

  Additional and optional identification of a customer order.

  CustomerOrderReqarray[string]

  List of customer order open, closed or both to be sent in the response messages. Possible values:

  • Both
  • Closed
  • Open

  SaleToPOIDatastring

  Sale information intended for the POI. Stored with the transaction.

  SaleToAcquirerDatastring

  Sale information intended for the Acquirer. Send to the Acquirer if present.

  SaleToIssuerDataobject

  Sale information intended for the Issuer. The POI System receives this information and sends it to the Acquirer for the Issuer without any change.

  Show childrenHide children

  StatementReferencestring

  Label to print on the bank statement.

  POIDataobject

  Data related to the POI System. In the Message Response, identification of the POI transaction.

  Show childrenHide children

  POITransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  POIReconciliationIDinteger

  Identification of the reconciliation period between Sale and POI. If Result is Success.

  PaymentResultobject

  Data related to the result of a processed payment transaction. If one data element is present.

  Show childrenHide children

  PaymentTypestring

  Type of payment transaction. Elements requested by the Sale System that are related to the payment only. Possible values:

  • CashAdvance
  • CashDeposit
  • Completion
  • FirstReservation
  • Instalment
  • IssuerInstalment
  • Normal
  • OneTimeReservation
  • PaidOut
  • Recurring
  • Refund
  • UpdateReservation

  PaymentInstrumentDataobject

  Data related to the instrument of payment for the transaction. Sent in the result of the payment transaction. For a card, it could also be sent in the CardAcquisition response, to be processed by the Sale System.

  Show childrenHide children

  PaymentInstrumentTypestring

  Type of payment instrument. Possible values:

  • Card
  • Cash
  • Check
  • Mobile
  • StoredValue

  ProtectedCardDatastring

  Sensitive information related to the payment card, protected by CMS. SensitiveCardData protected by CMS EnvelopedData.

  CardDataobject

  Information related to the payment card used for the transaction. Allows acquisition of the card data by the Sale System before the Payment, CardAcquisition, or BalanceInquiry request to the POI. It can also be sent in the CardAcquisition response, to be processed by the Sale System.

  Show childrenHide children

  PaymentBrandstring

  Type of payment card. If card PAN is readable. Indicates the card used to pay in the PaymentResponse. Sent in the CardAcquisitionResponse, to leave the Cashier to choose between several applications in a smartcard, or several brand in a co-branded card. In this case, the CardAcquisitionRequest.ForceCustomerSelectionFlag must contain the value False. Brands are part of the POI and Sale Systems configurations.

  MaskedPanstring

  Masked Primary Account Number Part of the PAN is replaced by a string of * characters, to identify a customer account or relationship. Presence of this data element, which replace the PAN when SensitiveCardData is protected and replaced by ProtectedCardData. Alternatively the MaskedPAN can be used as a token to identify a customer.

  PaymentAccountRefstring

  Reference of the PAN, which identifies the PAN or the card uniquely, named also PAR (Payment Account Reference). This reference may be defined by the card issuer or by a token service provider under the control of the card issuer, and cannot be used for a payment transaction.

  EntryModearray[string]

  Entry mode of the payment instrument information. In the Payment, Loyalty or StoredValue Request messages, it informs the POI System the entry mode of the payment instrument information when read by the Sale Terminal. In the Payment, Loyalty or StoredValue Response messages, it informs the Sale System the entry mode of the payment instrument. Possible values:

  • Contactless
  • File
  • ICC
  • Keyed
  • MagStripe
  • Manual
  • Mobile
  • RFID
  • Scanned
  • SynchronousICC
  • Tapped

  CardCountryCodeinteger

  Minimum: 3Maximum: 3

  Country Code attached to the card (3 numerics). If available in the card.

  ProtectedCardDatastring

  Sensitive information related to the payment card, protected by CMS. SensitiveCardData protected by CMS EnvelopedData.

  SensitiveCardDataobject

  This data structure could be CMS protected (EnvelopedData). In this case the data structure SensitiveCardData is replaced by the data structure ProtectedCardData of type ContentInformationType. When this data is protected, the exact content is unknown by the Sale System, and might include all the information which are required by an external backup POI Server to make a batch payment transaction in case of problem with the POI System. Sensitive information related to the payment card, entered or read by the Sale System.

  Show childrenHide children

  PANinteger

  Minimum: 8Maximum: 28

  Primary Account Number.

  CardSeqNumbinteger

  Minimum: 2Maximum: 3

  Card Sequence Number. If EntryMode is File, Keyed, or Manual.

  ExpiryDateinteger

  Minimum: 4Maximum: 4

  Date after which the card cannot be used. If EntryMode is File.

  TrackDataarray[object]

  Magnetic track or magnetic ink characters line. If EntryMode is MagStripe or RFID .

  Show childrenHide children

  TrackNumbinteger

  Minimum: 1Maximum: 3

  Card track number.

  TrackFormatstring

  Magnetic track or magnetic ink characters line. Possible values:

  • AAMVA
  • ISO

  TrackValuestring

  Card track content.

  AllowedProductCodearray[integer]

  Product codes that are payable by the payment card. If not all the products are accepted for the payment card proposed by the Customer. In this case, Result is failure, ErrorCondition is Payment Restriction. For One Time Reservation, the POI can send product codes payable by the payment, even if the POI did not send SaleItem in the request. If at least one product sent in the request is accepted, the Result is Success. Product codes that are payable by the payment card. If all the products are not accepted for the payment card proposed by the Customer. In this case, Result is failure and ErrorCondition is Payment Restriction. For One Time Reservation, the POI can send product codes payable by the payment, even if the POI did not send SaleItem in the request. If at least one product sent in the request is accepted, the Result is Success.

  AllowedProductarray[object]

  Product that is payable by the payment card.

  Show childrenHide children

  ProductCodeinteger

  Minimum: 1Maximum: 20

  Product code of item purchased with the transaction.

  EanUpcinteger

  Standard product code of item purchased with the transaction.

  ProductLabelstring

  Product name of an item purchased with the transaction.

  AdditionalProductInfostring

  Additionl information related to the line item.

  PaymentTokenobject

  Surrogate of the PAN (Primary Account Number) of the payment card to identify the payment mean of the customer. It allows, for a merchant, to identify the customer.

  Show childrenHide children

  TokenRequestedTypestring

  Type of token replacing the PAN of a payment card to identify the payment mean of the customer. It allows, for a merchant, to use a token for a transaction only or for a longer period. Possible values:

  • Customer
  • Transaction

  TokenValuestring

  Payment token replacing the PAN of the payment card to identify the payment mean of the customer.

  ExpiryDateTimestring

  Expiry date and time. Limits the validity of a payment token.

  CustomerOrderarray[object]

  Customer order attached to a customer, recorded in the POI system. Allows the management of customer orders by the POI, for instance in a multi-channel or a click and collect sale transaction.

  Show childrenHide children

  CustomerOrderIDstring

  Additional and optional identification of a customer order.

  SaleReferenceIDstring

  Identification of a Sale global transaction for a sequence of related POI transactions. Identification of a reservation transaction for the sequence of reservation and the completion.

  OpenOrderStateboolean

  Specifies if a customer order is currently Open. An open customer order is an order waiting for further operations.

  StartDatestring

  Date time of the beginning of an operation.

  EndDatestring

  Date time of the end of an operation.

  ForecastedAmountnumber

  Maximum: 99999999.999999

  Depending on the choice of the sale system it could equal the initial amount of the order or the global amount of the order. If ForecastedAmount equals the initial amount of the order it will allow the system to follow any additional payment. In case of equality with the global amount of the order, the system will then be able to follow remaining amounts.

  CurrentAmountnumber

  Maximum: 99999999.999999

  Total amount of all completed transactions of a customer order.

  Currencystring

  Currency of a monetary amount.

  AccessedBystring

  Identification of an entity accessing data to perform an operation. Allow the synchronisation of customer order processing, when several parts of the Sale System access a customer order at the same time. The Sale entity active on the customer order is identified by this data.

  AdditionalInformationstring

  Unqualified information.

  CheckDataobject

  Information related to the paper check used for the transaction. Allows the check information to be provided by the Sale System before requesting the payment, or stored by the Sale System after processing of the payment.

  Show childrenHide children

  BankIDstring

  Identification of the bank. Mandatory if TrackData absent.

  AccountNumberstring

  Identification of the customer account. Mandatory if TrackData absent.

  CheckNumberstring

  Identification of the bank check. Mandatory if TrackData absent.

  TrackDataobject

  Magnetic track or magnetic ink characters line. ISO 7813 - ISO 4909. Generic data structure for a card track, used when the magstripe card reader is located on the Sale Terminal, or for magstripe Card Reader device request. The data structure is also used to store the line at the bottom of a bank check.

  Show childrenHide children

  TrackNumbinteger

  Minimum: 1Maximum: 3

  Card track number.

  TrackFormatstring

  Magnetic track or magnetic ink characters line. Possible values:

  • AAMVA
  • ISO

  TrackValuestring

  Card track content.

  CheckCardNumberstring

  Check guarantee card number. If provided by the customer.

  TypeCodestring

  Type of bank check. Possible values:

  • Company
  • Personal

  Countrystring

  Country of the bank check. Absent if country of the Sale system.

  MobileDataobject

  Mobile phone is used as a payment instrument for the transaction. Information related to the mobile for the payment transaction.

  Show childrenHide children

  MobileCountryCodeinteger

  Minimum: 3Maximum: 3

  Identifies the country of a mobile phone operator. If data available.

  MobileNetworkCodeinteger

  Minimum: 2Maximum: 3

  Identifies the mobile phone operator inside a country. If data available.

  MaskedMSISDNinteger

  Masked Mobile Subscriber Integrated Service Digital Network. If data available.

  Geolocationobject

  Geographic location specified by geographic or UTM coordinates. If data available.

  Show childrenHide children

  GeographicCoordinatesobject

  Show childrenHide children

  Latitudestring

  Angular distance of a location on the earth south or north of the equator.

  Longitudestring

  Angular measurement of the distance of a location on the earth east or west of the Greenwich observatory.

  UTMCoordinatesobject

  Show childrenHide children

  UTMZonestring

  UTM grid zone combination of the longitude zone (1 to 60) and the latitude band (C to X, excluding I and O).

  UTMEastwardstring

  X-coordinate of the Universal Transverse Mercator coordinate system.

  UTMNorthwardstring

  Y-coordinate of the Universal Transverse Mercator coordinate system.

  ProtectedMobileDatastring

  Sensitive information related to the mobile phone, protected by CMS. SensitiveMobileData.

  SensitiveMobileDataobject

  Sensitive information related to the mobile phone. If unprotected mobile data.

  Show childrenHide children

  MSISDNinteger

  Mobile Subscriber Integrated Service Digital Network (i.e. mobile phone number of the SIM card). Country, National Destination Code, and Subscriber Number.

  IMSIinteger

  International Mobile Subscriber Identity. Unique number associated with the mobile phone user, containing the Mobile Country Code (MCC), the Mobile Network Code (MNC), and the Mobile Identification Number (MSIN)

  IMEIinteger

  International Mobile Equipment Identity. Unique number associated with the mobile phone device.

  StoredValueAccountIDobject

  Identification of the stored value account or the stored value card and the associated product sold by the Sale System for stored value requests.

  Show childrenHide children

  StoredValueAccountTypestring

  Type of stored value account. Allows the distinction of the stored value instrument to access the stored value account. Possible values:

  • GiftCard
  • Other
  • PhoneCard

  StoredValueProviderstring

  Identification of the provider of the stored value account load/reload. When the ProductCode is not sufficient to identify the provider host which delivers the load or reload of the stored value account (for example if it contains the identification of the application.)

  OwnerNamestring

  Name of the owner of a stored value account.

  ExpiryDateinteger

  Minimum: 4Maximum: 4

  Date after which the card cannot be used. If EMV expiry date is present, it overrides Track2 information. Format is MMYY.

  EntryModearray[string]

  Entry mode of the payment instrument information. In the Payment, Loyalty, or StoredValue Request messages, it informs the POI System the entry mode of the payment instrument information when read by the Sale Terminal. (e.g. because the payment instrument information are a barcode read by the Cashier on a scanner device). Possible values:

  • Contactless
  • File
  • ICC
  • Keyed
  • MagStripe
  • Manual
  • Mobile
  • RFID
  • Scanned
  • SynchronousICC
  • Tapped

  IdentificationTypestring

  Type of account identification. In a request message, it informs the POI System the type of the account or card identification, when provided by the Sale Terminal. (e.g. because the card information is a barcode read by the Cashier on a scanner device). In a response message, it informs the Sale System the type of the account or card identification. Possible values:

  • AccountNumber
  • BarCode
  • ISOTrack2
  • PAN
  • PhoneNumber

  StoredValueIDstring

  Stored value account identification. The identification of the stored value account conforming to the IdentificationType.

  AmountsRespobject

  Various amounts related to the payment response from the POI System. Amounts approved by the POI and the Acquirer for the payment and loyalty transaction, containing:

  • The authorised amount to be paid.
  • The amount of the rebates.
  • The amount of financial fees.
  • The cash back part of the requested amount for a payment with cash back.
  • The tip part of the requested amount for a payment with tip.

  Show childrenHide children

  Currencystring

  Currency of a monetary amount.

  AuthorizedAmountnumber

  Maximum: 99999999.999999

  Amount requested by the Sale for the payment.

  TotalRebatesAmountnumber

  Maximum: 99999999.999999

  Sum of rebates in amount (total amount or line item amount) for all the loyalty programs.

  TotalFeesAmountnumber

  Maximum: 99999999.999999

  Total amount of financial fees.

  CashBackAmountnumber

  Maximum: 99999999.999999

  The cash-back part of the amount requested by the Sale for the payment.

  TipAmountnumber

  Maximum: 99999999.999999

  Amount paid for a tip. Allow the printing of the tip on the receipt, and to qualify the tip part of the amount.

  Instalmentobject

  Information related an instalment transaction. To request an instalment to the issuer, or to make individual instalments of a payment transaction.

  Show childrenHide children

  InstalmentTypestring

  Type of instalment transaction. For requesting an instalment payment transaction. Possible values:

  • DeferredInstalments
  • EqualInstalments
  • InequalInstalments

  SequenceNumberinteger

  Sequence number of the instalment. For an instalment payment transaction, number of the payment, from 1 to TotalNbOfPayments.

  PlanIDstring

  Identification of an instalment plan.

  Periodinteger

  Period of time with defined unit of time. A period between 2 payment instalments.

  PeriodUnitstring

  Type of instalment transaction. Possible values:

  • Annual
  • Daily
  • Monthly
  • Weekly

  FirstPaymentDatestring

  First date of a payment. For instalment, the date of the first payments, if not immediate.

  TotalNbOfPaymentsinteger

  Total number of payments. For instalment, the number of payments, including the first one.

  CumulativeAmountnumber

  Maximum: 99999999.999999

  Sum of a collection of amounts. Total amount of the payment instalments.

  FirstAmountnumber

  Maximum: 99999999.999999

  First amount of the payment instalments.

  Chargesnumber

  Maximum: 99999999.999999

  Charges related to a transaction. Charge related to the payment instalments.

  CurrencyConversionarray[object]

  Information related to a currency conversion. A currency conversion occurred in the payment, and the merchant needs to know information related to this conversion (e.g. to print on the sale receipt).

  Show childrenHide children

  CustomerApprovedFlagboolean

  Notify if the customer has approved something. Indicates if the customer has accepted a currency conversion.

  ConvertedAmountobject

  Amount after a currency conversion.

  Show childrenHide children

  AmountValuenumber

  Maximum: 99999999.999999

  Value of an amount.

  Currencystring

  Currency of a monetary amount.

  Ratestring

  Rate of currency conversion.

  Markupstring

  Markup of a currency conversion amount as a percentage.

  Commissionnumber

  Maximum: 99999999.999999

  Commission for a currency conversion.

  Declarationstring

  Declaration to present to the customer or the cashier for validation. If a declaration has to be presented to the customer.

  MerchantOverrideFlagboolean

  Indicates that the Merchant forced the result of the payment to successful. Allows the Sale System to be sure that the payment has been forced.

  CapturedSignatureobject

  Numeric value of a handwritten signature. Contains the value of a handwritten signature, e.g. the signature of a cardholder on the merchant payment receipt. Only one format of the signature is allowed:

  • The size of the pad area where the signature is written, given with the maximum abscissa and ordinate values.
  • The sequence of coordinates where the pen changes direction or lift.

  Show childrenHide children

  AreaSizeobject

  Size of an area. Contain the size of the pad area where the signature is written, given with the maximum abscissa and ordinate values (X and Y). The maximum value is FFFF.

  Show childrenHide children

  Xstring

  Abscissa of a point coordinates. The hexadecimal value in text of the abscissa of the coordinates of a point. Leading zero can be removed (e.g. 3BC, 0, and 1287).

  Ystring

  Ordinate of a point coordinates. The hexadecimal value in text of the ordinate of the coordinates of a point. Leading zero can be removed (e.g. 3BC, 0, and 1287).

  SignaturePointarray[object]

  Coordinates of a point where the pen changes direction or lift. Contain the Coordinates of a point of the written signature where the pen changes direction or lift where (X and Y). When the signer lifts the pen, both X and Y have the value FFFF.

  Show childrenHide children

  Xstring

  The hexadecimal value of the coordinates of a point on the abscissa.

  Ystring

  The hexadecimal value of the coordinates of a point on the ordinate.

  ProtectedSignaturestring

  Numeric value of a handwritten signature. Contains the value of a handwritten signature, e.g. the signature of a cardholder on the merchant payment receipt. The format before encryption is the encoded data structure CapturedSignature. The data structure before encryption includes the start and end tags for an XML encoding, the identifier and length bytes for an ASN.1 encoding, and the complete member ProtectedSignature for a JSON encoding.

  OnlineFlagboolean

  Indicate that the payment transaction processing has required the approval of a host. Allows the Sale System to know if the payment was online or offline.

  AuthenticationMethodarray[string]

  Method for customer authentication. Allows the Sale System informed about customer authentication for the payment transaction. Possible values:

  • Bypass
  • ManualVerification
  • MerchantAuthentication
  • OfflinePIN
  • OnlinePIN
  • PaperSignature
  • SecureCertificate
  • SecureNoCertificate
  • SecuredChannel
  • SignatureCapture
  • UnknownMethod

  ValidityDatestring

  End of the validity period for the reservation, for the first reservation, and the reservation updates as well.

  PaymentAcquirerDataobject

  Data related to the response from the payment Acquirer.

  Show childrenHide children

  AcquirerIDinteger

  Identification of the Acquirer. Identification of the Acquirer when the POI System is multi-acquirer.

  MerchantIDstring

  Identification of the Merchant for the Acquirer.

  AcquirerPOIIDstring

  Identification of the POI for the payment Acquirer.

  AcquirerTransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  ApprovalCodestring

  Code assigned to a transaction approval by the Acquirer. If available.

  HostReconciliationIDstring

  Identifier of a reconciliation period with a payment or loyalty host. Allows the assignment of a transaction to the Acquirer reconciliation (or batch).

  LoyaltyResultarray[object]

  Data related to the result of a processed loyalty transaction. Loyalty cards used with the payment transaction.

  Show childrenHide children

  LoyaltyAccountobject

  This data structure conveys the identification of the account and the associated loyalty brand. Data related to a loyalty account processed in the transaction.

  Show childrenHide children

  LoyaltyAccountIDobject

  Identification of a Loyalty account. In the Payment or the Loyalty Request message, it allows to identify the loyalty account by the Sale Terminal instead of the POI Terminal (e.g. because the account identification is a bar-code read by the Cashier on a scanner device).

  Show childrenHide children

  EntryModearray[string]

  Entry mode of the payment instrument information. In the Payment, Loyalty or StoredValue Request messages, it informs the POI System the entry mode of the payment instrument information when read by the Sale Terminal. In the Payment, Loyalty or StoredValue Response messages, it informs the Sale System the entry mode of the payment instrument. Possible values:

  • Contactless
  • File
  • ICC
  • Keyed
  • MagStripe
  • Manual
  • Mobile
  • RFID
  • Scanned
  • SynchronousICC
  • Tapped

  IdentificationTypestring

  Type of account identification. In a request message, it informs the POI System the type of the account or card identification, when provided by the Sale Terminal. (e.g. because the card information is a barcode read by the Cashier on a scanner device). In a response message, it informs the Sale System the type of the account or card identification. Possible values:

  • AccountNumber
  • BarCode
  • ISOTrack2
  • PAN
  • PhoneNumber

  IdentificationSupportstring

  Support of the loyalty account identification. Allows knowing where and how you have found the loyalty account identification. Possible values:

  • HybridCard
  • LinkedCard
  • LoyaltyCard
  • NoCard

  LoyaltyIDstring

  Loyalty account identification conforming to the IdentificationType.

  LoyaltyBrandstring

  Identification of a Loyalty brand. If a card is analysed.

  CurrentBalancenumber

  Maximum: 99999999.999999

  Balance of an account. If known (provided by the card or an external host).

  LoyaltyAmountobject

  Amount of a loyalty account. An awarded amount or an amount to redeem to the loyalty account might be sent in the Payment request message.

  Show childrenHide children

  LoyaltyUnitstring

  Unit of a loyalty amount. The amount could be expressed in point or in a monetary value and a currency. Possible values:

  • Monetary
  • Point

  Currencystring

  Currency of a monetary amount.

  AmountValuenumber

  Maximum: 99999999.999999

  Value of an amount.

  LoyaltyAcquirerDataobject

  Data related to the loyalty Acquirer during a loyalty transaction. If content not empty.

  Show childrenHide children

  LoyaltyAcquirerIDstring

  Identification of the loyalty Acquirer.

  ApprovalCodestring

  Code assigned to a transaction approval by the Acquirer. Could be an identifier of the approved transaction for the Acquirer. This data element is conditional for the Loyalty Acquirers. Used in the PaymentRequest request for a referral.

  LoyaltyTransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  HostReconciliationIDstring

  Identifier of a reconciliation period with a payment or loyalty host. Allows the assignment of a transaction to the Acquirer reconciliation (or batch).

  Rebatesobject

  Rebate form to an award. If rebates awarded.

  Show childrenHide children

  TotalRebatenumber

  Maximum: 99999999.999999

  The global awarded amount that is not attached to an item.

  RebateLabelstring

  Short text to qualify a rebate on an line item. Text to be printed on a receipt in front of the rebate on an item or the rebate on the totals.

  SaleItemRebatearray[object]

  The awarded amount that is attached to an item as a rebate. To be differentiated from the award which is the amount or quantity earned on the loyalty account.

  Show childrenHide children

  ItemIDinteger

  Item identification inside a transaction (0 to n).

  ProductCodeinteger

  Minimum: 1Maximum: 20

  Product code of item purchased with the transaction.

  EanUpcinteger

  Standard product code of item purchased with the transaction.

  UnitOfMeasurestring

  Unit of measure of a quantity. If Quantity present. Possible values:

  • Case
  • Centilitre
  • Centimetre
  • Foot
  • Gram
  • Inch
  • Kilogram
  • Kilometre
  • Litre
  • Meter
  • Mile
  • Other
  • Ounce
  • Pint
  • Pound
  • Quart
  • UKGallon
  • USGallon
  • Yard

  Quantitystring

  Product quantity. If rebate is additional units.

  ItemAmountnumber

  Maximum: 99999999.999999

  Total amount of the item line. If rebate on the line item amount.

  RebateLabelstring

  Short text to qualify a rebate on an line item. If provided by the Acquirer.

  PaymentReceiptarray[object]

  Customer or Merchant payment receipt. If the payment receipts are printed by the Sale system and the POI or the Sale does not implement the Print exchange (Basic profile).

  Show childrenHide children

  DocumentQualifierstring

  Qualification of the document to print to the Cashier or the Customer. SaleReceipt or CashierReceipt. Possible values:

  • CashierReceipt
  • CustomerReceipt
  • Document
  • Journal
  • SaleReceipt
  • Voucher

  IntegratedPrintFlagboolean

  Type of the print integrated to other prints.

  RequiredSignatureFlagboolean

  Indicate that the cardholder payment receipt requires a physical signature by the Customer.

  OutputContentobject

  Content to display or print. This is a sequence of elements if they have different formats.

  Show childrenHide children

  OutputFormatstring

  Format of the content to display or print. Display or print device function. Possible values:

  • BarCode
  • MessageRef
  • Text
  • XHTML

  PredefinedContentobject

  Reference of a predefined message to display or print. It conveys information related to the predefined message.

  Show childrenHide children

  ReferenceIDstring

  Identification of a predefined message to display or print.

  Languagestring

  Identification of a language.

  OutputTextarray[object]

  Content of text message to display or print. Mandatory, if OutputFormat is Text, not allowed otherwise. One instance of OutputText per shared format.

  Show childrenHide children

  Textstring

  Content of text message to display, print or play.

  CharacterSetinteger

  Character height of the text string to display or print. Absence of this data element means the characters have normal height.

  Fontstring

  Name of the font. Used to change character font of the output, as agreed between the POI and Sale Systems.

  StartRowinteger

  Minimum: 1Maximum: 500

  Row where the text string has to be displayed or printed.

  StartColumninteger

  Minimum: 1Maximum: 500

  Column where the text string has to be displayed or printed.

  Colorstring

  Color of the text string to display or print. Possible values:

  • Black
  • Blue
  • Cyan
  • Green
  • Magenta
  • Red
  • White
  • Yellow

  CharacterWidthstring

  Character width of the text string to display or print. Absence of this data element means the characters have normal width. Possible values:

  • DoubleWidth
  • SingleWidth

  CharacterHeightstring

  Character height of the text string to display or print. Absence of this data element means the characters have normal height. Possible values:

  • DoubleHeight
  • HalfHeight
  • SingleHeight

  CharacterStylestring

  Typographic style of the sequence of characters to display or print. Absence of this data element means the characters have normal style. Possible values:

  • Bold
  • Italic
  • Normal
  • Underline

  Alignmentstring

  Alignment of the text string on the display line or print line. Absence of this data element means the characters have normal alignment. Possible values:

  • Centred
  • Justified
  • Left
  • Right

  EndOfLineFlagboolean

  Indicates if the text is at the end of a line. Allows the display or the print of a new line and a carry-over return characters after the formatted text.

  OutputXHTMLstring

  XHTML document body containing the message to display or print. Mandatory if OutputFormat is XHTML, not allowed otherwise.

  OutputBarcodeobject

  Barcode content to display or print. Mandatory if OutputFormat is Barcode, not allowed otherwise.

  Show childrenHide children

  BarcodeTypestring

  Type of Barcode coding. Qualification of the barcode value to display or print. Possible values:

  • Code128
  • Code25
  • EAN13
  • EAN8
  • PDF417
  • QRCode
  • UPCA

  BarcodeValuestring

  Value with a Barcode coding. The barcode value to display or print.

  CustomerOrderarray[object]

  Show childrenHide children

  CustomerOrderIDstring

  Additional and optional identification of a customer order.

  SaleReferenceIDstring

  Identification of a Sale global transaction for a sequence of related POI transactions. Identification of a reservation transaction for the sequence of reservation and the completion.

  OpenOrderStateboolean

  Specifies if a customer order is currently Open. An open customer order is an order waiting for further operations.

  StartDatestring

  Date time of the beginning of an operation.

  EndDatestring

  Date time of the end of an operation.

  ForecastedAmountnumber

  Maximum: 99999999.999999

  Depending on the choice of the sale system it could equal the initial amount of the order or the global amount of the order. If ForecastedAmount equals the initial amount of the order it will allow the system to follow any additional payment. In case of equality with the global amount of the order, the system will then be able to follow remaining amounts.

  CurrentAmountnumber

  Maximum: 99999999.999999

  Total amount of all completed transactions of a customer order.

  Currencystring

  Currency of a monetary amount.

  AccessedBystring

  Identification of an entity accessing data to perform an operation. Allow the synchronisation of customer order processing, when several parts of the Sale System access a customer order at the same time. The Sale entity active on the customer order is identified by this data.

  AdditionalInformationstring

  Unqualified information.

  ReversalResponseobject

  It conveys Information related to the reversal processed by the POI System. Content of the Reversal Response message.

  Show childrenHide children

  Responseobject

  Result of a message request processing. If Result is Success, ErrorCondition is absent or not used in the processing of the message. In the other cases, the ErrorCondition has to be present and can refine the processing of the message response. AdditionalResponse gives more information about the success or the failure of the message request processing, for logging without real time involvements.

  Show childrenHide children

  Resultstring

  Result of the processing of the message. Possible values:

  • Failure
  • Partial
  • Success

  ErrorConditionstring

  Condition that has produced an error on the processing of a message request. Returned if Result is not Success. Possible values:

  • Aborted
  • Busy
  • Cancel
  • DeviceOut
  • InProgress
  • InsertedCard
  • InvalidCard
  • LoggedOut
  • MessageFormat
  • NotAllowed
  • NotFound
  • PaymentRestriction
  • Refusal
  • UnavailableDevice
  • UnavailableService
  • UnreachableHost
  • WrongPIN

  AdditionalResponsestring

  Additional information related to processing status of a message request. If present, the POI logs it for further examination.

  POIDataobject

  Data related to the POI System. In the Message Response, identification of the POI transaction.

  Show childrenHide children

  POITransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  POIReconciliationIDinteger

  Identification of the reconciliation period between Sale and POI. If Result is Success.

  OriginalPOITransactionobject

  Identification of a previous POI transaction. In the Payment or the Loyalty Request message, it allows using the card of a previous CardAcquisition or Payment/Loyalty request.

  Show childrenHide children

  SaleIDstring

  Identification of a Sale System for the NEXO SaletoPOI protocol.

  POIIDstring

  Identification of a payment terminal for the NEXO SaletoPOI protocol. If original transaction is coming from another POI.

  POITransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  ReuseCardDataFlagboolean

  Indicates if the card data has to be retrieved from a previous transaction.

  ApprovalCodestring

  Code assigned to a transaction approval by the Acquirer. If referral.

  AcquirerIDinteger

  Identification of the Acquirer. Restrict to the Acquirer if present.

  AmountValuenumber

  Maximum: 99999999.999999

  Value of an amount.

  HostTransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  ReversedAmountnumber

  Maximum: 99999999.999999

  Amount of the payment or loyalty to reverse.. Copy.

  CustomerOrderarray[object]

  Show childrenHide children

  CustomerOrderIDstring

  Additional and optional identification of a customer order.

  SaleReferenceIDstring

  Identification of a Sale global transaction for a sequence of related POI transactions. Identification of a reservation transaction for the sequence of reservation and the completion.

  OpenOrderStateboolean

  Specifies if a customer order is currently Open. An open customer order is an order waiting for further operations.

  StartDatestring

  Date time of the beginning of an operation.

  EndDatestring

  Date time of the end of an operation.

  ForecastedAmountnumber

  Maximum: 99999999.999999

  Depending on the choice of the sale system it could equal the initial amount of the order or the global amount of the order. If ForecastedAmount equals the initial amount of the order it will allow the system to follow any additional payment. In case of equality with the global amount of the order, the system will then be able to follow remaining amounts.

  CurrentAmountnumber

  Maximum: 99999999.999999

  Total amount of all completed transactions of a customer order.

  Currencystring

  Currency of a monetary amount.

  AccessedBystring

  Identification of an entity accessing data to perform an operation. Allow the synchronisation of customer order processing, when several parts of the Sale System access a customer order at the same time. The Sale entity active on the customer order is identified by this data.

  AdditionalInformationstring

  Unqualified information.

  PaymentReceiptarray[object]

  Show childrenHide children

  DocumentQualifierstring

  Qualification of the document to print to the Cashier or the Customer. SaleReceipt or CashierReceipt. Possible values:

  • CashierReceipt
  • CustomerReceipt
  • Document
  • Journal
  • SaleReceipt
  • Voucher

  IntegratedPrintFlagboolean

  Type of the print integrated to other prints.

  RequiredSignatureFlagboolean

  Indicate that the cardholder payment receipt requires a physical signature by the Customer.

  OutputContentobject

  Content to display or print. This is a sequence of elements if they have different formats.

  Show childrenHide children

  OutputFormatstring

  Format of the content to display or print. Display or print device function. Possible values:

  • BarCode
  • MessageRef
  • Text
  • XHTML

  PredefinedContentobject

  Reference of a predefined message to display or print. It conveys information related to the predefined message.

  Show childrenHide children

  ReferenceIDstring

  Identification of a predefined message to display or print.

  Languagestring

  Identification of a language.

  OutputTextarray[object]

  Content of text message to display or print. Mandatory, if OutputFormat is Text, not allowed otherwise. One instance of OutputText per shared format.

  Show childrenHide children

  Textstring

  Content of text message to display, print or play.

  CharacterSetinteger

  Character height of the text string to display or print. Absence of this data element means the characters have normal height.

  Fontstring

  Name of the font. Used to change character font of the output, as agreed between the POI and Sale Systems.

  StartRowinteger

  Minimum: 1Maximum: 500

  Row where the text string has to be displayed or printed.

  StartColumninteger

  Minimum: 1Maximum: 500

  Column where the text string has to be displayed or printed.

  Colorstring

  Color of the text string to display or print. Possible values:

  • Black
  • Blue
  • Cyan
  • Green
  • Magenta
  • Red
  • White
  • Yellow

  CharacterWidthstring

  Character width of the text string to display or print. Absence of this data element means the characters have normal width. Possible values:

  • DoubleWidth
  • SingleWidth

  CharacterHeightstring

  Character height of the text string to display or print. Absence of this data element means the characters have normal height. Possible values:

  • DoubleHeight
  • HalfHeight
  • SingleHeight

  CharacterStylestring

  Typographic style of the sequence of characters to display or print. Absence of this data element means the characters have normal style. Possible values:

  • Bold
  • Italic
  • Normal
  • Underline

  Alignmentstring

  Alignment of the text string on the display line or print line. Absence of this data element means the characters have normal alignment. Possible values:

  • Centred
  • Justified
  • Left
  • Right

  EndOfLineFlagboolean

  Indicates if the text is at the end of a line. Allows the display or the print of a new line and a carry-over return characters after the formatted text.

  OutputXHTMLstring

  XHTML document body containing the message to display or print. Mandatory if OutputFormat is XHTML, not allowed otherwise.

  OutputBarcodeobject

  Barcode content to display or print. Mandatory if OutputFormat is Barcode, not allowed otherwise.

  Show childrenHide children

  BarcodeTypestring

  Type of Barcode coding. Qualification of the barcode value to display or print. Possible values:

  • Code128
  • Code25
  • EAN13
  • EAN8
  • PDF417
  • QRCode
  • UPCA

  BarcodeValuestring

  Value with a Barcode coding. The barcode value to display or print.

  StoredValueResponseobject

  It conveys Information related to the Stored Value transaction processed by the POI System. Content of the Stored Value Response message.

  Show childrenHide children

  Responseobject

  Result of a message request processing. If Result is Success, ErrorCondition is absent or not used in the processing of the message. In the other cases, the ErrorCondition has to be present and can refine the processing of the message response. AdditionalResponse gives more information about the success or the failure of the message request processing, for logging without real time involvements.

  Show childrenHide children

  Resultstring

  Result of the processing of the message. Possible values:

  • Failure
  • Partial
  • Success

  ErrorConditionstring

  Condition that has produced an error on the processing of a message request. Returned if Result is not Success. Possible values:

  • Aborted
  • Busy
  • Cancel
  • DeviceOut
  • InProgress
  • InsertedCard
  • InvalidCard
  • LoggedOut
  • MessageFormat
  • NotAllowed
  • NotFound
  • PaymentRestriction
  • Refusal
  • UnavailableDevice
  • UnavailableService
  • UnreachableHost
  • WrongPIN

  AdditionalResponsestring

  Additional information related to processing status of a message request. If present, the POI logs it for further examination.

  SaleDataobject

  Data associated with the Sale System, with a particular value during the processing of the payment by the POI, including the cards acquisition.

  Show childrenHide children

  OperatorIDstring

  Identification of the Cashier or Operator.

  OperatorLanguagestring

  Language of the Cashier or Operator. If different from the Login.

  ShiftNumberstring

  Shift number. If different from the Login, see Login SaleData.

  SaleTransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  SaleReferenceIDstring

  Identification of a Sale global transaction for a sequence of related POI transactions. If payment reservation.

  SaleTerminalDataobject

  Information related to the software and hardware features of the Sale Terminal. Sent in the Login Request if a Sale Terminal is involved in the login. In other messages, sent when a logical device is out of order (SaleCapabilities) or when other data have changed or were missing in the Login.

  Show childrenHide children

  TotalsGroupIDstring

  Identification of a group of transactions on a POI Terminal, having the same Sale features. Could be used to group POI for reconciliation or other purpose defined by the Sale System. The default value is assigned by the Login Request.

  TokenRequestedTypestring

  Type of token replacing the PAN of a payment card to identify the payment mean of the customer. It allows, for a merchant, to use a token for a transaction only or for a longer period. Possible values:

  • Customer
  • Transaction

  CustomerOrderIDstring

  Additional and optional identification of a customer order.

  CustomerOrderReqarray[string]

  List of customer order open, closed or both to be sent in the response messages. Possible values:

  • Both
  • Closed
  • Open

  SaleToPOIDatastring

  Sale information intended for the POI. Stored with the transaction.

  SaleToAcquirerDatastring

  Sale information intended for the Acquirer. Send to the Acquirer if present.

  SaleToIssuerDataobject

  Sale information intended for the Issuer. The POI System receives this information and sends it to the Acquirer for the Issuer without any change.

  Show childrenHide children

  StatementReferencestring

  Label to print on the bank statement.

  POIDataobject

  Data related to the POI System. In the Message Response, identification of the POI transaction.

  Show childrenHide children

  POITransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  POIReconciliationIDinteger

  Identification of the reconciliation period between Sale and POI. If Result is Success.

  StoredValueResultarray[object]

  Result of loading/reloading a stored value card.. If StoredValueResponse.Result is Success or Partial, one entry per StoredValueRequest.StoredValueData loaded or activated.

  Show childrenHide children

  StoredValueTransactionTypestring

  Identification of operation to proceed on the stored value account or the stored value card. Copy. Possible values:

  • Activate
  • Duplicate
  • Load
  • Reserve
  • Reverse
  • Unload

  ProductCodeinteger

  Minimum: 1Maximum: 20

  Product code of item purchased with the transaction. Copy.

  EanUpcinteger

  Standard product code of item purchased with the transaction. Copy.

  ItemAmountnumber

  Maximum: 99999999.999999

  Total amount of the item line.

  Currencystring

  Currency of a monetary amount. Copy.

  StoredValueAccountStatusobject

  Data related to the result of the stored value card transaction.

  Show childrenHide children

  StoredValueAccountIDobject

  Identification of the stored value account or the stored value card and the associated product sold by the Sale System for stored value requests.

  Show childrenHide children

  StoredValueAccountTypestring

  Type of stored value account. Allows the distinction of the stored value instrument to access the stored value account. Possible values:

  • GiftCard
  • Other
  • PhoneCard

  StoredValueProviderstring

  Identification of the provider of the stored value account load/reload. When the ProductCode is not sufficient to identify the provider host which delivers the load or reload of the stored value account (for example if it contains the identification of the application.)

  OwnerNamestring

  Name of the owner of a stored value account.

  ExpiryDateinteger

  Minimum: 4Maximum: 4

  Date after which the card cannot be used. If EMV expiry date is present, it overrides Track2 information. Format is MMYY.

  EntryModearray[string]

  Entry mode of the payment instrument information. In the Payment, Loyalty, or StoredValue Request messages, it informs the POI System the entry mode of the payment instrument information when read by the Sale Terminal. (e.g. because the payment instrument information are a barcode read by the Cashier on a scanner device). Possible values:

  • Contactless
  • File
  • ICC
  • Keyed
  • MagStripe
  • Manual
  • Mobile
  • RFID
  • Scanned
  • SynchronousICC
  • Tapped

  IdentificationTypestring

  Type of account identification. In a request message, it informs the POI System the type of the account or card identification, when provided by the Sale Terminal. (e.g. because the card information is a barcode read by the Cashier on a scanner device). In a response message, it informs the Sale System the type of the account or card identification. Possible values:

  • AccountNumber
  • BarCode
  • ISOTrack2
  • PAN
  • PhoneNumber

  StoredValueIDstring

  Stored value account identification. The identification of the stored value account conforming to the IdentificationType.

  CurrentBalancenumber

  Maximum: 99999999.999999

  If relevant and known.

  HostTransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  PaymentReceiptarray[object]

  Show childrenHide children

  DocumentQualifierstring

  Qualification of the document to print to the Cashier or the Customer. SaleReceipt or CashierReceipt. Possible values:

  • CashierReceipt
  • CustomerReceipt
  • Document
  • Journal
  • SaleReceipt
  • Voucher

  IntegratedPrintFlagboolean

  Type of the print integrated to other prints.

  RequiredSignatureFlagboolean

  Indicate that the cardholder payment receipt requires a physical signature by the Customer.

  OutputContentobject

  Content to display or print. This is a sequence of elements if they have different formats.

  Show childrenHide children

  OutputFormatstring

  Format of the content to display or print. Display or print device function. Possible values:

  • BarCode
  • MessageRef
  • Text
  • XHTML

  PredefinedContentobject

  Reference of a predefined message to display or print. It conveys information related to the predefined message.

  Show childrenHide children

  ReferenceIDstring

  Identification of a predefined message to display or print.

  Languagestring

  Identification of a language.

  OutputTextarray[object]

  Content of text message to display or print. Mandatory, if OutputFormat is Text, not allowed otherwise. One instance of OutputText per shared format.

  Show childrenHide children

  Textstring

  Content of text message to display, print or play.

  CharacterSetinteger

  Character height of the text string to display or print. Absence of this data element means the characters have normal height.

  Fontstring

  Name of the font. Used to change character font of the output, as agreed between the POI and Sale Systems.

  StartRowinteger

  Minimum: 1Maximum: 500

  Row where the text string has to be displayed or printed.

  StartColumninteger

  Minimum: 1Maximum: 500

  Column where the text string has to be displayed or printed.

  Colorstring

  Color of the text string to display or print. Possible values:

  • Black
  • Blue
  • Cyan
  • Green
  • Magenta
  • Red
  • White
  • Yellow

  CharacterWidthstring

  Character width of the text string to display or print. Absence of this data element means the characters have normal width. Possible values:

  • DoubleWidth
  • SingleWidth

  CharacterHeightstring

  Character height of the text string to display or print. Absence of this data element means the characters have normal height. Possible values:

  • DoubleHeight
  • HalfHeight
  • SingleHeight

  CharacterStylestring

  Typographic style of the sequence of characters to display or print. Absence of this data element means the characters have normal style. Possible values:

  • Bold
  • Italic
  • Normal
  • Underline

  Alignmentstring

  Alignment of the text string on the display line or print line. Absence of this data element means the characters have normal alignment. Possible values:

  • Centred
  • Justified
  • Left
  • Right

  EndOfLineFlagboolean

  Indicates if the text is at the end of a line. Allows the display or the print of a new line and a carry-over return characters after the formatted text.

  OutputXHTMLstring

  XHTML document body containing the message to display or print. Mandatory if OutputFormat is XHTML, not allowed otherwise.

  OutputBarcodeobject

  Barcode content to display or print. Mandatory if OutputFormat is Barcode, not allowed otherwise.

  Show childrenHide children

  BarcodeTypestring

  Type of Barcode coding. Qualification of the barcode value to display or print. Possible values:

  • Code128
  • Code25
  • EAN13
  • EAN8
  • PDF417
  • QRCode
  • UPCA

  BarcodeValuestring

  Value with a Barcode coding. The barcode value to display or print.

  CardAcquisitionResponseobject

  It conveys Information related to the payment and loyalty cards read and processed by the POI System and entered by the Customer. Content of the Card Acquisition Response message.

  Show childrenHide children

  Responseobject

  Result of a message request processing. If Result is Success, ErrorCondition is absent or not used in the processing of the message. In the other cases, the ErrorCondition has to be present and can refine the processing of the message response. AdditionalResponse gives more information about the success or the failure of the message request processing, for logging without real time involvements.

  Show childrenHide children

  Resultstring

  Result of the processing of the message. Possible values:

  • Failure
  • Partial
  • Success

  ErrorConditionstring

  Condition that has produced an error on the processing of a message request. Returned if Result is not Success. Possible values:

  • Aborted
  • Busy
  • Cancel
  • DeviceOut
  • InProgress
  • InsertedCard
  • InvalidCard
  • LoggedOut
  • MessageFormat
  • NotAllowed
  • NotFound
  • PaymentRestriction
  • Refusal
  • UnavailableDevice
  • UnavailableService
  • UnreachableHost
  • WrongPIN

  AdditionalResponsestring

  Additional information related to processing status of a message request. If present, the POI logs it for further examination.

  SaleDataobject

  Data associated with the Sale System, with a particular value during the processing of the payment by the POI, including the cards acquisition.

  Show childrenHide children

  OperatorIDstring

  Identification of the Cashier or Operator.

  OperatorLanguagestring

  Language of the Cashier or Operator. If different from the Login.

  ShiftNumberstring

  Shift number. If different from the Login, see Login SaleData.

  SaleTransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  SaleReferenceIDstring

  Identification of a Sale global transaction for a sequence of related POI transactions. If payment reservation.

  SaleTerminalDataobject

  Information related to the software and hardware features of the Sale Terminal. Sent in the Login Request if a Sale Terminal is involved in the login. In other messages, sent when a logical device is out of order (SaleCapabilities) or when other data have changed or were missing in the Login.

  Show childrenHide children

  TotalsGroupIDstring

  Identification of a group of transactions on a POI Terminal, having the same Sale features. Could be used to group POI for reconciliation or other purpose defined by the Sale System. The default value is assigned by the Login Request.

  TokenRequestedTypestring

  Type of token replacing the PAN of a payment card to identify the payment mean of the customer. It allows, for a merchant, to use a token for a transaction only or for a longer period. Possible values:

  • Customer
  • Transaction

  CustomerOrderIDstring

  Additional and optional identification of a customer order.

  CustomerOrderReqarray[string]

  List of customer order open, closed or both to be sent in the response messages. Possible values:

  • Both
  • Closed
  • Open

  SaleToPOIDatastring

  Sale information intended for the POI. Stored with the transaction.

  SaleToAcquirerDatastring

  Sale information intended for the Acquirer. Send to the Acquirer if present.

  SaleToIssuerDataobject

  Sale information intended for the Issuer. The POI System receives this information and sends it to the Acquirer for the Issuer without any change.

  Show childrenHide children

  StatementReferencestring

  Label to print on the bank statement.

  POIDataobject

  Data related to the POI System. In the Message Response, identification of the POI transaction.

  Show childrenHide children

  POITransactionIDobject

  Identification of a transaction for the Sale System or the POI System.

  Show childrenHide children

  TransactionIDstring

  Unique identification of a transaction to identify the transaction on the Sale System (e.g. ticket number), or the POI System.

  TimeStampstring

  Date and time of a transaction for the Sale System, the POI System or the Acquirer. Ensures the uniqueness of a transaction and indicates the time when the event occurs in the EventNotification message.

  POIReconciliationIDinteger

  Identification of the reconciliation period between Sale and POI. If Result is Success.

  PaymentBrandarray[string]

  Type of payment card. Brands available for payment by the card and not chosen by the Customer.

  PaymentInstrumentDataobject

  Data related to the instrument of payment for the transaction. Sent in the result of the payment transaction. For a card, it could also be sent in the CardAcquisition response, to be processed by the Sale System.

  Show childrenHide children

  PaymentInstrumentTypestring

  Type of payment instrument. Possible values:

  • Card
  • Cash
  • Check
  • Mobile
  • StoredValue

  ProtectedCardDatastring

  Sensitive information related to the payment card, protected by CMS. SensitiveCardData protected by CMS EnvelopedData.

  CardDataobject

  Information related to the payment card used for the transaction. Allows acquisition of the card data by the Sale System before the Payment, CardAcquisition, or BalanceInquiry request to the POI. It can also be sent in the CardAcquisition response, to be processed by the Sale System.

  Show childrenHide children

  PaymentBrandstring

  Type of payment card. If card PAN is readable. Indicates the card used to pay in the PaymentResponse. Sent in the CardAcquisitionResponse, to leave the Cashier to choose between several applications in a smartcard, or several brand in a co-branded card. In this case, the CardAcquisitionRequest.ForceCustomerSelectionFlag must contain the value False. Brands are part of the POI and Sale Systems configurations.

  MaskedPanstring

  Masked Primary Account Number Part of the PAN is replaced by a string of * characters, to identify a customer account or relationship. Presence of this data element, which replace the PAN when SensitiveCardData is protected and replaced by ProtectedCardData. Alternatively the MaskedPAN can be used as a token to identify a customer.

  PaymentAccountRefstring

  Reference of the PAN, which identifies the PAN or the card uniquely, named also PAR (Payment Account Reference). This reference may be defined by the card issuer or by a token service provider under the control of the card issuer, and cannot be used for a payment transaction.

  EntryModearray[string]

  Entry mode of the payment instrument information. In the Payment, Loyalty or StoredValue Request messages, it informs the POI System the entry mode of the payment instrument information when read by the Sale Terminal. In the Payment, Loyalty or StoredValue Response messages, it informs the Sale System the entry mode of the payment instrument. Possible values:

  • Contactless
  • File
  • ICC
  • Keyed
  • MagStripe
  • Manual
  • Mobile
  • RFID
  • Scanned
  • SynchronousICC
  • Tapped

  CardCountryCodeinteger

  Minimum: 3Maximum: 3

  Country Code attached to the card (3 numerics). If available in the card.

  ProtectedCardDatastring

  Sensitive information related to the payment card, protected by CMS. SensitiveCardData protected by CMS EnvelopedData.

  SensitiveCardDataobject

  This data structure could be CMS protected (EnvelopedData). In this case the data structure SensitiveCardData is replaced by the data structure ProtectedCardData of type ContentInformationType. When this data is protected, the exact content is unknown by the Sale System, and might include all the information which are required by an external backup POI Server to make a batch payment transaction in case of problem with the POI System. Sensitive information related to the payment card, entered or read by the Sale System.

  Show childrenHide children

  PANinteger

  Minimum: 8Maximum: 28

  Primary Account Number.

  CardSeqNumbinteger

  Minimum: 2Maximum: 3

  Card Sequence Number. If EntryMode is File, Keyed, or Manual.

  ExpiryDateinteger

  Minimum: 4Maximum: 4

  Date after which the card cannot be used. If EntryMode is File.

  TrackDataarray[object]

  Magnetic track or magnetic ink characters line. If EntryMode is MagStripe or RFID .

  Show childrenHide children

  TrackNumbinteger

  Minimum: 1Maximum: 3

  Card track number.

  TrackFormatstring

  Magnetic track or magnetic ink characters line. Possible values:

  • AAMVA
  • ISO

  TrackValuestring

  Card track content.

  AllowedProductCodearray[integer]

  Product codes that are payable by the payment card. If not all the products are accepted for the payment card proposed by the Customer. In this case, Result is failure, ErrorCondition is Payment Restriction. For One Time Reservation, the POI can send product codes payable by the payment, even if the POI did not send SaleItem in the request. If at least one product sent in the request is accepted, the Result is Success. Product codes that are payable by the payment card. If all the products are not accepted for the payment card proposed by the Customer. In this case, Result is failure and ErrorCondition is Payment Restriction. For One Time Reservation, the POI can send product codes payable by the payment, even if the POI did not send SaleItem in the request. If at least one product sent in the request is accepted, the Result is Success.

  AllowedProductarray[object]

  Product that is payable by the payment card.

  Show childrenHide children

  ProductCodeinteger

  Minimum: 1Maximum: 20

  Product code of item purchased with the transaction.

  EanUpcinteger

  Standard product code of item purchased with the transaction.

  ProductLabelstring

  Product name of an item purchased with the transaction.

  AdditionalProductInfostring

  Additionl information related to the line item.

  PaymentTokenobject

  Surrogate of the PAN (Primary Account Number) of the payment card to identify the payment mean of the customer. It allows, for a merchant, to identify the customer.

  Show childrenHide children

  TokenRequestedTypestring

  Type of token replacing the PAN of a payment card to identify the payment mean of the customer. It allows, for a merchant, to use a token for a transaction only or for a longer period. Possible values:

  • Customer
  • Transaction

  TokenValuestring

  Payment token replacing the PAN of the payment card to identify the payment mean of the customer.

  ExpiryDateTimestring

  Expiry date and time. Limits the validity of a payment token.

  CustomerOrderarray[object]

  Customer order attached to a customer, recorded in the POI system. Allows the management of customer orders by the POI, for instance in a multi-channel or a click and collect sale transaction.

  Show childrenHide children

  CustomerOrderIDstring

  Additional and optional identification of a customer order.

  SaleReferenceIDstring

  Identification of a Sale global transaction for a sequence of related POI transactions. Identification of a reservation transaction for the sequence of reservation and the completion.

  OpenOrderStateboolean

  Specifies if a customer order is currently Open. An open customer order is an order waiting for further operations.

  StartDatestring

  Date time of the beginning of an operation.

  EndDatestring

  Date time of the end of an operation.

  ForecastedAmountnumber

  Maximum: 99999999.999999

  Depending on the choice of the sale system it could equal the initial amount of the order or the global amount of the order. If ForecastedAmount equals the initial amount of the order it will allow the system to follow any additional payment. In case of equality with the global amount of the order, the system will then be able to follow remaining amounts.

  CurrentAmountnumber

  Maximum: 99999999.999999

  Total amount of all completed transactions of a customer order.

  Currencystring

  Currency of a monetary amount.

  AccessedBystring

  Identification of an entity accessing data to perform an operation. Allow the synchronisation of customer order processing, when several parts of the Sale System access a customer order at the same time. The Sale entity active on the customer order is identified by this data.

  AdditionalInformationstring

  Unqualified information.

  CheckDataobject

  Information related to the paper check used for the transaction. Allows the check information to be provided by the Sale System before requesting the payment, or stored by the Sale System after processing of the payment.

  Show childrenHide children

  BankIDstring

  Identification of the bank. Mandatory if TrackData absent.

  AccountNumberstring

  Identification of the customer account. Mandatory if TrackData absent.

  CheckNumberstring

  Identification of the bank check. Mandatory if TrackData absent.

  TrackDataobject

  Magnetic track or magnetic ink characters line. ISO 7813 - ISO 4909. Generic data structure for a card track, used when the magstripe card reader is located on the Sale Terminal, or for magstripe Card Reader device request. The data structure is also used to store the line at the bottom of a bank check.

  Show childrenHide children

  TrackNumbinteger

  Minimum: 1Maximum: 3

  Card track number.

  TrackFormatstring

  Magnetic track or magnetic ink characters line. Possible values:

  • AAMVA
  • ISO

  TrackValuestring

  Card track content.

  CheckCardNumberstring

  Check guarantee card number. If provided by the customer.

  TypeCodestring

  Type of bank check. Possible values:

  • Company
  • Personal

  Countrystring

  Country of the bank check. Absent if country of the Sale system.

  MobileDataobject

  Mobile phone is used as a payment instrument for the transaction. Information related to the mobile for the payment transaction.

  Show childrenHide children

  MobileCountryCodeinteger

  Minimum: 3Maximum: 3

  Identifies the country of a mobile phone operator. If data available.

  MobileNetworkCodeinteger

  Minimum: 2Maximum: 3

  Identifies the mobile phone operator inside a country. If data available.

  MaskedMSISDNinteger

  Masked Mobile Subscriber Integrated Service Digital Network. If data available.

  Geolocationobject

  Geographic location specified by geographic or UTM coordinates. If data available.

  Show childrenHide children

  GeographicCoordinatesobject

  Show childrenHide children

  Latitudestring

  Angular distance of a location on the earth south or north of the equator.

  Longitudestring

  Angular measurement of the distance of a location on the earth east or west of the Greenwich observatory.

  UTMCoordinatesobject

  Show childrenHide children

  UTMZonestring

  UTM grid zone combination of the longitude zone (1 to 60) and the latitude band (C to X, excluding I and O).

  UTMEastwardstring

  X-coordinate of the Universal Transverse Mercator coordinate system.

  UTMNorthwardstring

  Y-coordinate of the Universal Transverse Mercator coordinate system.

  ProtectedMobileDatastring

  Sensitive information related to the mobile phone, protected by CMS. SensitiveMobileData.

  SensitiveMobileDataobject

  Sensitive information related to the mobile phone. If unprotected mobile data.

  Show childrenHide children

  MSISDNinteger

  Mobile Subscriber Integrated Service Digital Network (i.e. mobile phone number of the SIM card). Country, National Destination Code, and Subscriber Number.

  IMSIinteger

  International Mobile Subscriber Identity. Unique number associated with the mobile phone user, containing the Mobile Country Code (MCC), the Mobile Network Code (MNC), and the Mobile Identification Number (MSIN)

  IMEIinteger

  International Mobile Equipment Identity. Unique number associated with the mobile phone device.

  StoredValueAccountIDobject

  Identification of the stored value account or the stored value card and the associated product sold by the Sale System for stored value requests.

  Show childrenHide children

  StoredValueAccountTypestring

  Type of stored value account. Allows the distinction of the stored value instrument to access the stored value account. Possible values:

  • GiftCard
  • Other
  • PhoneCard

  StoredValueProviderstring

  Identification of the provider of the stored value account load/reload. When the ProductCode is not sufficient to identify the provider host which delivers the load or reload of the stored value account (for example if it contains the identification of the application.)

  OwnerNamestring

  Name of the owner of a stored value account.

  ExpiryDateinteger

  Minimum: 4Maximum: 4

  Date after which the card cannot be used. If EMV expiry date is present, it overrides Track2 information. Format is MMYY.

  EntryModearray[string]

  Entry mode of the payment instrument information. In the Payment, Loyalty, or StoredValue Request messages, it informs the POI System the entry mode of the payment instrument information when read by the Sale Terminal. (e.g. because the payment instrument information are a barcode read by the Cashier on a scanner device). Possible values:

  • Contactless
  • File
  • ICC
  • Keyed
  • MagStripe
  • Manual
  • Mobile
  • RFID
  • Scanned
  • SynchronousICC
  • Tapped

  IdentificationTypestring

  Type of account identification. In a request message, it informs the POI System the type of the account or card identification, when provided by the Sale Terminal. (e.g. because the card information is a barcode read by the Cashier on a scanner device). In a response message, it informs the Sale System the type of the account or card identification. Possible values:

  • AccountNumber
  • BarCode
  • ISOTrack2
  • PAN
  • PhoneNumber

  StoredValueIDstring

  Stored value account identification. The identification of the stored value account conforming to the IdentificationType.

  LoyaltyAccountarray[object]

  Data related to the loyalty System.

  Show childrenHide children

  LoyaltyAccountIDobject

  Identification of a Loyalty account. In the Payment or the Loyalty Request message, it allows to identify the loyalty account by the Sale Terminal instead of the POI Terminal (e.g. because the account identification is a bar-code read by the Cashier on a scanner device).

  Show childrenHide children

  EntryModearray[string]

  Entry mode of the payment instrument information. In the Payment, Loyalty or StoredValue Request messages, it informs the POI System the entry mode of the payment instrument information when read by the Sale Terminal. In the Payment, Loyalty or StoredValue Response messages, it informs the Sale System the entry mode of the payment instrument. Possible values:

  • Contactless
  • File
  • ICC
  • Keyed
  • MagStripe
  • Manual
  • Mobile
  • RFID
  • Scanned
  • SynchronousICC
  • Tapped

  IdentificationTypestring

  Type of account identification. In a request message, it informs the POI System the type of the account or card identification, when provided by the Sale Terminal. (e.g. because the card information is a barcode read by the Cashier on a scanner device). In a response message, it informs the Sale System the type of the account or card identification. Possible values:

  • AccountNumber
  • BarCode
  • ISOTrack2
  • PAN
  • PhoneNumber

  IdentificationSupportstring

  Support of the loyalty account identification. Allows knowing where and how you have found the loyalty account identification. Possible values:

  • HybridCard
  • LinkedCard
  • LoyaltyCard
  • NoCard

  LoyaltyIDstring

  Loyalty account identification conforming to the IdentificationType.

  LoyaltyBrandstring

  Identification of a Loyalty brand. If a card is analysed.

  CardReaderAPDUResponseobject

  Content of the Card Reader APDU Response message. It contains the result of the requested service, APDU response sent by the chip of the card in response to the APDU request.

  Show childrenHide children

  Responseobject

  Result of a message request processing. If Result is Success, ErrorCondition is absent or not used in the processing of the message. In the other cases, the ErrorCondition has to be present and can refine the processing of the message response. AdditionalResponse gives more information about the success or the failure of the message request processing, for logging without real time involvements.

  Show childrenHide children

  Resultstring

  Result of the processing of the message. Possible values:

  • Failure
  • Partial
  • Success

  ErrorConditionstring

  Condition that has produced an error on the processing of a message request. Returned if Result is not Success. Possible values:

  • Aborted
  • Busy
  • Cancel
  • DeviceOut
  • InProgress
  • InsertedCard
  • InvalidCard
  • LoggedOut
  • MessageFormat
  • NotAllowed
  • NotFound
  • PaymentRestriction
  • Refusal
  • UnavailableDevice
  • UnavailableService
  • UnreachableHost
  • WrongPIN

  AdditionalResponsestring

  Additional information related to processing status of a message request. If present, the POI logs it for further examination.

  APDUDatastring

  Data field of the APDU command (Lc + Data).

  CardStatusWordsstring

  Status of a smartcard response to a command (SW1-SW2).