IPC Integration Attributes
Input Request Attributes
The IPC transaction request is a Name Value pair format. There is a name (number) associated with all the attributes of the transaction. The EPOS application needs to send a list of attributes and their values in the request. Each attribute Name Value pair is separated by a Line Feed.
This is the list of input attributes for a transaction:
Mandatory/ Conditional/ Optional
Transaction reference, which uniquely identifies the transaction with a user defined tag.
We recommend that the Transaction Reference field contains only characters defined in ‘Data Type’ however if Transaction Reference contains special characters then IPC will sanitize the Transaction Reference Filed, excluding ‘Data Type’ characters. IPC will use the sanitized Transaction Reference to process the transaction. IPC will send the original Transaction Reference in output response.
For cancel, use the transaction reference of original transaction to be cancelled.
Note: For hVantiv Acquirer, the maximum length of MTR should be 11.
Note: For every Alipay Transactions, the Merchant Transaction Reference field should be unique, else the Transaction will be declined by Emboss.
Note: For Alipay Sale Transactions, the Merchant Transaction Reference field (#1) should NOT contain any special characters, only alpha-numeric characters are supported in it.
Alpha Numeric, Hyphen(-), Underscore(_)
Transaction Type, Transaction Type indicates the type of financial transaction
Transaction amount is in major currency units e.g. 3=10.23
Amount must be non-zero, non negative and less than 9999999.99.
Note: Transactions above the terminal’s ceiling limit will be cancelled even if they are less than 9999999.99. The Ceiling limit is defined by acquirer and varies by acquirer.
Only 2 digits are allowed after the decimal point
Masked PAN, present in case of pre sales completion and cancel transaction. Required for cancel transaction unless a check card is cancelled. Required for E-giftcard transactions also.
For Alipay Transactions using BarCode this field will be required and will contain the BarCode value displayed on the Consumer’s Alipay app.
1.For Alipay BarCode transactions, the starting value for the BarCodes will range from 25 to 30.
2. For Alipay BarCode transactions, the BarCode Value for Sale, Refund and Cancel transactions will be provided in plain text with NO masked digits.
Alipay – 16 to 24
Card Expiry Date, present in case of pre sales completion and cancel transaction in MMYY format. Required for cancel transaction unless a check card is cancelled.
The expiry date parameter in pre sales completion and Cancel transactions has been retained for backwards compatibility, however any expiry date corresponding to MMYY format is accepted. Optional for E-giftcard transactions.
For Alipay Transactions, Card Expiry Date is “OPTIONAL”. But if the Expiry Date is provided during an Alipay Sale Transaction by the Merchant, then same should be provided while requesting a Refund for that transaction, else the Refund will be declined by Emboss
Optional for Alipay Transaction
CNP indicator specifies if the transaction is cardholder not present. Value is 1 if CNP transaction otherwise 0.
Transaction reference. For Pre Sales, specifies the reference of the pre sales transaction to be completed. For Cancel, specifies the reference of the transaction to be Voided. (Returned in field 28 of IPC response message. Refer response message details).
Note – For Alipay Refund and Cancel transactions the PGTR field is required.
Keyed transaction indicator, specifies if the transaction is keyed transaction. Value is 1, if Keyed transaction otherwise 0. Keyed is allowed only for Sale and Refund transaction.
Value is 2, if forced Keyed referral transaction.
Cash Tender amount
Cash Tender amount is in major currency units e.g. 20=10.23
Remove Card flag. This is Boolean field and mandatory in the request of Check Card functionality. If this field is True then IPC will ask for remove card after returning card details. If this field is False then IPC will wait for a while for transaction request.
Go online flag. This is a Boolean field and optional in the Check Card request. It indicates that IPC needs to go online to check whether card is Credit or Debit. If this flag is not provided in the input request then IPC will check online or offline according to configuration of the Online Credit/debit option in IPC Configuration General Tab.
Cash transaction indicator, specifies if the transaction is cash transaction. Value must be 1.
Authorisation Code: This field is optional for transaction Terminal Key Recovery by Merchant keyed referral transaction.
Newday Discount code/amount: This field is optional in Sale and Refund request. The code and amount values are to be provided concatenated into an alpha numeric string separated by operators “,” and “|”. This field has no effect if the tendered card is not a Newday card.
Transaction Purpose : This field is mandatory field in Account Verification Request & optional for Sale with Token transaction, Value for this field is single character and currently allowed character is only N (Ad-hoc or pay as a you go).
Sale with Token-O
Send Attempt: This field is only meant for Alipay Transactions and optional for Merchants. If provided it should be incremented in line with the transaction retries performed. Allowed values are 1 to 9 only. If not provided a default value (1) will be sent to Alipay.
1 to 9
Quantity: This field is only meant for Alipay Transactions and optional for Merchants. If not provided a default value (1) will be sent to Alipay.
1 to 32,7679
Transaction name: This field is only meant for Alipay Transactions and optional for Merchants. If not provided an empty string will be sent to Alipay.
256 Character without Special Symbol
Payment Instrument Identifier: This field is only meant for Alipay Transactions and required for Merchants. The value for Alipay BarCode Transaction will be 029.
029 for Alipay Barcode Trasnaction
Boots Card Indicator. This is Boolean field and mandatory in the request of Check Card functionality to check the Boots card. If this field is True then IPC will ask for Insert Boots Card on pinpad
End of message indicator, values always 0.
C1 – Required for E-giftcard, pre sales completion and cancel transaction but expiry date is optional for E-giftcard transaction
C2 – Card not present transaction
C3 – Transaction Type Sale Completion (2=2)
C4 – Mandatory for Transaction Type 12 (Sale with token) & 13 (Refund with token)
C5 – Mandatory for Cash Transaction
Only Alphanumeric or numbers are allowed in all the input attribute fields, except in the case of Transaction reference
TaxFree Voucher (VAT Refund ) for Cash Transaction is valid only if Merchant is enabled for TaxFree