POST /balanceinquiry

Default value: "application/json"

Data related to a requested Loyalty program or account.

Identification of the transaction by the host in charge of the stored value transaction. If provided by the Host.

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.

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

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

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

• HybridCard
• LinkedCard
• LoyaltyCard
• NoCard

Valid values:

• "LoyaltyCard"
• "NoCard"
• "HybridCard"
• "LinkedCard"

Loyalty account identification conforming to the IdentificationType.

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

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

Valid values:

• "PAN"
• "AccountNumber"
• "BarCode"
• "PhoneNumber"
• "ISOTrack2"

Data related to the account pointed by the payment card.

Identification of the transaction by the host in charge of the stored value transaction. If provided by the Host.

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.

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

Type of cardholder account used for the transaction. Allows a cardholder to select the type of account used for the transaction. Possible values:

• CardTotals
• Checking
• CreditCard
• Default
• EpurseCard
• Investment
• Savings
• Universal

Valid values:

• "Investment"
• "Savings"
• "Universal"
• "Checking"
• "EpurseCard"
• "CardTotals"
• "Default"
• "CreditCard"

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.

Type of payment instrument. Possible values:

• Card
• Cash
• Check
• Mobile
• StoredValue

Valid values:

• "Card"
• "StoredValue"
• "Mobile"
• "Check"
• "Cash"

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

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

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

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

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

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

• GiftCard
• Other
• PhoneCard

Valid values:

• "PhoneCard"
• "GiftCard"
• "Other"

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

Valid values:

• "PAN"
• "AccountNumber"
• "BarCode"
• "PhoneNumber"
• "ISOTrack2"

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

Name of the owner of a stored value account.

Information related to the payment card used for the transaction. If PaymentInstrumentType is Card.

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

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.

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.

Sensitive information related to the payment card, entered or read by the Sale System. If structure non empty and unprotected.

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

Card track number.

Default value: 2

Card track format. Possible values:

• AAMVA
• ISO

Valid values:

• "AAMVA"
• "ISO"

Card track content.

Primary Account Number.

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

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

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

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. Restriction of product payable by a card.

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

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

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

Valid values:

• "Customer"
• "Transaction"

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

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.

Information related to the paper check used for the transaction. If PaymentInstrumentType is Check.

Magnetic track or magnetic ink characters line. Mandatory if CheckNumber absent.

Card track number.

Default value: 2

Card track format. Possible values:

• AAMVA
• ISO

Valid values:

• "AAMVA"
• "ISO"

Card track content.

Identification of the customer account. Mandatory if TrackData absent.

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

Identification of the bank. Mandatory if TrackData absent.

Identification of the bank check. Mandatory if TrackData absent.

Check guarantee card number. If provided by the customer.

Type of bank check. Possible values:

• Company
• Personal

Valid values:

• "Company"
• "Personal"

Information related to the mobile for the payment transaction. If PaymentInstrumentType is Mobile.

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

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

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

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

Y-coordinate of the Universal Transverse Mercator coordinate system.

X-coordinate of the Universal Transverse Mercator coordinate system.

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

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

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

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

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

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

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)

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