IPC Integration Attributes

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.

For every Alipay Transactions, the Merchant Transaction Reference field should be unique. Else the Transaction will be declined by Emboss.

1

Alpha Numeric, Hyphen(-), Underscore(_)

0-30

M

Transaction Type, Transaction Type indicates the type of financial transaction.

2

Integer

N/A

M

Transaction Amount

Transaction amount is in major currency units e.g. 3=10.23

Amount must be non-zero, non negative and less than 9999999.99.

Only 2 digits are allowed after the decimal point

3

Decimal

NA

M

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.

Alipay Notes:

1.For Alipay BarCode transactions, the starting value for the BarCodes will range from 25 to 30.

For Alipay BarCode transactions, the BarCode Value for Sale, Refund and Cancel transactions will be provided in plain text with NO masked digits.

5

Alpha Numeric

13-19

Alipay – 16 to 24

C1

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.

6

Integer

4

C1

CNP indicator specifies if the transaction is cardholder not present. Value is 1 if CNP transaction otherwise 0.

12

Integer

1

C2

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.

13

Alpha Numeric

12-14

C3

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.

18

Integer

1

O

Token Reference

19

Alpha Numeric

20

C4

Cash Tender amount

Cash Tender amount is in major currency units e.g. 20=10.23

20

Decimal

NA

C5

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.

25

Boolean

NA

M

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.

26

Boolean

NA

O

Cash transaction indicator, specifies if the transaction is cash transaction. Value must be 1.

28

Integer

1

C5

Authorisation Code: This field is optional for transaction Terminal Key Recovery by Merchant keyed referral transaction.

30

Alpha Numeric

2-6

O

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.

72

Alpha Numeric

NA

O

Send Attempt: This field is only meant for Alipay Transactions and optional for Merchants. If not provided a default value (1) will be sent to Alipay.

108

Numeric

1 to 9

Alipay Sale-O

Alipay Refund-NA

Alipay Cancel-NA

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.

109

Numeric

1 to 32,7679

Alipay Sale-O

Alipay Refund-NA

Alipay Cancel-NA

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.

110

Alpha Numeric

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.

111

Integer

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

112

Boolean

NA

M

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

103

Alphabet

1

AVR-M

Sale with Token-O

End of message indicator, values always 0.

99

Integer

1

M