APIs

Overview

Pine labs Billing System Integration SDK supports both CSV and JSON format message protocol between the PoS System and the Payment terminal. This section describes the message format followed by the PoSLib's doTransaction API to process transaction with Payment device.

Message Protocol

The messages that are transmitted between the PoS and the Terminal will use the following structure. Both request and response messages exchanged shall follow the same structure.

Message Structure

Request Packet Structure
Byte Number	Type	Content	Description
1 to 2	BYTE	Source ID	Identification Number for client (e.g. 0x1000)
3 to 4	BYTE	Function Code	0x0997 Refer Function Codes
5 to 6	BYTE	Data Length Excluding ETX	E.g. 0x0032 for a data length of 50 bytes
7 to N	ASCII	Data	4001,TX1234567890,215400,,,,,,,
N+1	BYTE	ETX	0xFF

Response Packet Structure
Byte Number	Type	Content	Description
1 to 2	BYTE	Source ID	Identification Number for client (e.g. 0x1000)
3 to 4	BYTE	Function Code	0x0997 Refer Function Codes
5 to 6	BYTE	Error Code	0x0001 - valid response, 0x0000 - invalid response 0x0002 - Cancel response
7 to 8	BYTE	Data Length Excluding ETX	E.g. 0x0032 for a data length of 50 bytes
9 to N	ASCII	Data	"T1/1234567890,""000059"",""APPROVED"", ""401152******15 69"",""XXXX"", ""AXIS BANK GIFT CARD"",""VISA"",370,203, ""78569456"",0,""PROCESSED"",""HDFC BANK"", """",""000020"",1,1,""PINE LABS PVT.LTD."", ""Testing Server"",""NOIDA - INDIA"", ""Plutus v1.49.1 MT HDFC BANK"",01,00, """","""","""",,"""","""","""","""",""08012012"",""150118"""
N+1	BYTE	ETX	0xFF

CSV requests and responses, data fields are separated by commas (,). There are 23 fields in total, where some are mandatory while others are optional depending on the transaction type.

For instance, in a sale request, fields 1 and 3 are mandatory, and the merchant billing application must provide the data for these fields. The remaining fields, which are optional, can either be filled with data or left empty based on specific requirements.
Example:
4001,,1000

Here's an example for a sale request, if the merchant billing application need to send fields 1, 2, 3, and 16, where 2 and 16 are optional, it can leave fields 4 to 15 empty using commas, like this:
Example:
4001,2,1000,,,,,,,,,,,,,16

In the above example, field 1 represents the transaction code, field 3 represents the transaction amount, and fields 2 and 16 are optional and filled as needed. The remaining fields from 4 to 15 are left empty with commas.

Sale Transaction

A transaction between two parties where the buyer receives goods (tangible or intangible),services and/or assets in exchange for money.

Message Format

Request Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	4001	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa)	999999	Mandatory
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency)	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory
42	Transcation Cuurency	String	3	Indicates the currency code of the transaction	AED	Mandatory
43	Exchange Rate	Double	0-15	This field is the relative value at which one currency can be exchanged for another currency	11.1	Mandatory
44	DCC Amount	Double	0-15	Total amount processed for a transaction presented to a cardholder using Dynamic Currency Conversion	12.11	Mandatory
45	Markup Fee	Double	0-15	A markup fee is an additional charge applied to the cost of a product or service to cover the seller's overhead costs, profit margin, and other expenses	5.5	Mandatory
46	Trace Number	String	0-15	A unique sequence number assigned by the message initiator to uniquely identify a transaction.	11	Mandatory
47	AID	String	0-15	EMV AID	A00000000310	Mandatory
48	TVR	String	0-15	EMV TVR	48000	Mandatory
49	ARQC	String	0-16	Authorization Request Cryptogram is a cryptographic code generated by the card's chip during a payment transaction and is used to authenticate the legitimacy of the transaction request	A2F8CD0C107F910	Mandatory

Request

HEX String Format	ASCII Format
10000997001D343030312C545831323334353637382C3130313030302C2C2C2C2C2C2CFF	— 4001,TX12345678,101000,,,,,,,ÿ

Response

HEX String Format	ASCII Format
999919970001015E012254583132333435363738222C223030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A36373933222C2258585858222C224E494B48494C205020504154494C20202020202020202020202F222C2256495341222C313131382C32332C223939383030303236222C302C2250524F434553534544222C2249434943492042414E4B222C22202020202020202020202020202020222C22303030303030303030303230222C322C312C224C4F564520434F4D4D554E49434154494F4E222C224A414E414B50555249222C224E45572044454C48492020202044454C20202020202020222C22506C757475732076322E3132204D542049434943492042414E4B222C30322C22222C22222C22222C22222C22222C22222C22222C22222C22222C223036323332303233222C22313334333131222C2234323935323233303633222C22313030222C2234303031222C22434152445F4348495022FF	™™— ^"TX12345678","00","APPROVED","**6793","XXXX","NIKHIL P PATIL /","VISA",1118,23,"99800026",0,"PROCESSED","ICICI BANK","","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT ICICI BANK",02,"","","","","","","","","","06232023","134311","4295223063","100","4001","CARD_CHIP"ÿ

HEX String Format

ASCII Format

999919970001015E012254583132333435363738222C223030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A36373933222C2258585858222C224E494B48494C205020504154494C20202020202020202020202F222C2256495341222C313131382C32332C223939383030303236222C302C2250524F434553534544222C2249434943492042414E4B222C22202020202020202020202020202020222C22303030303030303030303230222C322C312C224C4F564520434F4D4D554E49434154494F4E222C224A414E414B50555249222C224E45572044454C48492020202044454C20202020202020222C22506C757475732076322E3132204D542049434943492042414E4B222C30322C22222C22222C22222C22222C22222C22222C22222C22222C22222C223036323332303233222C22313334333131222C2234323935323233303633222C22313030222C2234303031222C22434152445F4348495022FF

™™— ^"TX12345678","00","APPROVED","**6793","XXXX","NIKHIL P PATIL /","VISA",1118,23,"99800026",0,"PROCESSED","ICICI BANK","","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT ICICI BANK",02,"","","","","","","","","","06232023","134311","4295223063","100","4001","CARD_CHIP"ÿ

JSON Request:

 
        
    Coming Soon

JSON Response:

 
        
    
    Coming Soon

Please refer Error code and Error messages

Refund Transaction

Compensation paid to the customer for over-invoicing or for returned goods.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types. Range: 4001-4216	4002	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external application. Plutus will only use this value for printing on charge slip.	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa).	999999	Mandatory
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.	Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition.	201	Optional
14	Transaction log ID	Long Integer	01-12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition.	123234	Optional
15	Reward/Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency).	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Settlement Summary	(NA for Sodexo)	Mandatory
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
10000997001A343030322C545831323334353637382C3130302C2C2C2C2C2C2CFF	— 4002,TX12345678,100,,,,,,,ÿ

Response

HEX String Format	ASCII Format
9999199700010179012254583132333435363738222C22222C225472616E73616374696F6E206E6F7420737570706F7274656420666F72207468652073656C6563746564206163717569726572222C222A2A2A2A2A2A2A2A2A2A2A2A35313834222C2258585858222C22222C2220222C302C302C223939383030303236222C302C225472616E73616374696F6E206E6F7420737570706F7274656420666F72207468652073656C6563746564206163717569726572222C2249434943492042414E4B222C22202020202020202020202020202020222C22303030303030303030303030222C322C312C224C4F564520434F4D4D554E49434154494F4E222C224A414E414B50555249222C224E45572044454C48492020202044454C20202020202020222C22506C757475732076322E3132204D542049434943492042414E4B222C30322C22222C22222C22222C22222C22222C22222C22222C22222C22222C22222C22222C2230222C22313030222C2234303032222C22434152445F4348495022FF	™™— y"TX12345678","","Transaction not supported for the selected acquirer","**5184","XXXX",""," ",0,0,"99800026",0,"Transaction not supported for the selected acquirer","ICICI BANK"," ","000000000000",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT ICICI BANK",02,"","","","","","","","","","","","0","100","4002","CARD_CHIP"ÿ

HEX String Format

ASCII Format

9999199700010179012254583132333435363738222C22222C225472616E73616374696F6E206E6F7420737570706F7274656420666F72207468652073656C6563746564206163717569726572222C222A2A2A2A2A2A2A2A2A2A2A2A35313834222C2258585858222C22222C2220222C302C302C223939383030303236222C302C225472616E73616374696F6E206E6F7420737570706F7274656420666F72207468652073656C6563746564206163717569726572222C2249434943492042414E4B222C22202020202020202020202020202020222C22303030303030303030303030222C322C312C224C4F564520434F4D4D554E49434154494F4E222C224A414E414B50555249222C224E45572044454C48492020202044454C20202020202020222C22506C757475732076322E3132204D542049434943492042414E4B222C30322C22222C22222C22222C22222C22222C22222C22222C22222C22222C22222C22222C2230222C22313030222C2234303032222C22434152445F4348495022FF

™™— y"TX12345678","","Transaction not supported for the selected acquirer","**5184","XXXX",""," ",0,0,"99800026",0,"Transaction not supported for the selected acquirer","ICICI BANK"," ","000000000000",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT ICICI BANK",02,"","","","","","","","","","","","0","100","4002","CARD_CHIP"ÿ

JSON Request:

 
       
   Coming Soon

JSON Response:

 
       
   
   Coming Soon

Void Transaction

The Void transaction is used to reverse a previously approved Sale transaction.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types.	4006	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	TX12345678	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa).	999999	Mandatory
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Mandatory
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Mandatory
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition.	201	Optional
14	Transaction log ID	Long Integer	01-12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition.	123234	Optional
15	Reward/Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency).	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Optional
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Optional
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Optional
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Optional
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Optional
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Optional
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Optional
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Optional
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Optional
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Optional
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Optional
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Optional
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Optional
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Optional
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Optional
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Optional
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Optional
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Optional
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Optional
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Optional
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Optional
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Optional
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Optional
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Optional

Request

HEX String Format	ASCII Format
10000997001A343030362C545831323334353637382C3130302C2C2C2C2C2C2CFF	— 4006,TX12345678,100,,,,,,,ÿ

Response

HEX String Format	ASCII Format
999919970001003701496E76616C696420496E766F696365204E756D626572206F722064657461696C7320666F722074686973207472616E73616374696F6EFF	™™— 7Invalid Invoice Number or details for this transactionÿ

JSON Request:

 
      
  Coming Soon

JSON Response:

 
      
  
  Coming Soon

Pre Auth Transaction

A pre-authorization is a transaction to determine and block if cardholder have a maximum available credit line, which will not be actually charged.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types. Range: 4001-4216	4007	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa)	999999	Mandatory
15	Reward/Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency)	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
10000997001A343030372C545831323334353637382C3130302C2C2C2C2C2C2CFF	— 4007,TX12345678,100,,,,,,,ÿ

Response

HEX String Format	ASCII Format
9999199700010144012254583132333435363738222C223030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A35313834222C2258585858222C22222C2256495341222C313132322C32332C223939383030303236222C302C2250524F434553534544222C2249434943492042414E4B222C22202020202020202020202020202020222C22303030303030303030303230222C322C312C224C4F564520434F4D4D554E49434154494F4E222C224A414E414B50555249222C224E45572044454C48492020202044454C20202020202020222C22506C757475732076322E3132204D542049434943492042414E4B222C30322C22222C22222C22222C22222C22222C22222C22222C22222C22222C223036323332303233222C22313535323237222C2234323935323233313437222C22313030222C2234303037222C22434152445F4348495022FF	™™— D"TX12345678","00","APPROVED","**5184","XXXX","","VISA",1122,23,"99800026",0,"PROCESSED","ICICI BANK","","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT ICICI BANK",02,"","","","","","","","","","06232023","155227","4295223147","100","4007","CARD_CHIP"ÿ

HEX String Format

ASCII Format

9999199700010144012254583132333435363738222C223030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A35313834222C2258585858222C22222C2256495341222C313132322C32332C223939383030303236222C302C2250524F434553534544222C2249434943492042414E4B222C22202020202020202020202020202020222C22303030303030303030303230222C322C312C224C4F564520434F4D4D554E49434154494F4E222C224A414E414B50555249222C224E45572044454C48492020202044454C20202020202020222C22506C757475732076322E3132204D542049434943492042414E4B222C30322C22222C22222C22222C22222C22222C22222C22222C22222C22222C223036323332303233222C22313535323237222C2234323935323233313437222C22313030222C2234303037222C22434152445F4348495022FF

™™— D"TX12345678","00","APPROVED","**5184","XXXX","","VISA",1122,23,"99800026",0,"PROCESSED","ICICI BANK","","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT ICICI BANK",02,"","","","","","","","","","06232023","155227","4295223147","100","4007","CARD_CHIP"ÿ

JSON Request:

 
    
Coming Soon

JSON Response:

 
    

Coming Soon

Sale Complete Transaction

Completion is the transaction to process or complete the Pre authorized transaction. Completion can be for the full pre authorized amount or diffrent amount.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types. Range: 4001-4216	4008	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa)	999999	Mandatory
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Mandatory
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Mandatory
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	01-12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency).	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
10000997001A343030382C545831323334353637382C3130302C2C2C2C2C2C2CFF	— 4008,TX12345678,100,,,,,,,ÿ

Response

HEX String Format	ASCII Format
999919970001010C012254583132333435363738222C22222C22496E76616C696420496E766F696365204E756D626572206F722064657461696C7320666F722074686973207472616E73616374696F6E222C22222C2258585858222C22222C2220222C313132322C302C2220222C302C22496E76616C696420496E766F696365204756D626572206F722064657461696C7320666F722074686973207472616E73616374696F6222C2242414E4B222C2220222C22303030303030303030303030222C312C312C2220222C2220222C2220222C22312E312E312E31222C30302C22222C22222C22222C22222C22222C22222C22222C22222C22222C22222C22222C2230222C22313030222C2234303038222C2222FF	™™— "TX12345678","","Invalid Invoice Number or details for this transaction","","XXXX",""," ",1122,0," ",0,"Invalid Invoice Number or details for this transaction","BANK"," ","000000000000",1,1," "," "," ","1.1.1.1",00,"","","","","","","","","","","","0","100","4008",""ÿ

HEX String Format

ASCII Format

999919970001010C012254583132333435363738222C22222C22496E76616C696420496E766F696365204E756D626572206F722064657461696C7320666F722074686973207472616E73616374696F6E222C22222C2258585858222C22222C2220222C313132322C302C2220222C302C22496E76616C696420496E766F696365204756D626572206F722064657461696C7320666F722074686973207472616E73616374696F6222C2242414E4B222C2220222C22303030303030303030303030222C312C312C2220222C2220222C2220222C22312E312E312E31222C30302C22222C22222C22222C22222C22222C22222C22222C22222C22222C22222C22222C2230222C22313030222C2234303038222C2222FF

™™— "TX12345678","","Invalid Invoice Number or details for this transaction","","XXXX",""," ",1122,0," ",0,"Invalid Invoice Number or details for this transaction","BANK"," ","000000000000",1,1," "," "," ","1.1.1.1",00,"","","","","","","","","","","","0","100","4008",""ÿ

JSON Request:

 
                      
                  Coming Soon

JSON Response:

 
                      
                  
                  Coming Soon

Brand EMI Transaction

A Brand EMI transaction is an equated monthly installment (EMI) payment option offered by a bank or non-banking financial company (NBFC) in association with a particular brand. This allows customers to purchase products from the brand on credit and repay the amount in monthly installments.

The interest rate and tenure of the EMI are decided by the bank or NBFC in consultation with the brand. The customer can choose the EMI tenure depending on their affordability.

EMI Related Parameters:

Index	Sample Data	Description
1	999113881	Pine Labs Product code
2	7	Brand OEM ID provided by Pine Labs
3	463	Pine Labs Rule Id
4	106	Pine Labs Rule Type ID
5	753	Pine Labs Scheme Code
6	3	Tenure
7	233	Pine Labs Issuer ID
8	29489583	IMEI number/SERIAL NO
9	9900336400	Mobile number

• EMI-related fields are transmitted in a pipe-separated format from the merchant billing system. The majority of these parameters are optional. In cases where the billing system does not provide certain parameters, the Electronic Data Capture (EDC) system will prompt the user to manually enter or select the required details through a screen.

• Fields like Rule ID, Rule Type ID, Scheme Code and Issuer ID are NA for merchants who do not have Scheme information.

Use Cases for Brand EMI

Brand EMI can be performed in two ways where Merchant can either select the product and EMI details on the Merchant Billing Application or they can be selected on android payment terminal. Below section describes both use cases.

Product and EMI details selection on Merchant Billing Application

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	5002	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	EMI Parameter	String	1 - 100	These fields are pipe separated, Product code, OEM ID, Rule ID, Rule Type ID, Scheme Code, Tenure, Issuer ID, IMEI number/SERIAL NO, Mobile Number	999113881\|7\|463\|106\|753\|3\|233\|29489583\|9900336400\|	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Mandatory/td>
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value
1	Billing Reference Number	Integer	1 – 32768	Transaction reference number from external application.	TX12345678
2	Approval Code	String	1 – 6	Credit card authorization code, if transaction was approved. Otherwise empty string.	5261AJ
3	Host Response	String	Length: 0 – 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	APPROVED
4	Card Number	String	Length: 0– 19	Card number is valid if card was swiped. Otherwise, empty string.	************2802
5	Expiration Date	String	0, 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	XXXX
6	Cardholder's Name	String	0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	AMIT MOHAN
7	Card Type	String	0 – 12	Card association name, if valid card was swiped. Otherwise, empty string.	VISA
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	6 or 3	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip)	78/101
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)
10	Terminal ID	String	0, 8	EFT TID, if transaction authorized. Otherwise, empty string	30000001
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0
12	Remark	String	0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	Failed to dial modem
13	Transaction Acquirer Name	String	0 – 48	Name of acquirer to which transaction was routed	ICICI BANK
14	Merchant ID	String	0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	000100090 015607
15	Retrieval Reference Number	String	0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	000000012 843
16	Card Entry Mode	Integer	0 – 5	Enumeration of possible values: 0 – Manual entry, 1 – Swipe entry, 2 – Chip card entry. Any other value – card not validated. Range: 0 – 32767	1
17	Print Cardholder's Name on receipt	Integer	0 – 5	Enumeration of possible values: 0 – Do not print cardholder’s name, 1 – Print cardholder’s name. Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0
18	Merchant Name	String	0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	NOBLE MOTORS
19	Merchant Address	String	0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	HAJI ALI
20	Merchant City	String	0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	MUMBAI
21	Plutus Version	String	0 – 40	Plutus version	v1.54 (for ICICI BANK)
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51- PINE 360, 301 – Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards
23	Reward Redeemed Amount	Long Integer	10	Redeemed Amount in Paisa or in lowest currency	10000
24	Reward Redeemed Points	Double	15	Redeemed Points	400.00
25	Reward Balance Amount	String	10	Balance Amount	1000000
26	Reward Balance Points	Double	15	Balance Point	40000.00
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format (Optional)*
28	EMI Parameter	String	0 – 23	Brand EMI 106.These fields are pipe separated. Brand Type,Tenuar ID,Issuer Bank,Base Amount,EMI amount, Addinital case back,Rule ID,Sechma ID, OEM ID, OEM Name,Pine Product code,SKU code,IMEI no,Mobile No	106\|3\|HDFC BANK\|1000000\|337787\|0\|1037\|1612\|7\|Apple iPhone\|999113876\|MT9E2HN/A\|568282\|9911072148
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/a mount voided/Amount loaded on cards/wallets	String	0 – 99	Amount will always be in paisa or lowest currency.	100000
30	RFU3	String	0 – 23	Reserved for future use
31	RFU	String		Specific for merchant	Alhanumeric
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	02012011
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	210403
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345

Request

HEX String Format	ASCII Format
100009970086353030322C545831323334353637382C3130303030302C2C2C2C2C2C2C2C2C2C2C3939393131333838317C377C3436337C3130367C3735337C337C3233337C32393438393538337C393930303333363430307C2C2C2CFF	— †5002,TX12345678,100000,,,,,,,,,,,999113881\|7\|463\|106\|753\|3\|233\|29489583\|9900336400\|,,,ÿ

Response

HEX String Format	ASCII Format
99991997000101792254583132333435363738222C22303030303030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A38303739222C2258585858222C2231323230303031363131393030333035202F222C224D415354455243415244222C322C312C223532313435363235222C302C2250524F434553534544222C22415849532042414E4B222C22303337303131303031373931373038222C22303030303030303030303230222C322C312C225257414D524954534152222C225257414D524954534152222C22414D524954534152222C22506C757475732076322E353520415849532042414E4B222C30352C22222C22222C22222C22222C22222C223130367C337C484446432042414E4B7C313030303030307C3333373738377C307C313033377C313631327C377C4170706C65206950686F6E657C3939393131333837367C4D54394532484E2F417C3536383238327C39393131303732313438222C22222C22222C22222C223031313032303230222C2231333434313822FF	™™— y"TX12345678","000000","APPROVED","************8079","XXXX","1220001611900305 /","MASTERCARD",2,1,"52145625",0,"PROCESSED","AXIS BANK","037011001791708","000000000020",2,1,"RWAMRITSAR","RWAMRITSAR","AMRITSAR","Plutus v2.55 AXIS BANK",05,"","","","","","106\|3\|HDFC BANK\|1000000\|337787\|0\|1037\|1612\|7\|Apple iPhone\|999113876\|MT9E2HN/A\|568282\|9911072148","","","","01102020","134418"ÿ

HEX String Format

ASCII Format

99991997000101792254583132333435363738222C22303030303030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A38303739222C2258585858222C2231323230303031363131393030333035202F222C224D415354455243415244222C322C312C223532313435363235222C302C2250524F434553534544222C22415849532042414E4B222C22303337303131303031373931373038222C22303030303030303030303230222C322C312C225257414D524954534152222C225257414D524954534152222C22414D524954534152222C22506C757475732076322E353520415849532042414E4B222C30352C22222C22222C22222C22222C22222C223130367C337C484446432042414E4B7C313030303030307C3333373738377C307C313033377C313631327C377C4170706C65206950686F6E657C3939393131333837367C4D54394532484E2F417C3536383238327C39393131303732313438222C22222C22222C22222C223031313032303230222C2231333434313822FF

™™— y"TX12345678","000000","APPROVED","************8079","XXXX","1220001611900305 /","MASTERCARD",2,1,"52145625",0,"PROCESSED","AXIS BANK","037011001791708","000000000020",2,1,"RWAMRITSAR","RWAMRITSAR","AMRITSAR","Plutus v2.55 AXIS BANK",05,"","","","","","106|3|HDFC BANK|1000000|337787|0|1037|1612|7|Apple iPhone|999113876|MT9E2HN/A|568282|9911072148","","","","01102020","134418"ÿ

JSON Request:

 
            
        Coming Soon

JSON Response:

 
            
        
        Coming Soon

Product and EMI details selection on Android Payment Terminal.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	4001	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	EMI Parameter	String	1 - 100	These fields are pipe separated, Product code, OEM ID, Rule ID, Rule Type ID, Scheme Code, Tenure, Issuer ID, IMEI number/SERIAL NO, Mobile Number	999113881\|7\|463\|106\|753\|3\|233\|29489583\|9900336400\|	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	Integer	1 – 32768	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 – 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well	5261AJ	Mandatory
3	Host Response	String	0 – 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	APPROVED	Mandatory
4	Card Number	String	0 – 19	Card number is valid if card was swiped. Otherwise, empty string.	************2802	Mandatory
5	Expiration Date	String	0, 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	XXXX	Mandatory
6	Cardholder’s Name	String	0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string	AMIT MOHAN	Mandatory
7	Card Type	String	0 – 12	Card association name, if valid card was swiped. Otherwise, empty string	VISA	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	6 or 3	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)		Mandatory
10	Terminal ID	String	0, 8	EFT TID, if transaction authorized. Otherwise, empty string	30000001	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	Failed to dial modem	Mandatory
13	Transaction Acquirer Name	String	0 – 48	Name of acquirer to which transaction was routed	ICICI BANK	Mandatory
14	Merchant ID	String	0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	000100090 015607	Mandatory
15	Retrieval Reference Number	String	0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	000000012 843	Mandatory
16	Card Entry Mode	Integer	0 – 5	Enumeration of possible values: 0 – Manual entry, 1 – Swipe entry, 2 – Chip card entry. Any other value – card not validated. Range: 0 – 32767	1	Mandatory
17	Print Cardholder’s Name on receipt	Integer	0 – 5	Enumeration of possible values: 0 – Do not print cardholder’s name, 1 – Print cardholder’s name. Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	NOBLE MOTORS	Mandatory
19	Merchant Address	String	0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	HAJI ALI	Mandatory
20	Merchant City	String	0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	MUMBAI	Mandatory
21	Plutus Version	String	0 – 40	Plutus version	v1.54 (for ICICI BANK)	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51- PINE 360, 301 – Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	10	Redeemed Amount in Paisa or in lowest currency	10000	Mandatory
24	Reward Redeemed Points	Double	15	Redeemed Points	400.00	Mandatory
25	Reward Balance Amount	String	10	Balance Amount	1000000	Mandatory
26	Reward Balance Points	Double	15	Balance Point	40000.00	Mandatory
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Optional
28	EMI Parameter	String	0 – 23	Bank EMI 105, Brand .These fields are pipe separated. Brand Type, Tenuar ID, Issuer Bank, Base Amount, EMI amount, Addinital case back, Rule ID, Sechma ID, OEM ID, OEM Name, Pine Product code, SKU code, IMEI no, Mobile No	106\|3\|HDFC BANK\|1000000\|337787\|0\|1037\|1612\|7\|Apple iPhone\|999113876\|MT9E2HN/A\|568282\|9911072148	Mandatory
29	Amount processed successfully by Plutus/Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 – 99	Amount will always be in paisa or lowest currency.	100000	Mandatory
30	RFU3	String	0 – 23	Reserved for future use		Optional
31	RFU	String		Specific for merchant	Alhanumeric	Optional	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	02012011	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24hour format.	210403	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
100009970021353030322C545831323334353637382C3130303030302C2C2C2C2C2C2C2C2C2C2CFF	5002,TX12345678,100000,,,,,,,,,,,

Response

HEX String Format	ASCII Format
99991997000101792254583132333435363738222C22303030303030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A38303739222C2258585858222C2231323230303031363131393030333035202F222C224D415354455243415244222C322C312C223532313435363235222C302C2250524F434553534544222C22415849532042414E4B222C22303337303131303031373931373038222C22303030303030303030303230222C322C312C225257414D524954534152222C225257414D524954534152222C22414D524954534152222C22506C757475732076322E353520415849532042414E4B222C30352C22222C22222C22222C22222C22222C223130367C337C484446432042414E4B7C313030303030307C3333373738377C307C313033377C313631327C377C4170706C65206950686F6E657C3939393131333837367C4D54394532484E2F417C3536383238327C39393131303732313438222C22222C22222C22222C223031313032303230222C2231333434313822FF	TX12345678","000000","APPROVED","************8079","XXXX","1220001611900305 /","MASTERCARD",2,1,"52145625",0,"PROCESSED","AXIS BANK","037011001791708","000000000020",2,1,"RWAMRITSAR","RWAMRITSAR","AMRITSAR","Plutus v2.55 AXIS BANK",05,"","","","","","106\|3\|HDFC BANK\|1000000\|337787\|0\|1037\|1612\|7\|Apple iPhone\|999113876\|MT9E2HN/A\|568282\|9911072148","","","","01102020","134418"

HEX String Format

ASCII Format

TX12345678","000000","APPROVED","************8079","XXXX","1220001611900305 /","MASTERCARD",2,1,"52145625",0,"PROCESSED","AXIS BANK","037011001791708","000000000020",2,1,"RWAMRITSAR","RWAMRITSAR","AMRITSAR","Plutus v2.55 AXIS BANK",05,"","","","","","106|3|HDFC BANK|1000000|337787|0|1037|1612|7|Apple iPhone|999113876|MT9E2HN/A|568282|9911072148","","","","01102020","134418"

JSON Request:

 
          
      Coming Soon

JSON Response:

 
          
      
      Coming Soon

Bank EMI Transaction

A Bank EMI transaction is an equated monthly installment (EMI) payment option offered by a bank to its customers. This allows customers to purchase products or services from any merchant and repay the amount in monthly installments.

The interest rate and tenure of the EMI are decided by the bank. The customer can choose the EMI tenure depending on their affordability.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	5101	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	Integer	1 – 32768	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 – 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well	5261AJ	Mandatory
3	Host Response	String	0 – 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	APPROVED	Mandatory
4	Card Number	String	0 – 19	Card number is valid if card was swiped. Otherwise, empty string.	************2802	Mandatory
5	Expiration Date	String	0, 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	XXXX	Mandatory
6	Cardholder’s Name	String	0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string	AMIT MOHAN	Mandatory
7	Card Type	String	0 – 12	Card association name, if valid card was swiped. Otherwise, empty string	VISA	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	6 or 3	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)		Mandatory
10	Terminal ID	String	0, 8	EFT TID, if transaction authorized. Otherwise, empty string	30000001	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	Failed to dial modem	Mandatory
13	Transaction Acquirer Name	String	0 – 48	Name of acquirer to which transaction was routed	ICICI BANK	Mandatory
14	Merchant ID	String	0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	000100090 015607	Mandatory
15	Retrieval Reference Number	String	0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	000000012 843	Mandatory
16	Card Entry Mode	Integer	0 – 5	Enumeration of possible values: 0 – Manual entry, 1 – Swipe entry, 2 – Chip card entry. Any other value – card not validated. Range: 0 – 32767	1	Mandatory
17	Print Cardholder’s Name on receipt	Integer	0 – 5	Enumeration of possible values: 0 – Do not print cardholder’s name, 1 – Print cardholder’s name. Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	NOBLE MOTORS	Mandatory
19	Merchant Address	String	0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	HAJI ALI	Mandatory
20	Merchant City	String	0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	MUMBAI	Mandatory
21	Plutus Version	String	0 – 40	Plutus version	v1.54 (for ICICI BANK)	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51- PINE 360, 301 – Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	10	Redeemed Amount in Paisa or in lowest currency	10000	Mandatory
24	Reward Redeemed Points	Double	15	Redeemed Points	400.00	Mandatory
25	Reward Balance Amount	String	10	Balance Amount	1000000	Mandatory
26	Reward Balance Points	Double	15	Balance Point	40000.00	Mandatory
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Optional
28	EMI Parameter	String	0 – 23	Bank EMI 105, Brand .These fields are pipe separated. Brand Type,Tenuar ID,Issuer Bank,Base Amount,EMI amount	105\|3\|HDFC BANK\|100000\|33890\|0	Mandatory
29	Amount processed successfully by Plutus/Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 – 99	Amount will always be in paisa or lowest currency.	100000	Mandatory
30	RFU3	String	0 – 23	Reserved for future use		Optional
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	02012011	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24hour format.	210403	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
10000997002135313031202C545831323334353637382C3130303030302C2C2C2C2C2C2C2C2C2CFF	— !5101 ,TX12345678,100000,,,,,,,,,,ÿ

Response

HEX String Format	ASCII Format
99991997000101512254583132333435363738222C223030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A39383537222C2258585858222C2253414E44454550204B554D4152202F222C224D415354455243415244222C33322C302C223938393338343933222C302C2250524F434553534544222C2249434943492042414E4B222C2220222C22303030303030303030303230222C322C312C224C4F564520434F4D4D554E49434154494F4E222C224A414E414B50555249222C224E45572044454C48492044454C20222C22506C757475732076322E3132204D54222C30322C22222C22222C22222C22222C22222C223130357C337C484446432042414E4B7C3130303030307C33333839307C30222C22222C22222C22222C223039313732303230222C22313132363237222C2232363831353331222C22313030303030222C2235313031222C22434152445F4348495022FF	™™— Q"TX12345678","00","APPROVED","************9857","XXXX","SANDEEP KUMAR /","MASTERCARD",32,0,"98938493",0,"PROCESSED","ICICI BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT",02,"","","","","","105\|3\|HDFC BANK\|100000\|33890\|0","","","","09172020","112627","2681531","100000","5101","CARD_CHIP"ÿ

HEX String Format

ASCII Format

99991997000101512254583132333435363738222C223030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A39383537222C2258585858222C2253414E44454550204B554D4152202F222C224D415354455243415244222C33322C302C223938393338343933222C302C2250524F434553534544222C2249434943492042414E4B222C2220222C22303030303030303030303230222C322C312C224C4F564520434F4D4D554E49434154494F4E222C224A414E414B50555249222C224E45572044454C48492044454C20222C22506C757475732076322E3132204D54222C30322C22222C22222C22222C22222C22222C223130357C337C484446432042414E4B7C3130303030307C33333839307C30222C22222C22222C22222C223039313732303230222C22313132363237222C2232363831353331222C22313030303030222C2235313031222C22434152445F4348495022FF

™™— Q"TX12345678","00","APPROVED","************9857","XXXX","SANDEEP KUMAR /","MASTERCARD",32,0,"98938493",0,"PROCESSED","ICICI BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT",02,"","","","","","105|3|HDFC BANK|100000|33890|0","","","","09172020","112627","2681531","100000","5101","CARD_CHIP"ÿ

JSON Request:

 
          
      Coming Soon

JSON Response:

 
          
      
      Coming Soon

EMI as Single Transaction for Brand & Bank EMI

This transaction is similar to EMI transactions here user will select the type of EMI(Brand/Bank EMI) at the terminal based on the user selection application will process the selected EMI mode(Brand/Bank EMI).

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	5005	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
10000997001B353030352C20545831323334353637382C3130302C2C2C2C2C2C2CFF	— 5005, TX12345678,100,,,,,,,ÿ

Response

HEX String Format

ASCII Format

999919970001016D54312F313233343536373839302C223030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A36383031222C2258585858222C22474155524156204B554D4152222C2256495341222C3134382C35382C223735373736383939222C302C2250524F434553534544222C2249434943492042414E4B222C22202020202020202020202020202020222C22303030303030303030303230222C322C312C224C4F564520434F4D4D554E49434154494F4E222C224A414E414B50555249222C224E45572044454C48492020202044454C20202020202020222C22506C757475732076322E3132204D542049434943492042414E4B222C30322C22222C22222C22222C22222C22222C223130357C337C484446432042414E4B7C31303030307C333338397C30222C22222C22222C22222C223038303132303233222C22313733373030222C2234323935323331313932222C223130303030222C2235303035222C22434152445F4348495022FF

™™— mT1/1234567890,"00","APPROVED","************6801","XXXX","GAURAV KUMAR","VISA",148,58,"75776899",0,"PROCESSED","ICICI BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT ICICI BANK",02,"","","","","","105|3|HDFC BANK|10000|3389|0","","","","08012023","173700","4295231192","10000","5005","CARD_CHIP"ÿ

JSON Request:

 
        
    Coming Soon

JSON Response:

 
        
    
    Coming Soon

Tip Adjust Transaction

The Tip Adjust transaction is used to notify the host that there has been an addition to the amount of a previous transaction.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types. Range: 4001-4216	4015	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa)	999999	Mandatory
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	01-12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency).	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Adjust Transaction

Adjust transaction is used to notify the host that there has been an addition/correction to the amount of a previous transaction

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	4005	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Reward Redemption

A transaction between two parties where the buyer receives goods (tangible or intangible), services and/or assets in exchange for Reward points.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	4101	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Mandatory
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Mandatory
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Mandatory
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Mandatory
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
1000099700242234313031222C2254583132333435363738222C2239393939303030222C2C2C2C2C2C2CFF	— $"4101","TX12345678","9999000",,,,,,,ÿ

Response

HEX String Format

ASCII Format

9999199700010139545831323334353637382C22373236314139222C225452414E53414354494F4E205355434345535346554C222C222A2A2A2A2A2A2A2A2A2A2A2A32383032222C2230343036222C2252616D53696E6768222C22222C37382C3530322C223330303030303031222C302C225020524F434553534544222C20224C4F59414C545920524557415244222C2022303030313030303930303135363037222C2220363234363135333433303032222C312C20312C22204850434C2041726561203138222C22204B616D6C61204D696C6C73222C224E6F696461222C22762E30312E30302E3030222C38312C223130303030222C223430302E3030222C2231303030303030222C2234303030302E3030222C22222C22222C22222C22222C2222202C223032303132303131222C2232313034303322544350204353563A20FF

™™— 9TX12345678,"7261A9","TRANSACTION SUCCESSFUL","************2802","0406","RamSingh","",78,502,"30000001",0,"P ROCESSED", "LOYALTY REWARD", "000100090015607"," 624615343002",1, 1," HPCL Area 18"," Kamla Mills","Noida","v.01.00.00",81,"10000","400.00","1000000","40000.00","","","","","" ,"02012011","210403"TCP CSV: ÿ

JSON Request:

 
        
      Coming Soon

JSON Response:

 
        
      
      Coming Soon

Reward Void

The Reward Void transaction is used to reverse a previously approved Reward redemption transaction.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	4102	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
100009970038343030362C545831323334353637382C393939393030302C30312C2C2C2C2C2C2C2CE2809D39303032E2809D2CE2809D323031E2809D0D0AFF	— 84006,TX12345678,9999000,01,,,,,,,,â€9002â€,â€201â€ ÿ

Response

HEX String Format

ASCII Format

999919970001016E545831323334353637382CE2809C373236314139E2809D2CE2809D5452414E53414354494F4E205355434345535346554CE2809D2CE2809D2A2A2A2A2A2A2A2A2A2A2A2A32383032E2809D2CE2809D30343036E2809D2CE2809D52616D53696E6768E2809D2CE2809DE2809D2C37382C3530322CE2809D3330303030303031E2809D2C302CE2809D5020524F434553534544E2809D2C20E2809D4C4F59414C545920524557415244E2809D2C20E2809D303030313030303930303135363037E2809D2CE2809D20363234363135333433303032E2809D2C312C20312CE2809D204850434C2041726561203138E2809D2CE2809D204B616D6C61204D696C6C73E2809D2CE2809D4E6F696461E2809D2CE2809D762E30312E30302E3030E2809D2C38312C223130303030222C223430302E3030222C2231303030303030222C2234303030302E3030222C22222C22222C22222C22222C2222202C223032303132303131222C22323130343033220D0AFF

™™— nTX12345678,â€œ7261A9â€,â€TRANSACTION SUCCESSFULâ€,â€************2802â€,â€0406â€,â€RamSinghâ€,â€â€,78,502,â€30000001â€,0,â€P ROCESSEDâ€, â€LOYALTY REWARDâ€, â€000100090015607â€,â€ 624615343002â€,1, 1,â€ HPCL Area 18â€,â€ Kamla Millsâ€,â€Noidaâ€,â€v.01.00.00â€,81,"10000","400.00","1000000","40000.00","","","","","" ,"02012011","210403" ÿ

JSON Request:

 
        
      Coming Soon

JSON Response:

 
        
      
      Coming Soon

Reward Void

The Reward Void transaction is used to reverse a previously approved Reward redemption transaction.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	4102	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
100009970038343030362C545831323334353637382C393939393030302C30312C2C2C2C2C2C2C2CE2809D39303032E2809D2CE2809D323031E2809D0D0AFF	— 84006,TX12345678,9999000,01,,,,,,,,â€9002â€,â€201â€ ÿ

Response

HEX String Format

ASCII Format

JSON Request:

 
                      
                    Coming Soon

JSON Response:

 
                
                    
                    Coming Soon

Transaction Validation

Transaction Validation transaction is used to validate the previous completed Sale transactions.
This transaction can be used if the user wants to know the status on previous completed Sale transaction.

Note*

For Sale, transaction-ID is mandatory.
If PTRN/BillingRefNumber is provided, other transaction identifiers (Transaction ID, Client ID, Batch ID, Roc) should not be passed.
Last tranascation of EDC batch response will pending until next txn will done or batch settled.
Validation APIs will send response of only 2 (48 Hours) days txn.


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	7001	Mandatory
2	Merchant ID	Long	0 - 15	PLUTUS Merchant ID	000100090015607	Mandatory
3	Transaction Type Identifier	STRING	1 - 100	String that identifies txn type. Valid values are: SALE, PARTIAL_SALE, REWARDS, PINE360, PAYBACK	SALE	Mandatory
4	Transaction Amount	Long	0 - 8	Total Transaction amount in paise	800	Mandatory
5	Transaction Id	Long	0 - 19	Plutus transaction ID if a card transaction is involved. If TxnId is not available, "ClientID, BatchID, and Roc" must be sent.	30000000100001	Conditional
6	Client Id	Long	0 - 6	ID of transacting POS	14782	Conditional
7	Batch Id	Long	6	Transaction Batch	9398	Conditional
8	Roc	Long	3 - 6	Transaction ROC. Rang 101 - 999999	172	Conditional
9	Billing Reference Number	string	0 - 25	Billing Integration Number	TX12345678	Optional
10	PTRN	LONG	1 - 8	Plutus Cloud Based Transaction Reference ID	0	Optional
11	Security Token	string	1 - 100	Merchant Security Token	511D5FB5-F16D-4CD2-88F2-86A64D8FE	Mandatory
12	Host Url	string	1 - 100	Host Url	https://www.plutuscloudserviceuat.in:8201/api/CloudBasedIntegration/V1/PerformTxnValidation	Mandatory

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	String	4	Transaction request type to Plutus application. Please refer the Transaction	7001	Mandatory
2	Response Message	String	0 - 50	Transaction response message	SUCCESS/FAILURE	Mandatory
3	Original Transaction Type	String	1	Original Transaction type	1-Sale , 2-UPI , 3-Reward, 4-Payback, 5-Pine360	Mandatory
4	Billing Reference Number	String	0-25	Transaction reference number from external application.	TX12345678	Mandatory
5	PTRN	Long	1 - 8	Plutus transaction reference number of the uploaded bill	0	Mandatory
6	Host Transaction Number	String	1 - 100	Transaction number of the uploaded bill	SEQ-513	Mandatory
7	Bank Response Message	String	1 - 100	Response message from Bank	Success	Mandatory
8	Transaction Status	String	1 - 50	Status of transaction	PASS	Mandatory
9	Card Transaction Type	String	1 - 100	Type of transaction (Eg. SALE)	SALE	Mandatory
10	Transaction Date Time	String	1 - 100	Date and time of transaction	44910.8428	Mandatory
11	RRN	String	0 - 12	Transaction reference number	000020	Mandatory
12	Auth Code	String	0 - 6	Transaction auth code	0	Mandatory
13	Acquirer Name	String	0 - 48	Card acquirer name	ICICI	Mandatory
14	Transaction Amount	String	0 - 8	Transaction amount in paise	100	Mandatory
15	Masked Pan Number	String	0 - 19	Masked Card number	************6954	Mandatory
16	Card Holder Name	String	0 - 25	Card Holder name	VIKASH KUMAR	Mandatory
17	Bank Mid	String	0 - 15	Bank merchant ID for uploaded bill	0	Mandatory
18	Bank Tid	String	0 - 8	Bank Terminal ID for uploaded bill	65743567	Mandatory
19	Batch Number	String	6	Batch number	17	Mandatory
20	Invoice Number	String	1 - 6	Invoice number for uploaded bill Range 0 - 999999	59	Mandatory
21	Card Type	String	0 - 12	Type of card (Eg. VISA)	VISA	Mandatory
22	Card Entry Mode	String	1 - 5	Card Entry Mode Range 0 - 32767	CARD_CHIP	Mandatory
23	Acquirer Code	String	1 - 8	Card acquirer code	2	Mandatory
24	Merchant Name	String	0 - 23	Name of merchant	PINELABS	Mandatory
25	Merchant Address	String	0 - 23	Address of merchant	PINELABS	Mandatory
26	Merchant City	String	0 - 23	City of merchant	PINELABS	Mandatory
27	Batch Status	String	4 or 6	Status of batch (eg. OPEN)	OPEN or CLOSE	Mandatory
28	Additional Information Tag1	String	1 - 100	AdditionalInfo tag 1	NA	Mandatory
29	Additional Information Val1	String	1 - 100	AdditionalInfo value 1	NA	Mandatory
30	Additional Information Tag2	String	1 - 100	AdditionalInfo tag 2	NA	Mandatory
31	Additional Information Val2	String	1 - 100	AdditionalInfo value 2	NA	Mandatory

Request

HEX String Format	ASCII Format
021000099700B9373030312C343239353230333735372C53414C452C3130302C33303030303030303130303030312C31343738322C393339382C3137322C2C2C31364439414639442D394132332D343038462D393732312D3145364534383032433145302C68747470733A2F2F7777772E706C75747573636C6F7564736572766963657561742E696E3A383230312F6170692F436C6F75644261736564496E746567726174696F6E2F56312F506572666F726D54786E56616C69646174696F6E0323	— ¹7001,4295203757,SALE,100,30000000100001,14782,9398,172,,,16D9AF9D-9A23-408F-9721-

Response

HEX String Format

ASCII Format

0299991997000100DE01373030312C535543434553532C312C545831323334353637382C302C5345512D3531332C535543434553532C504153532C53414C452C32312D30362D323032312031393A33353A323720504D2C34323433313237302C30302C49434943492C313630303030302C3432303733392A2A2A2A2A2A343735302C5445535420434152442C3030303030303030303030303030302C38303031323435382C33332C3136342C4D41455354524F2C434152445F434849502C30322C50494E454C4142532C50494E454C4142532C50494E454C4142532C434C4F5345442C2C2C2C2C037B

™™— Þ7001,SUCCESS,1,TX12345678,0,SEQ-513,SUCCESS,PASS,SALE,21-06-2021 19:35:27 PM,42431270,00,ICICI,1600000,420739******4750,TEST CARD,000000000000000,80012458,33,164,MAESTRO,CARD_CHIP,02,PINELABS,PINELABS,PINELABS,CLOSED,,,,,{

JSON Request:

 
      
      Coming Soon

JSON Response:

 
      
      
      Coming Soon

Settlement

Settlement transaction is used to settle the open batch in the terminal.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types. Range: 4001-4216	6001	Mandatory

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
31	Settlement Summary (Optional)	String	-	Settlement summary	-	Mandatory

Request

HEX String Format	ASCII Format
10000997001A363030312C2C2C2C2C2C2C2C2C2C2CFF	— 6001,,,,,,,,,,,ÿ

Response

HEX String Format

ASCII Format

9999199700010221012C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2031303030303A317C31303030313A49434943497C31303035303A50696E65206D65726368616E742073746F72657C31303835313A536574746C656D656E74205265706F72747C31303035313A526F68696E69205365632031327C31303930303A42616E67616C6F72657C31303130303A30372F30312F323031357C31303130313A31322D31322D32337C31303135303A3939363534353435343534313835317C31303135313A36353835343137387C31303230303A3030303031307C31303930313A44657461696C73205265706F72747C31303935313A494E564F494345204E554D424552205452414E53414354494F4E2054595045204155544820434F44452043415244204E554D4245522043415244205459504520414D4F554E547C31313030303A31302053414C4520303030303030202A2A2A2A2A2A2A2A2A2A2A2A3238303220564953412052532E313030302E31317C31313030313A534554544C454D454E5420434F4D504C4554457C31313035303A332052533930322E39377C31313035313A302052532E302E30307C31313130303A302052532E302E30307C31313130313A2052533930322E39377C31313135303A302052532E302E30307C31313135313A2052532E302E30307C31313230303A52532E3930322E39372C2C2C2C2049434943492C312C31313135393837342C312C323534322E30302C302C302E30302C2CFF

™™— !,,,,,,,,,,,,,,,,,,,,,,,,,, 10000:1|10001:ICICI|10050:Pine merchant store|10851:Settlement Report|10051:Rohini Sec 12|10900:Bangalore|10100:07/01/2015|10101:12-12-23|10150:996545454541851|10151:65854178|10200:000010|10901:Details Report|10951:INVOICE NUMBER TRANSACTION TYPE AUTH CODE CARD NUMBER CARD TYPE AMOUNT|11000:10 SALE 000000 ************2802 VISA RS.1000.11|11001:SETTLEMENT COMPLETE|11050:3 RS902.97|11051:0 RS.0.00|11100:0 RS.0.00|11101: RS902.97|11150:0 RS.0.00|11151: RS.0.00|11200:RS.902.97,,,, ICICI,1,11159874,1,2542.00,0,0.00,,ÿ

JSON Request:

 
          
        Coming Soon

JSON Response:

 
          
        
        Coming Soon

Wallet

In integrated mode, wallet payments transactions can be launched directly from external billing/retail applications avoiding the need for dual amount input. Also, the transaction response details are passed to the external application. Transaction completion can be used to automatically link the EFT payment transaction with the billing sale transaction for reconciliation.

Sr. No.	Type of Transactions	Transaction type CSV Field 1
1	WalletPay	5102
2	WalletLoad	5103
2	WalletVoid	5104

Wallet Pay

A transaction between two parties where the buyer receives goods (tangible or intangible),services and/or assets in exchange for wallet money.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types. Range: 4001-4216	5102	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external application. Plutus will only use this value for printing on charge slip.	“TX12345678”	Optional
3	Total EFT amount	Long Integer	1 to 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa). Range: 1 – 99999999	999999	Mandatory
4	Wallet Program ID	Integer	1-999	This ID will be assigned by Pine Labs to each wallet program type. While performing any Wallet transaction, this field needs to be set to identify wallet host. For Jio Money, this value will be 101.	101	Optional
5	Wallet Identifier Data(card/ mobile/barcode)	String	1 – 76	Mobile/Barcode/Card Number. If not set, terminal will prompt to capture these values. For Jio Money, Barcode needs to be captured at Billing POS and sent in this field.		Optional
6	Type of Wallet Input Identifier	String	1 – 37	Type of Wallet identifier Contained in Field 4. Mobile Number – 01, Barcode – 02, Swipe - 03	1	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default, it is TRUE.	TRUE	Optional
10	Operator	String	1 – 31	Operator		Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 – 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 – 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 – 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 – 12	Card association name, if valid card was swiped. Otherwise, empty string	“VISA”	Mandatory
8	Invoice Number/EDC ROC(in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip)	78/101	Mandatory
9	Batch Number/EDC Batch ID(in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)		Optional
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string	“30000001”	Optional
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used.	0	Optional
12	Remark	String	0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	“Failed to dial modem”	Optional
13	Transaction Acquirer Name	String	0 – 48	Name of acquirer to which transaction was routed	“ICICI BANK”	Optional
14	Merchant ID	String	0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	“000100090015607”	Optional
15	Retrieval Reference Number	String	0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	“000000012843”	Optional
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry, 1 – Swipe entry, 2 – Chip card entry Any other value – card not validated	1	Optional
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name, 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip.	0	Optional
18	Merchant Name	String	0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	“NOBLE MOTORS”	Optional
19	Merchant Address	String	0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	“HAJI ALI”	Optional
20	Merchant City	String	0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	“MUMBAI”	Optional
21	Plutus Version	String	0 – 40	Plutus version	“v1.54 (for ICICI BANK)”	Optional
22	Wallet Code	Integer	0 – 999	Wallet Code for which transaction was processed. For Jio Money value will be 101.	101	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Optional
28	RFU1/Coupon code/Loyalty Card Number	String	0 – 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Optional
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 – 99	Amount will always be in paisa or lowest currency.	“100000”	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Optional
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24hour format.	“210403”	Optional
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Optional

Request

HEX String Format	ASCII Format
100009970019353130322C545831323334353637382C203130302C3130312CFF	— 5102,TX12345678, 100,101,ÿ

Response

HEX String Format

ASCII Format

999919970001010A22313233222C22303438363638222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A37363639222C2239383037222C22435553544F4D45522F4A494F204D4F4E4559222C202257414C4C4554222C22313038222C2239303232222C223130303031313430222C22222C22222C20224A494F204D4F4E4559222C22313030303031303030303030303938222C22303134383937303030353236222C2231222C2230222C22524C454E4F564F53746F7265222C22536563746F72203632222C224E4F494441222C2276312E302E30222C22313031222C22222C22222C22222C22222C22222C22222C22313030222C22222C22222C223131303532303135222C2231393338343822FF

™™— "123","048668","APPROVED","************7669","9807","CUSTOMER/JIO MONEY", "WALLET","108","9022","10001140","","", "JIO MONEY","100001000000098","014897000526","1","0","RLENOVOStore","Sector 62","NOIDA","v1.0.0","101","","","","","","","100","","","11052015","193848"ÿ

JSON Request:

 
             
          Coming Soon

JSON Response:

 
             
          
          Coming Soon

Wallet Load

Wallet load transaction is used to load/top-up the wallet money.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types. Range: 4001-4216	5103	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external application. Plutus will only use this value for printing on charge slip.	“TX12345678”	Optional
3	Total EFT amount	Long Integer	1 to 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa). Range: 1 – 99999999	999999	Mandatory
4	Wallet Program ID	Integer	1-999	This ID will be assigned by Pine Labs to each wallet program type. While performing any Wallet transaction, this field needs to be set to identify wallet host. For Jio Money, this value will be 101.	101	Optional
5	Wallet Identifier Data(card/ mobile/barcode)	String	1 – 76	Mobile/Barcode/Card Number. If not set, terminal will prompt to capture these values. For Jio Money, Barcode needs to be captured at Billing POS and sent in this field.		Optional
6	Type of Wallet Input Identifier	String	1 – 37	Type of Wallet identifier Contained in Field 4. Mobile Number – 01, Barcode – 02, Swipe - 03	1	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default, it is TRUE.	TRUE	Optional
10	Operator	String	1 – 31	Operator		Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 – 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 – 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 – 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 – 12	Card association name, if valid card was swiped. Otherwise, empty string	“VISA”	Mandatory
8	Invoice Number/EDC ROC(in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip)	78/101	Mandatory
9	Batch Number/EDC Batch ID(in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)		Optional
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string	“30000001”	Optional
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used.	0	Optional
12	Remark	String	0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	“Failed to dial modem”	Optional
13	Transaction Acquirer Name	String	0 – 48	Name of acquirer to which transaction was routed	“ICICI BANK”	Optional
14	Merchant ID	String	0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	“000100090015607”	Optional
15	Retrieval Reference Number	String	0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	“000000012843”	Optional
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry, 1 – Swipe entry, 2 – Chip card entry Any other value – card not validated	1	Optional
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name, 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip.	0	Optional
18	Merchant Name	String	0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	“NOBLE MOTORS”	Optional
19	Merchant Address	String	0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	“HAJI ALI”	Optional
20	Merchant City	String	0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	“MUMBAI”	Optional
21	Plutus Version	String	0 – 40	Plutus version	“v1.54 (for ICICI BANK)”	Optional
22	Wallet Code	Integer	0 – 999	Wallet Code for which transaction was processed. For Jio Money value will be 101.	101	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Optional
28	RFU1/Coupon code/Loyalty Card Number	String	0 – 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Optional
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 – 99	Amount will always be in paisa or lowest currency.	“100000”	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Optional
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24hour format.	“210403”	Optional
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Optional

Request

HEX String Format	ASCII Format
100009970019353130332C545831323334353637382C203130302C3130312CFF	Â— 5103,TX12345678, 100,101,Ã¿

Response

HEX String Format

ASCII Format

Â™Â™Â— "123","048668","APPROVED","************7669","9807","CUSTOMER/JIO MONEY", "WALLET","108","9022","10001140","","", "JIO MONEY","100001000000098","014897000526","1","0","RLENOVOStore","Sector 62","NOIDA","v1.0.0","101","","","","","","","100","","","11052015","193848"Ã¿

JSON Request:

 
             
          Coming Soon

JSON Response:

 
             
          
          Coming Soon

Wallet Void

The Wallet Void transaction is used to reverse a previously approved Wallet Sale transaction.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types. Range: 4001-4216	5104	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external application. Plutus will only use this value for printing on charge slip.	“TX12345678”	Optional
3	Total EFT amount	Long Integer	1 to 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa). Range: 1 – 99999999	999999	Mandatory
4	Wallet Program ID	Integer	1-999	This ID will be assigned by Pine Labs to each wallet program type. While performing any Wallet transaction, this field needs to be set to identify wallet host. For Jio Money, this value will be 101.	101	Optional
5	Wallet Identifier Data(card/ mobile/barcode)	String	1 – 76	Mobile/Barcode/Card Number. If not set, terminal will prompt to capture these values. For Jio Money, Barcode needs to be captured at Billing POS and sent in this field.		Optional
6	Type of Wallet Input Identifier	String	1 – 37	Type of Wallet identifier Contained in Field 4. Mobile Number – 01, Barcode – 02, Swipe - 03	1	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default, it is TRUE.	TRUE	Optional
10	Operator	String	1 – 31	Operator		Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 – 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 – 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 – 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 – 12	Card association name, if valid card was swiped. Otherwise, empty string	“VISA”	Mandatory
8	Invoice Number/EDC ROC(in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip)	78/101	Mandatory
9	Batch Number/EDC Batch ID(in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)		Optional
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string	“30000001”	Optional
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used.	0	Optional
12	Remark	String	0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	“Failed to dial modem”	Optional
13	Transaction Acquirer Name	String	0 – 48	Name of acquirer to which transaction was routed	“ICICI BANK”	Optional
14	Merchant ID	String	0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	“000100090015607”	Optional
15	Retrieval Reference Number	String	0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	“000000012843”	Optional
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry, 1 – Swipe entry, 2 – Chip card entry Any other value – card not validated	1	Optional
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name, 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip.	0	Optional
18	Merchant Name	String	0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	“NOBLE MOTORS”	Optional
19	Merchant Address	String	0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	“HAJI ALI”	Optional
20	Merchant City	String	0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	“MUMBAI”	Optional
21	Plutus Version	String	0 – 40	Plutus version	“v1.54 (for ICICI BANK)”	Optional
22	Wallet Code	Integer	0 – 999	Wallet Code for which transaction was processed. For Jio Money value will be 101.	101	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Optional
28	RFU1/Coupon code/Loyalty Card Number	String	0 – 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Optional
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 – 99	Amount will always be in paisa or lowest currency.	“100000”	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Optional
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24hour format.	“210403”	Optional
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Optional

Request

HEX String Format	ASCII Format
100009970029353130342C313234352C3130302C2C2C2C2C2C2C2C2C393032332C3131392C2C2C2C2C2C2C2C2C2C2CFF	— )5104,1245,100,,,,,,,,,9023,119,,,,,,,,,,,ÿ

Response

HEX String Format

ASCII Format

99991997000101E32231323435222C22303035343336222C2253554343455353222C222A2A2A2A2A2A36343030222C2220222C22222C22222C22323630222C2239313032222C2241424344313233343636222C22222C22222C2250484F4E45205045222C224D32333036313630343833323230363735353739313430222C22222C22222C2230222C22766172756E73746F7265222C226A6169707572222C224144494C41424144222C2276312E302E30222C22313035222C22222C22222C2022222C22222C22222C22222C2233393030222C22222C22222C223034313332303137222C2231343330303322FF

™™— ã"1245","005436","SUCCESS","******6400"," ","","","260","9102","ABCD123466","","","PHONE PE","M2306160483220675579140","","","0","varunstore","jaipur","ADILABAD","v1.0.0","105","","", "","","","","3900","","","04132017","143003"ÿ

JSON Request:

 
             
          Coming Soon

JSON Response:

 
             
          
          Coming Soon

Sodexo Sale

A transaction between two parties where the buyer receives goods (tangible or intangible),services and/or assets in exchange for sodexo coupons/Points.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer to the table above Values: 5120, 5121, 5122, 5123	5106	Mandatory
2	Billing ReferenceNumber	String	0 - 25	Transaction reference number from external application. Plutus will use this value for only printing on chargeslip only.	“TX12345678”	Optional
3	Total EFT amount	Long Integer	1 – 99999999	Amount to be charged to card – expressed as a whole number in lowest currency unit (i.e., in paisa)	999999	Mandatory
4	UPI/BHARAT QR Program ID	Integer	1-999	This Id will be assigned by PineLabs to each UPI/BHARAT QR program types. While performing any UPI/BHARAT QR transaction, this field needs to be set to identify UPI/BHARAT QR host.		Mandatory
5	UPI/BHARAT QR Identifier Data	String	1 – 76			Optional
6	Track 2 data / Expiry date	String	1 – 37	Track2 data of the card or expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360 if Track1 consists of GV or mobile number, this field will indicate the card entry mode.	(NA for Sodexo)	Optional
7	Invoice number	Long integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the invoice number of parent transaction.		Mandatory
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE	TRUE (NA for Sodexo)	Mandatory
9	Terminal ID	String	1 – 8	RFU	(NA for Sodexo)	Optional
10	Operator	String	1-31	Operator	(NA for Sodexo)	Optional
11	RFU2	String		RFU	(NA for Sodexo)	Optional
12	EDC Batch ID	Integer ID	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the batch id of parent transaction.		Optional
13	EDC ROC	Integer	101-999	If independent transaction, then it is not required. Else in case of dependent transaction, it is the ROC of parent transaction.	201	Optional
14	Transaction log ID	Long integer		If independent transaction, then it is not required. Else in case of dependent transaction, it is the transaction log of parent transaction. Range: 1-184467440737	123234 (NA for Sodexo)	Optional
15	Reward\Cash amount	Long Integer		Amount to be paid by reward points or in cash in paise (or in lowest currency). Range: 1 – 99999999	999999 (NA for Sodexo)	Mandatory
16	Customer Mobile number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000 (NA for Sodexo)	Mandatory
17	Customer email id(s)	String	1 – 500	Customer email id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com (NA for Sodexo)	Mandatory
18	Merchant Mobile Number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000 (NA for Sodexo)	Mandatory
19	Merchant email id(s)	String	1 – 500	Merchant email id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com (NA for Sodexo)	Mandatory
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from the customer for sending charge slip on his/her mobile number(s).	TRUE (NA for Sodexo)	Mandatory
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant	TRUE (NA for Sodexo)	Mandatory
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from the customer for sending charge slip on his/her mobile number(s).	TRUE (NA for Sodexo)	Mandatory
23	Consent to send charge slip on merchant mobile email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from the customer for sending charge slip on his/her email id(s).	TRUE (NA for Sodexo)	Mandatory
24	Wallet Program ID	Integer	3	This ID will be assigned by Pine labs to each wallet program type. While performing any Wallet transaction, this field needs to be set to identify wallet host. Range: 1-999	3 (NA for Sodexo)	Mandatory

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application. Plutus will use this value for only printing on chargeslip only.	TX12345678	Mandatory
2	Approval Code	String	1 – 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	5261AJ	Mandatory
3	Host Response	String	0 – 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	APPROVED	Mandatory
4	Card Number	String	0 – 19	Card number is valid if card was swiped. Otherwise, empty string.	************2802	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	XXXX	Mandatory
6	Cardholder’s Name	String	0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	AMIT MOHAN	Mandatory
7	Card Type	String	0 – 12	Card association name, if valid card was swiped. Otherwise, empty string.	VISA	Mandatory
8	Invoice Number/EDC ROC(in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip)	78/101	Mandatory
9	Batch Number/EDC Batch ID(in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string	30000001	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	Failed to dial modem	Mandatory
13	Transaction Acquirer Name	String	0 – 48	Name of acquirer to which transaction was routed	ICICI BANK	Mandatory
14	Merchant ID	String	0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	000100090015607	Mandatory
15	Retrieval Reference Number	String	0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	000000012843	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	NOBLE MOTORS	Mandatory
19	Merchant Address	String	0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	HAJI ALI	Mandatory
20	Merchant City	String	0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	MUMBAI	Mandatory
21	Plutus Version	String	0 – 40	Plutus version	v1.54 (for ICICI BANK)	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK 02 – ICICI BANK 03 – AMERICAN EXPRESS 04 – CITIBANK 05 – AXIS BANK 06 – SBI 07 – HSBC 09 – CORP BANK 10 – CUB (City Union Bank) 14 – IDBI Bank 17 – LVB (Lakshmi Vilas Bank) 51- PINE 360 301-Sodexo 81 – Loyalty Reward 82 – Aimia 85 – SBI Rewards	Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	10000	Mandatory
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points	400.00	Mandatory
25	Reward Balance Amount	String	0 - 10	Balance Amount	1000000	Mandatory
26	Reward Balance Points	Double	0 - 15	Balance Point	40000.00	Mandatory
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 – 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	5.50	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 – 99	Amount will always be in paisa or lowest currency.	100000	Mandatory
30	RFU3	String	0 – 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	02012011	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24hour format.	210403	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
10000997002A353130362C543030303135303130303030303333322C3130302C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2CFF	Â— *5106,T000150100000332,100,,,,,,,,,,,,,,,,,Ã¿

Response

HEX String Format

ASCII Format

99991997000101002254303030313530313030303030333332222C22313236393336222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A30303635222C2258585858222C22222C22222C22313031222C2239313237222C223730303030313136222C2230222C22415050524F564544222C22534F4445584F222C2232333431222C22313630313131303030303639222C2231222C2231222C2254657374537420726556696E6974222C226D617975722076696861722033222C224D4545525554222C22762E30312E30302E3030222C22333031222C22222C22222C22222C22222C22222C22222C22222C22222C22222C223037303132303136222C2231313132313822FF

Â™Â™Â— "T000150100000332","126936","APPROVED","************0065","XXXX","","","101","9127","70000116","0","APPROVED","SODEXO","2341","160111000069","1","1","TestSt reVinit","mayur vihar 3","MEERUT","v.01.00.00","301","","","","","","","","","","07012016","111218"Ã¿

JSON Request:

 
        
      Coming Soon

JSON Response:

 
        
      
      Coming Soon

Sodexo Void

The Sodexo Void transaction is used to reverse a previously approved Sodexo sale transaction.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer to the table above Values: 5120, 5121, 5122, 5123	5107	Mandatory
2	Billing ReferenceNumber	String	0 - 25	Transaction reference number from external application. Plutus will use this value for only printing on chargeslip only.	“TX12345678”	Optional
3	Total EFT amount	Long Integer	1 – 99999999	Amount to be charged to card – expressed as a whole number in lowest currency unit (i.e., in paisa)	999999	Mandatory
4	UPI/BHARAT QR Program ID	Integer	1-999	This Id will be assigned by PineLabs to each UPI/BHARAT QR program types. While performing any UPI/BHARAT QR transaction, this field needs to be set to identify UPI/BHARAT QR host.		Mandatory
5	UPI/BHARAT QR Identifier Data	String	1 – 76			Optional
6	Track 2 data / Expiry date	String	1 – 37	Track2 data of the card or expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360 if Track1 consists of GV or mobile number, this field will indicate the card entry mode.	(NA for Sodexo)	Optional
7	Invoice number	Long integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the invoice number of parent transaction.		Mandatory
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE	TRUE (NA for Sodexo)	Mandatory
9	Terminal ID	String	1 – 8	RFU	(NA for Sodexo)	Optional
10	Operator	String	1-31	Operator	(NA for Sodexo)	Optional
11	RFU2	String		RFU	(NA for Sodexo)	Optional
12	EDC Batch ID	Integer ID	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the batch id of parent transaction.		Optional
13	EDC ROC	Integer	101-999	If independent transaction, then it is not required. Else in case of dependent transaction, it is the ROC of parent transaction.	201	Optional
14	Transaction log ID	Long integer		If independent transaction, then it is not required. Else in case of dependent transaction, it is the transaction log of parent transaction. Range: 1-184467440737	123234 (NA for Sodexo)	Optional
15	Reward\Cash amount	Long Integer		Amount to be paid by reward points or in cash in paise (or in lowest currency). Range: 1 – 99999999	999999 (NA for Sodexo)	Mandatory
16	Customer Mobile number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000 (NA for Sodexo)	Mandatory
17	Customer email id(s)	String	1 – 500	Customer email id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com (NA for Sodexo)	Mandatory
18	Merchant Mobile Number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000 (NA for Sodexo)	Mandatory
19	Merchant email id(s)	String	1 – 500	Merchant email id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com (NA for Sodexo)	Mandatory
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from the customer for sending charge slip on his/her mobile number(s).	TRUE (NA for Sodexo)	Mandatory
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant	TRUE (NA for Sodexo)	Mandatory
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from the customer for sending charge slip on his/her mobile number(s).	TRUE (NA for Sodexo)	Mandatory
23	Consent to send charge slip on merchant mobile email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from the customer for sending charge slip on his/her email id(s).	TRUE (NA for Sodexo)	Mandatory
24	Wallet Program ID	Integer	3	This ID will be assigned by Pine labs to each wallet program type. While performing any Wallet transaction, this field needs to be set to identify wallet host. Range: 1-999	3 (NA for Sodexo)	Mandatory

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application. Plutus will use this value for only printing on chargeslip only.	TX12345678	Mandatory
2	Approval Code	String	1 – 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	5261AJ	Mandatory
3	Host Response	String	0 – 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	APPROVED	Mandatory
4	Card Number	String	0 – 19	Card number is valid if card was swiped. Otherwise, empty string.	************2802	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	XXXX	Mandatory
6	Cardholder’s Name	String	0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	AMIT MOHAN	Mandatory
7	Card Type	String	0 – 12	Card association name, if valid card was swiped. Otherwise, empty string.	VISA	Mandatory
8	Invoice Number/EDC ROC(in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip)	78/101	Mandatory
9	Batch Number/EDC Batch ID(in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string	30000001	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	Failed to dial modem	Mandatory
13	Transaction Acquirer Name	String	0 – 48	Name of acquirer to which transaction was routed	ICICI BANK	Mandatory
14	Merchant ID	String	0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	000100090015607	Mandatory
15	Retrieval Reference Number	String	0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	000000012843	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	NOBLE MOTORS	Mandatory
19	Merchant Address	String	0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	HAJI ALI	Mandatory
20	Merchant City	String	0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	MUMBAI	Mandatory
21	Plutus Version	String	0 – 40	Plutus version	v1.54 (for ICICI BANK)	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK 02 – ICICI BANK 03 – AMERICAN EXPRESS 04 – CITIBANK 05 – AXIS BANK 06 – SBI 07 – HSBC 09 – CORP BANK 10 – CUB (City Union Bank) 14 – IDBI Bank 17 – LVB (Lakshmi Vilas Bank) 51- PINE 360 301-Sodexo 81 – Loyalty Reward 82 – Aimia 85 – SBI Rewards	Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	10000	Mandatory
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points	400.00	Mandatory
25	Reward Balance Amount	String	0 - 10	Balance Amount	1000000	Mandatory
26	Reward Balance Points	Double	0 - 15	Balance Point	40000.00	Mandatory
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 – 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	5.50	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 – 99	Amount will always be in paisa or lowest currency.	100000	Mandatory
30	RFU3	String	0 – 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	02012011	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24hour format.	210403	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
100009970032353130372C543030303135303130303030303333342C333036302C2C2C2C2C2C2C2C2C393030312C3130312C2C2C2C2C2C2CFF	Â— 25107,T000150100000334,3060,,,,,,,,,9001,101,,,,,,,Ã¿

Response

HEX String Format

ASCII Format

99991997000101002254303030313530313030303030333334222C22313230303038222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A30303635222C2258585858222C22222C22222C22313035222C2239313237222C223730303030313136222C2230222C22415050524F564544222C22534F4445584F222C2232333431222C22313630313131303030303731222C2231222C2231222C225465737453746F726556696E6974222C226D617975722076696861722033222C224D4545525554222C22762E30312E30302E3030222C22333031222C22222C22222C22222C22222C22222C22222C22222C22222C22222C223037303132303136222C2231313239333022FF

Â™Â™Â— "T000150100000334","120008","APPROVED","************0065","XXXX","","","105","9127","70000116","0","APPROVED","SODEXO","2341","160111000071","1","1","TestStoreVinit","mayur vihar 3","MEERUT","v.01.00.00","301","","","","","","","","","","07012016","112930"Ã¿

JSON Request:

 
        
      Coming Soon

JSON Response:

 
        
      
      Coming Soon

Sale With/Without Instant Discount

Earlier, when we take payment with the card which is not eligible for instant discount then the device displayed the message as “Instant discount not applicable. Initiate Normal Sale” and the transaction was not completed.
So, new transaction type has been included to complete the Sale transaction irrespective of whether instant discount is applicable or not.

Request

HEX String Format	ASCII Format
10000997002A343630332C546573743132332C3330303030302C2C2C2C2C2C2C2C2C2C2C2C2C3130312C2C2C2C2C2C2CFF	*4603,Test123,300000,,,,,,,,,,,,,101,,,,,,,ÿ

Response - When Dicount Applicable

HEX String Format

ASCII Format

99991997000101582254657374313233222C223030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A34393736222C2258585858222C2254455354204D45200D0A464F555254594E494E45222C224D41455354524F222C37392C31362C223536353637353638222C302C2250524F434553534544222C22484446432042414E4B222C222020202020202020202020202020200D0A222C22303030303030303030303230222C322C312C224C4F564520434F4D4D554E49434154494F4E222C224A414E412050555249222C224E45572044454C48492020202044454C20202020202020222C22506C757475732076312E34392E33200D0A4D5420484446432042414E4B222C30312C22222C22222C22222C22222C22222C223130317C3330303030307C3236303030307C34303030307C4943494349200D0A4465626974222C22222C22222C22222C223039303932303230222C2231343239303422FF

X"Test123","00","APPROVED","************4976","XXXX","TEST ME FOURTYNINE","MAESTRO",79,16,"56567568",0,"PROCESSED","HDFC BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANA PURI","NEW DELHI DEL ","Plutus v1.49.3 MT HDFC BANK",01,"","","","","","101|300000|260000|40000|ICICI Debit","","","","09092020","142904"ÿ

Response - When Dicount Not Applicable

HEX String Format

ASCII Format

999919970001013B2254657374313233222C223030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A34363336222C2258585858222C22554441592043484F50524120202020202020202020202020200D0A2F222C224D41455354524F222C38382C31362C223536353637353638222C302C2250524F434553534544222C22484446432042414E4B222C22202020202020202020202020202020222C22303030303030303030303230222C322C312C224C4F5645200D0A434F4D4D554E49434154494F4E222C224A414E412050555249222C224E45572044454C48492020202044454C20202020202020222C22506C757475732076312E34392E33204D542048444643200D0A42414E4B222C30312C22222C22222C22222C22222C22222C22222C22222C22222C22222C223039303932303230222C2231363039313622FF

;"Test123","00","APPROVED","************4636","XXXX","UDAY CHOPRA /","MAESTRO",88,16,"56567568",0,"PROCESSED","HDFC BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANA PURI","NEW DELHI DEL ","Plutus v1.49.3 MT HDFC BANK",01,"","","","","","","","","","09092020","160916"ÿ

JSON Request:

 
         
      Coming Soon

JSON Response:

 
         
      
      Coming Soon

QC Redemption

A transaction between two parties where the buyer receives goods (tangible or intangible),services and/or assets in exchange for customer Loyalty Points.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	4205	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

This transaction has been included to accept QC Gift Card on Pine Labs terminal.

Request

HEX String Format	ASCII Format
10000997002C343230352C54584E31323334352C31303030302C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2C2CFF	,4205,TXN12345,10000,,,,,,,,,,,,,,,,,,,,,,,,,ÿ

Response - With Card Number

HEX String Format

ASCII Format

99991997000100E32254584E3132333435222C223233363434333330222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A32393138222C22222C22222C22222C2231222C223932222C2235303338313839222C22222C2253756363657373222C22500D0A494E4520333630222C22363839222C22303030303035393432333131222C22222C2231222C22222C22222C22222C22506C757475732076312E302E302050494E45200D0A333630222C35312C22222C22222C22222C22222C22222C22222C22222C223233363434333330222C22222C223039303432303230222C2231333133343422FF

㢔XN12345","23644330","APPROVED","************2918","","","","1","92","5038189","","Success","P INE 360","689","000005942311","","1","","","","Plutus v1.0.0 PINE 360",51,"","","","","","","","23644330","","09042020","131344"ÿ

Response - With Card Swipe

HEX String Format

ASCII Format

999919970001011A2254584E3132333435222C223233363431333737222C22415050524F564544222C2239393939393939393939393332393138222C22222C222A2A2A2A2A2A2A2A2A2A2A2A32393138222C22222C2231222C223931222C22353033380D0A313839222C22222C2253756363657373222C2250494E4520333630222C22363839222C22303030303035393432333034222C22222C2231222C22222C22222C22222C22506C757475732076312E302E302050494E45200D0A333630222C35312C22222C22222C22222C22222C22222C2235327C3B393939393939393939393933323931383D3030303039393930393638343335353F7C222C22222C223233363431333737222C22222C223039303432303230222C223132203032303122FF

"TXN12345","23641377","APPROVED","9999999999932918","","************2918","","1","91","5038 189","","Success","PINE 360","689","000005942304","","1","","","","Plutus v1.0.0 PINE 360",51,"","","","","","52|;9999999999932918=000099909684355?|","","23641377","","09042020","12 0201"ÿ

JSON Request:

 
        
    Coming Soon

JSON Response:

 
        
    
    Coming Soon

HDFC Flexipay - PoS (Pay Later)

HDFC Flexipay PoS is a new payment mode under Pine Labs BNPL offering in which customers will get options to choose 15,30,60 and 90 days tenure. HDFC bank’s Debit card customer can avail this facility and pay the amount with interest based on their convenient tenure. In this feature, HDFC Flexipay offers 15 days No Cost Interest to their customers.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	5030	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
10000997001C353033302C54584E3132332C3130303030302C2C2C2C2C2C2C2C2C2CFF	— 5030,TXN123,100000,,,,,,,,,,ÿ

Response

HEX String Format

ASCII Format

999919970001015E2254584E313233222C223030222C22415050524F564544222C222A2A2A2A2A2A2A2A2A2A2A2A32383032222C2258585858222C224E4954494E20504F44444152202020202020202020202020200D0A2F222C224D41455354524F222C3332392C35342C223234333234333235222C302C2250524F434553534544222C22484446432042414E4B222C22202020202020202020202020202020222C22303030303030303030303230222C322C312C224C4F5645200D0A434F4D4D554E49434154494F4E222C224A414E412050555249222C224E45572044454C48492020202044454C20202020202020222C22506C757475732076312E34392E33204D542048444643200D0A42414E4B222C30312C22222C22222C22222C22222C22222C223131397C31357C484446432044656269747C39393636387C3130303030307C333332222C22222C22222C22222C223036333032303231222C223138353033352220FF

™™— ^"TXN123","00","APPROVED","************2802","XXXX","NITIN PODDAR /","MAESTRO",329,54,"24324325",0,"PROCESSED","HDFC BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANA PURI","NEW DELHI DEL ","Plutus v1.49.3 MT HDFC BANK",01,"","","","","","119|15|HDFC Debit|99668|100000|332","","","","06302021","185035" ÿ

JSON Request:

 
        
      Coming Soon

JSON Response:

 
        
      
      Coming Soon

Zest Money

This section will define the request/response packet under integrated mode.

Below are the transaction types under Zest Money:

Sr. No.	Type of Transactions	Transaction type CSV Field 1
1	Zest Money Invoice Sale	5367
2	Zest Money Product Sale	5370
3	Zest Money Void	5369

For Product Sale, OEM for entity needs to be configured using PCUI.
New CSV Request/Response are created for new transaction type.

Request Parameters:

CSV Request
Description	Bank EMI (Invoice Sale)	Brand EMI (Product Sale)	Void
Transaction Type	5367	5370	5369
Billing Ref Number	TXN1234	TXN1234	TXN1234
Amount	500000	500000	500000
EntityId	optional(7, 8)	optional(7, 8)	optional(7, 8)
BankCode	,	,	,
Track1	,	,	,
Track2	,	,	,
Invoice Number	,	,	,
Card Swipe Required	,	,	,
Terminal ID	,	,	,
RFU1	,	,	,
Clear PAN	,	,	,
EDC BatchID	,	,	,
EDC ROC	,	,	Optional (any txn Roc: 120)
Product Scheme Parameters	,	,	,
Additional Amount	,	,	,
Card or MobileNumber	,	,	,
Card Expiry Date	,	,	,
Generic Data	,	,	,
Access Code	,	,	,
NII	,	,	,
Reporting Data	,	,	,
Billing App ID	,	,	,

For Product Sale, OEM for entity needs to be configured using PCUI.
New CSV Request/Response are created for new transaction type.

Response Parameters:

CSV RESPONSE
Description	Bank EMI (Invoice Sale)	Brand EMI (Product Sale)
bill num	TXN1234,	TXN1234,
approval code	00,	00,
response code	APPROVED,	APPROVED,
card number	******7890,	******7890,
expiry	,	,
card holder name	,	,
card type	,	,
ROC	147,	177,
batch num	9008,	9008,
terminal ID	292386,	292386,
loyalty points awarded	,	,
Host response	INVOICE SALE,	PRODUCT SALE,
Transaction Acquirer Name	ZESTMONEY,	ZESTMONEY,
Merchant ID	7263,	7263,
rrn	,	,
entry mode	Entry Mode : 3,	Entry Mode : 3,
Print Cardholder’s Name on receipt	,	,
merchant name	Utkarsh Merchant 1 Store 1,	Utkarsh Merchant 1 Store 1,
merchant address	Indirapuram	Indirapuram
merchant city	GHAZIABAD,	GHAZIABAD,
NBFC Txn Type	INVOICE SALE,	PRODUCT SALE,
NBFCV1Details( SchemeCode ROI Tenure EMIAmount LoanAmount DownPayment CashBack)	50795\|104500\|10months\|52426 \|5000.00\|1660.28\|242.50,	20007\|180000\|3 months\|171691\|5000.00\|35 3.00\|0.00,
response code	APPROVED,	APPROVED,
date	01252022,	01272022,
time	123555,	131052,
Txn Amount	500000,	500000,
product details( Brand Name Product Name Model Name ProductSKUCode ProdIMEINumber SchemeCode ROI Tenure EMIAmount)	,	APPLE\|PHONE(WEB- MOBILE)\|I PHONE\|PHONE(WEB- MOBILE)\|\|20007\|180000\|3\| 171691

Zest Money - Invoice Sale

"ZestMoney invoice sale" typically refers to a transaction where a customer uses ZestMoney as a payment option to convert their purchase into monthly EMIs.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	5367	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
10000997001A353336372C54584E313233342C3530303030302C2C2C2C2C2C2CFF	— 5367,TXN1234,500000,,,,,,,ÿ

Response

HEX String Format

ASCII Format

99991997000101F154584E313233342C30302C415050524F5645442C2A2A2A2A2A2A373839302C2C2C2C3134372C393030382C3239323338362C2C494E564F4943452053414C452C5A4553544D4F4E45592C373236332C2C456E747279204D6F6465203A20332C2C55746B61727368204D65726368616E7420312053746F726520312C496E64697261707572616D2C4748415A49414241442C494E564F4943452053414C452C35303739357C3130343530307C31306D6F6E7468737C35323432367C353030302E30307C313636302E32387C3234322E35302C415050524F5645442C30313235323032322C3132333535352C3530303030302CFF

™™— ñTXN1234,00,APPROVED,******7890,,,,147,9008,292386,,INVOICE SALE,ZESTMONEY,7263,,Entry Mode : 3,,Utkarsh Merchant 1 Store 1,Indirapuram,GHAZIABAD,INVOICE SALE,50795|104500|10months|52426|5000.00|1660.28|242.50,APPROVED,01252022,123555,500000,ÿ

JSON Request:

 
    
  Coming Soon

JSON Response:

 
    
  
  Coming Soon

Zest Money – Product Sale

ZestMoney product sale allows customers to finance their purchases over time, making it more affordable and accessible, especially for those who may not have access to traditional credit cards or prefer not to use them for online shopping.

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	5370	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
10000997001A353337302C54584E313233342C3530303030302C2C2C2C2C2C2CFF	— 5370,TXN1234,500000,,,,,,,ÿ

Response

HEX String Format

ASCII Format

999919970001013354584E313233342C30302C415050524F5645442C2A2A2A2A2A2A373839302C2C2C3137372C393030382C3239323338362C2C50524F445543542053414C452C5A4553544D4F4E45592C373236332C2C456E747279204D6F6465203A20332C2C55746B61727368204D65726368616E7420312053746F726520312C496E64697261707572616D2C4748415A49414241442C50524F445543542053414C452C32303030377C38303030307C336D6F6E7468737C3137313639317C353030302E30307C3335332E30307C302E30302C415050524F5645442C30313237323032322C3133313035322C3530303030302C4150504C457C50484F4E45285745422D4D4F42494C45297C4950484F4E457C50484F4E45285745422D4D4F42494C45297C7C32303030377C3138303030307C337C313731363931FF

™™— 3TXN1234,00,APPROVED,******7890,,,177,9008,292386,,PRODUCT SALE,ZESTMONEY,7263,,Entry Mode : 3,,Utkarsh Merchant 1 Store 1,Indirapuram,GHAZIABAD,PRODUCT SALE,20007|80000|3months|171691|5000.00|353.00|0.00,APPROVED,01272022,131052,500000,APPLE|PHONE(WEB-MOBILE)|IPHONE|PHONE(WEB-MOBILE)||20007|180000|3|171691ÿ

JSON Request:

 
        
      Coming Soon

JSON Response:

 
        
      
      Coming Soon

Zest Money – Void

The Zest Money Void transaction is used to reverse a previously approved Zest Money transaction.

Request

HEX String Format	ASCII Format
100009970027353336392C54584E313233342C3530303030302C2C2C2C2C2C2C2C2C2C2C3134372C2C2C2C2C2CFF	— '5369,TXN1234,500000,,,,,,,,,,,147,,,,,,ÿ

Response

HEX String Format

ASCII Format

999919970001012B2274786E31323322222C222230303030303522222C2222415050524F56454422222C2222393536303331323532354079626C22222C222222222C222222222C222255504922222C222231323622222C22223930373522222C2222343133303332303122222C22223022222C2222415050524F5620454422222C222222222C22224844464330303030303031373433313822222C222230303538333236383437353222222C222222222C22223022222C22225052414248415422222C222250696E656C61627322222C22224E4F49444122222C222276312E302E3022222C2222313922222C222222222C22222222202C222222222C222222222C222222222C222222222C222231303022222C222222222C222222222C2222303232373230323022222C222231363338313522FF

™™— +"txn123"",""000005"",""APPROVED"",""9560312525@ybl"","""","""",""UPI"",""126"",""9075"",""41303201"",""0"",""APPROV ED"","""",""HDFC000000174318"",""005832684752"","""",""0"",""PRABHAT"",""Pinelabs"",""NOIDA"",""v1.0.0"",""19"","""","""" ,"""","""","""","""",""100"","""","""",""02272020"",""163815"ÿ

JSON Request:

 
     
  Coming Soon

JSON Response:

 
     
  
  Coming Soon

UPI Sale Request

In integrated mode, UPI transactions can be launched directly from external billing/retail applications – avoiding the need for dual amount input. Also, the transaction response details are passed to the external application. Transaction completion can be used to automatically link the EFT payment transaction with the billing transaction for reconciliation.

Message Format

Request Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer to the table above.	5120,5121,5122,5123	Mandatory
2	Billing Reference Number	String	0 – 25	Transaction reference number from external application. Plutus will use this value for only printing on charge slip only.	TX12345678	Optional
3	Total EFT Amount	Long Integer	0 to 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (i.e. in paisa)	999999	Mandatory
4	UPI/BHARAT QR Program ID	Integer	1 to 3	This Id will be assigned by PineLabs to each UPI/BHARAT QR program types. While performing any UPI/BHARAT QR transaction this field needs to set to identify P/BHARAT QR host.		Mandatory
5	UPI/BHARAT QR Identifier Data	String	1 – 76			Optional
6	Type of UPI/BHARAT QR input Identifier	String	1 – 37	NA		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the invoice number of parent transaction.		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the batch id of parent transaction.		Optional
13	EDC ROC ID	Integer	101-999	If independent transaction, then it is not required. Else in case of dependent transaction, it is the ROC of parent transaction.	201	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Ref ID	String	0 – 25	Transaction reference number from external application	TX12345678	Mandatory
2	Approval Code	String	0 – 6	Authorization code, if transaction was approved. Otherwise empty string.	5261AJ	Mandatory
3	Host Response	String	0 – 50	Response string if a response for transaction was received from host. Otherwise, if any error occurs before response is received, this is an empty string.	APPROVED	Mandatory
4	Card Number	String	0 – 19	Card number is valid if card was swiped. Otherwise, empty string.	************2802	Mandatory
5	Expiration Date	String	0, 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	XXXX	Mandatory
6	Cardholder’s Name	String	0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string	AMIT MOHAN	Mandatory
7	Card Type	String	0 – 12	Card association name, if valid card was swiped. Otherwise, empty string	UPI	Mandatory
8	Invoice Number/EDC	Long Integer	0 – 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on chargeslip)	78/101	Mandatory
9	Batch Number/EDC Batch ID	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)		Mandatory
10	Terminal ID	String	0, 8	EFT TID, if transaction authorized. Otherwise, empty string	30000001	Mandatory
12	Remark	String	0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	Failed to dial modem	Mandatory
13	Transaction Acquirer Name	String	0 – 48	Name of host to which transaction was routed	AXIS UPI	Mandatory
14	Merchant ID	String	0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	000100090015607	Mandatory
15	Retrieval Reference Number	String	0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	000000012843	Mandatory
18	Merchant Name	String	0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	NOBLE MOTORS	Mandatory
19	Merchant Address	String	0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	HAJI ALI	Mandatory
20	Merchant City	String	0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	MUMBAI	Mandatory
21	Plutus Version	String	0 – 40	Plutus version	v1.0.0	Mandatory
22	UPI/Bharat QR	Integer	0 – 999	UPI/Bharat QR program type for which transaction was processed.	1	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 – 99	Amount will always be in paisa or lowest currency.	100000	Mandatory
32	Date of Transaction	String	0/8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format	02012011	Mandatory
33	Time of Transaction	String	0 /6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24 hour format.	210403	Mandatory
34	Plutus Transaction Id	Long Integer	0-19	Transaction Id Generated by PL	30000000100001	Mandatory
38	OrigBillDetails	String	0-100	EDCBatchId + "\|" + OrigEDCRoc + "\|" + OrigBillingRefNumber	9001101PL981445456	Mandatory

Request

HEX String Format	ASCII Format
10000997001B353132302C20545831323334353637382C3130302C2C2C2C2C2C2CFF	— 5120, TX12345678,100,,,,,,,ÿ

Response

HEX String Format

ASCII Format

99991997000100DA313234352C22303032313935222C2253554343455353222C22222C2220222C22222C22555049222C22323331222C2239313032222C2241424344313233343636222C22222C22222C2220555049204158495320222C224D32333036313630343833323230363735353739313430222C22222C22222C2230222C22766172756E73746F7265222C226A6169707572222C224144494C41424144222C2276312E302E30222C2233222C22222C22222C22222C22222C2220222C22222C2232353030222C22222C22222C223034313132303137222C2231363138333522

™™— Ú1245,"002195","SUCCESS",""," ","","UPI","231","9102","ABCD123466","",""," UPI AXIS ","M2306160483220675579140","","","0","varunstore","jaipur","ADILABAD","v1.0.0","3","","","",""," ","","2500","","","04112017","161835"

JSON Request:

 
    
  Coming Soon

JSON Response:

 
    
  
  Coming Soon

Bharat QR Sale request

In integrated mode, Bharat QR transactions can be launched directly from external billing/retail applications – avoiding the need for dual amount input. Also, the transaction response details are passed to the external application. Transaction completion can be used to automatically link the EFT payment transaction with the billing transaction for reconciliation.

Message Formate

Request Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer to the table above.	5123	Mandatory
2	Billing Reference Number	String	0 – 25	Transaction reference number from external application. Plutus will use this value for only printing on charge slip only.	TX12345678	Optional
3	Total EFT Amount	Long Integer	0 to 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (i.e. in paisa)	999999	Mandatory
4	UPI/BHARAT QR Program ID	Integer	1 to 3	This Id will be assigned by PineLabs to each UPI/BHARAT QR program types. While performing any UPI/BHARAT QR transaction this field needs to set to identify P/BHARAT QR host.		Mandatory
5	UPI/BHARAT QR Identifier Data	String	1 – 76			Optional
6	Type of UPI/BHARAT QR input Identifier	String	1 – 37	NA		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the invoice number of parent transaction.		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the batch id of parent transaction.		Optional
13	EDC ROC ID	Integer	101-999	If independent transaction, then it is not required. Else in case of dependent transaction, it is the ROC of parent transaction.	201	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Ref ID	String	0 – 25	Transaction reference number from external application	TX12345678	Mandatory
2	Approval Code	String	0 – 6	Authorization code, if transaction was approved. Otherwise empty string.	5261AJ	Mandatory
3	Host Response	String	0 – 50	Response string if a response for transaction was received from host. Otherwise, if any error occurs before response is received, this is an empty string.	APPROVED	Mandatory
4	Card Number	String	0 – 19	Card number is valid if card was swiped. Otherwise, empty string.	************2802	Mandatory
5	Expiration Date	String	0, 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	XXXX	Mandatory
6	Cardholder’s Name	String	0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string	AMIT MOHAN	Mandatory
7	Card Type	String	0 – 12	Card association name, if valid card was swiped. Otherwise, empty string	UPI	Mandatory
8	Invoice Number/EDC	Long Integer	0 – 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on chargeslip)	78/101	Mandatory
9	Batch Number/EDC Batch ID	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)		Mandatory
10	Terminal ID	String	0, 8	EFT TID, if transaction authorized. Otherwise, empty string	30000001	Mandatory
12	Remark	String	0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	Failed to dial modem	Mandatory
13	Transaction Acquirer Name	String	0 – 48	Name of host to which transaction was routed	AXIS UPI	Mandatory
14	Merchant ID	String	0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	000100090015607	Mandatory
15	Retrieval Reference Number	String	0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	000000012843	Mandatory
18	Merchant Name	String	0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	NOBLE MOTORS	Mandatory
19	Merchant Address	String	0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	HAJI ALI	Mandatory
20	Merchant City	String	0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	MUMBAI	Mandatory
21	Plutus Version	String	0 – 40	Plutus version	v1.0.0	Mandatory
22	UPI/Bharat QR	Integer	0 – 999	UPI/Bharat QR program type for which transaction was processed.	1	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 – 99	Amount will always be in paisa or lowest currency.	100000	Mandatory
32	Date of Transaction	String	0/8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format	02012011	Mandatory
33	Time of Transaction	String	0 /6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24 hour format.	210403	Mandatory
34	Plutus Transaction Id	Long Integer	0-19	Transaction Id Generated by PL	30000000100001	Mandatory
38	OrigBillDetails	String	0-100	EDCBatchId + "\|" + OrigEDCRoc + "\|" + OrigBillingRefNumber	9001101PL981445456	Mandatory

Request

HEX String Format	ASCII Format
10000997001B353132332C20545831323334353637382C3130302C2C2C2C2C2C2CFF	Â— 5123, TX12345678,100,,,,,,,Ã¿

Response

HEX String Format

ASCII Format

Â™Â™Â— Ú±245,"002195","SUCCESS",""," ","","UPI","231","9102","ABCD123466","",""," UPI AXIS ","M2306160483220675579140","","","0","varunstore","jaipur","ADILABAD","v1.0.0","3","","","",""," ","","2500","","","04112017","161835"

JSON Request:

 
         
      Coming Soon

JSON Response:

 
         
      
      Coming Soon

Airtel Sale

The requirement is to enable Airtel Payment Bank Integration through Pine Labs solution. Customer will enter their mobile number and receive an OTP from the bank. Customer will enter the OTP on the terminal and transaction will be completed after successful response received from the host.

Sr. No.	Type of Transactions	Transaction type CSV Field 1
1	Airtel Sale	5127

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	5127	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Request

HEX String Format	ASCII Format
100009970024353132372C543030303934303130303030303031392C353030302C2C2C2C2C2C2C2C2C2CFF	— $5127,T000940100000019,5000,,,,,,,,,,ÿ

Response - a Successful Airtel Bank transaction

HEX String Format

ASCII Format

99991997000101FB22313233222C22303030303534222C22415050524F564544222C22222C22222C22222C2241697274656C2042616E6B222C22313036222C2239303233222C223835303033222C2230222C22415050524F564544222C2241495254454C200D0A42414E4B222C22313830373034222C22343738323730222C22222C2230222C225461746120537461726275636B732053746F7265222C2250696E65204C61627320507674204C746420200D0A4E6F696461222C2244656C6869222C2276312E302E30222C223131222C22222C22222C22222C22222C22222C22222C22313030222C22222C22222C223039303632303138222C22313531313233E2809DFF

™™— û"123","000054","APPROVED","","","","Airtel Bank","106","9023","85003","0","APPROVED","AIRTEL BANK","180704","478270","","0","Tata Starbucks Store","Pine Labs Pvt Ltd Noida","Delhi","v1.0.0","11","","","","","","","100","","","09062018","151123”ÿ

Response - a Failed Airtel Bank transaction

HEX String Format

ASCII Format

999919970001012822313233222C22222C2241495254454C2042414E4B204F545020564552494649434154494F4E204641494C4544222C22222C22222C22222C2241697274656C200D0A42616E6B222C22313035222C2239303233222C223835303033222C2230222C2241495254454C2042414E4B204F545020564552494649434154494F4E204641494C4544222C2241495254454C200D0A42414E4B222C22313830373034222C22222C22222C2230222C225461746120537461726275636B732053746F7265222C2250696E65204C61627320507674204C746420200D0A4E6F696461222C2244656C6869222C2276312E302E30222C223131222C22222C22222C22222C22222C22222C22222C22313030222C22222C22222C223039303632303138222C22313530393532E2809D20FF

™™— ("123","","AIRTEL BANK OTP VERIFICATION FAILED","","","","Airtel Bank","105","9023","85003","0","AIRTEL BANK OTP VERIFICATION FAILED","AIRTEL BANK","180704","","","0","Tata Starbucks Store","Pine Labs Pvt Ltd Noida","Delhi","v1.0.0","11","","","","","","","100","","","09062018","150952” ÿ

JSON Request:

 
           
        Coming Soon

JSON Response:

 
           
        
        Coming Soon

Amazon Pay Request

In integrated mode, Amazon Pay transactions can be launched directly from external billing/retail applications avoiding the need for dual amount input. Also, the transaction response details are passed to the external application. Transaction completion can be used to automatically link the EFT payment transaction with the billing transaction for reconciliation.

TRANSCATION TYPES

Sr. No.	Type of Transactions	lTxnType Value
1	Amazon Pay Request	5129
2	Get Status	5122

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types. Range: 4001-4216	5129	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external application. Plutus will only use this value for printing on charge slip.	“TX12345678”	Optional
3	Total EFT amount	Long Integer	1 to 99999999	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa). Range: 1 – 99999999	999999	Mandatory
4	Wallet Program ID	Integer	1-999	This ID will be assigned by Pine Labs to each wallet program type. While performing any Wallet transaction, this field needs to be set to identify wallet host. For Jio Money, this value will be 101.	101	Optional
5	Wallet Identifier Data(card/ mobile/barcode)	String	1 – 76	Mobile/Barcode/Card Number. If not set, terminal will prompt to capture these values. For Jio Money, Barcode needs to be captured at Billing POS and sent in this field.		Optional
6	Type of Wallet Input Identifier	String	1 – 37	Type of Wallet identifier Contained in Field 4. Mobile Number – 01, Barcode – 02, Swipe - 03	1	Optional
7	Invoice Number	Long Integer	1 – 6	Not Applicable	000012
8	Is Swipe entry	String	TRUE or FALSE	By default, it is TRUE.	TRUE	Optional
9	Terminal ID	String	1 – 8	Not Applicable
10	Operator	String	1 – 31	Operator		Optional
11	RFU 2	String	1 – 8		Reserved for future use	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 – 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	5261AJ	Mandatory
3	Host Response	String	0 – 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	APPROVED	Mandatory
4	Card Number	String	0 – 19	Card number is valid if card was swiped. Otherwise, empty string.	************2802	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	XXXX	Mandatory
6	Cardholder’s Name	String	0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	AMIT MOHAN	Mandatory
7	Card Type	String	0 – 12	Card association name, if valid card was swiped. Otherwise, empty string.	VISA	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip. Range: 0 – 999999/101 – 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	30000001	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	Failed to dial modem	Mandatory
13	Transaction Acquirer Name	String	0 – 48	Name of acquirer to which transaction was routed	ICICI BANK	Mandatory
14	Merchant ID	String	0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	000100090015607	Mandatory
15	Retrieval Reference Number	String	0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	000000012843	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry, 1 – Swipe entry, 2 – Chip card entry. Any other value – card not validated. Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name, 1 – Print cardholder’s name. Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	NOBLE MOTORS	Mandatory
19	Merchant Address	String	0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	HAJI ALI	Mandatory
20	Merchant City	String	0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	MUMBAI	Mandatory
21	Plutus Version	String	0 – 40	Plutus version	v1.54 (for ICICI BANK)	Mandatory
22	Wallet Code	Integer	0 – 999	Wallet Code for which transaction was processed. For Jio Money value will be 101.	101	Mandatory
23	Reward Redeemed Points	Double	0 - 15	Redeemed Points	400.00	Mandatory
24	Reward Balance Amount	String	0 - 10	Balance Amount	1000000	Mandatory
25	Reward Balance Points	Double	0 - 15	Balance Point	40000.00	Mandatory
26	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \| (Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format (Optional)*	Mandatory
27	RFU1/Coupon code/Loyalty Card Number	String	0 – 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	5.50	Mandatory
28	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 – 99	Amount will always be in paisa or lowest currency.	100000	Mandatory
29	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	02012011	Mandatory
30	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	210403	Mandatory
31	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory
32	PineLabs Batch ID	Integer	6	Batch ID of Pine Labs EDC		Mandatory
33	PineLabs ROC	Integer	45080	ROC of Pine Labs EDC. Range: 101 - 999999	105	Mandatory

CASE 1: If billing application just triggers the transaction without Amazon Pay program ID

Request

HEX String Format	ASCII Format
100009970026353132392C54583132332C323130302C2C393435353136303734322C30312C2C2C2C2C2C2C2CFF	— &5129,TX123,2100,,9455160742,01,,,,,,,,ÿ

Response

There will be 2 cases

CASE 1: Sale charge request is initiated, and sale completion is pending

HEX String Format

ASCII Format

9999199700010154225458313233222C22222C225452414E53414354494F4E20494E4954494154454420434845434B20474554200D0A535441545553222C22222C22222C22222C22222C22313137222C2239303334222C223137303030303633222C2230222C225452414E53414354494F4E20494E4954494154454420434845434B20474554200D0A535441545553222C22416D617A6F6E506179222C2241333133485957514D5358364354222C22222C22222C2230222C224A616672695F53746F72655F4E65775F33222C224A616672695F53746F72655F4E65775F33222C224E4F49440D0A41222C2276312E302E30222C223137222C22222C22222C22222C22222C22222C22222C22313030222C22222C22222C223131323232303139222C22313235353035222C223137303030303633303030353038222C22313030222C2235313239222C22222C2220393033347C3131377C545831323322FF

™™— T"TX123","","TRANSACTION INITIATED CHECK GET STATUS","","","","","117","9034","17000063","0","TRANSACTION INITIATED CHECK GET STATUS","AmazonPay","A313HYWQMSX6CT","","","0","Jafri_Store_New_3","Jafri_Store_New_3","NOIDA","v1.0.0","17","","","","","","","100","","","11222019","125505","17000063000508","100","5129",""," 9034|117|TX123"ÿ

CASE 2: Sale charge is complete through callback URL in one step

HEX String Format

ASCII Format

999919970001010A225458313233222C22303030303838222C22415050524F564544222C22222C22222C22222C22222C22313038222C2239333733222C22222C2230222C22415050524F564544222C22416D617A6F6E506179222C224132584D4E4F51410D0A4E384D433634222C22363139383837362D32373230363139222C22222C2230222C2241716962200D0A53746F726532222C224E4352222C2244656C6869222C2276312E302E30222C223137222C22222C22222C22222C22222C22222C22222C2232313030222C22222C22222C223037303932303139222C22313235373235222C22313730303030303130303030382038222C22222C22222C22222C22393337337C3130387C54583132332220FF

™™— "TX123","000088","APPROVED","","","","","108","9373","","0","APPROVED","AmazonPay","A2XMNOQA N8MC64","6198876-2720619","","0","Aqib Store2","NCR","Delhi","v1.0.0","17","","","","","","","2100","","","07092019","125725","1700000100008 8","","","","9373|108|TX123" ÿ

JSON Request:

 
        
    Coming Soon

JSON Response:

 
        
    
    Coming Soon

GET STATUS OF Amazon Pay SALE CHARGE

CASE 1: If billing application just triggers the get status with only Transaction type and amount

HEX String Format	ASCII Format
10000997001B353132322C20545831323334353637382C3130302C2C2C2C2C2C2CFF	— 5122, TX12345678,100,,,,,,,ÿ

Note : In this case status of only Last transaction will be given by above CSV. No terminal input is required

CASE 2: If billing application provides batch ID and ROC along with amount and transaction type 5122,1245,100,,,,,,,,,9296,108,,,,,,,,,,,

HEX String Format	ASCII Format
100009970029353132322C313234352C3130302C2C2C2C2C2C2C2C2C393239362C3130382C2C2C2C2C2C2C2C2C2C2CFF	— )5122,1245,100,,,,,,,,,9296,108,,,,,,,,,,,ÿ

Note : In this case the transaction will proceed to get status and no terminal input is required

Response

HEX String Format

ASCII Format

999919970001010B225458313233222C22222C224455504C49434154452042494C4C222C22222C22222C22222C22222C22313038222C2239333733222C22222C2230222C224455504C4943415445200D0A42494C4C222C22416D617A6F6E506179222C224132584D4E4F51414E384D433634222C22333238333039352D33323039343533222C22222C2230222C2241716962200D0A53746F726532222C224E4352222C2244656C6869222C2276312E302E30222C223137222C22222C22222C22222C22222C22222C22222C223132313030222C22222C22222C223037303932303139222C22313235313035222C22313730303030303130303030203837222C22222C22222C22222C22393337337C3130347C22FF

™™— "TX123","","DUPLICATE BILL","","","","","108","9373","","0","DUPLICATE BILL","AmazonPay","A2XMNOQAN8MC64","3283095-3209453","","0","Aqib Store2","NCR","Delhi","v1.0.0","17","","","","","","","12100","","","07092019","125105","170000010000 87","","","","9373|104|"ÿ

JSON Request:

 
         
      Coming Soon

JSON Response:

 
         
      
      Coming Soon

Paper PoS

In Integration mode, Paper PoS charge slip can be launched directly from external billing/retail applications avoiding the need for multiple time selection of transaction charge slip printing. Also, the transaction response details are passed to the external application. Transaction charge slip completion can be used to automatically link the EFT payment transaction with the billing application transaction.

Sr. No.	Type of Transactions	lTxnType Value
1	Paper POS Print	5568
2	Paper POS RePrint	5569

Parameters Used in Paper Pos :
a) Txn Hat – Paper Pos Print/Reprint Transaction Hat
b) Billing Reference Number – Merchant Invoice number
c) Amount – Transaction Amount
d) Host Type – Unused
e) Entry Mode Data - PaperPos ID
f) Entry Mode - 5 (Last Y Mins Txns), 6 (Last N Txns).

CASE 1: If billing application just triggers the request without Paper PoS ID

Request

HEX String Format	ASCII Format
10000997001B353536382C54584E3132332C3130302C2C2C2C2C2CFF	— 5568,TXN123,100,,,,,,ÿ

JSON Request:

 
        
      Coming Soon

JSON Response:

 
        
      
      Coming Soon

Note: In this case, there will be a menu selection prompted on terminal with values: Last Y Minutes Txns/Last N Minutes txns . 2 cases will be present.

Case A: User selects Last Y minutes transaction. In this case, only required Transaction selection should be done under option.

Case B: User selects Last N Number transaction. In this case, only required Transaction selection should be done under option.

CASE 2: Paper PoS ID is present in csv string

Request

HEX String Format	ASCII Format
10000997001B353536382C54584E3132332C3130302C2C3732383538332C352C2C2CFF	— 5568,TXN123,100,,728583,5,,,ÿ

Response

There will be 3 cases:

CASE 1: Paper PoS Print charge slip with entry mode 5 response successful.

HEX String Format

ASCII Format

CASE 2: Paper PoS Print charge slip with entry mode 6 response successful.

HEX String Format

ASCII Format

99991997000101E22274786E303032222C22303030303034222C22415050524F564544222C22383630323537393732314079626C222C22222C22222C22555049222C22313134222C2239303735222C223431333033323031222C2230222C22415050524F56204544222C22222C2248444643303030303030313734333138222C22303035383232313033313636222C22222C2230222C2250524142484154222C2250696E656C616273222C224E4F494441222C2276312E302E30222C223139222C22222C2222202C22222C22222C22222C22222C22313030222C22222C22222C22303232373230323022FF

™™— txn002","000004","APPROVED","8602579721@ybl","","","UPI","114","9075","41303201","0","APPROV ED","","HDFC000000174318","005822103166","","0","PRABHAT","Pinelabs","NOIDA","v1.0.0","19","","" ,"","","","","100","","","02272020"ÿ

CASE 3: Paper PoS Print charge slip response when “TXN NOT FOUND”.

HEX String Format	ASCII Format
99991997000101BB74786E303032222C22222C2254584E204E4F5420464F554E44222C22222C22222C22222C22555049222C22313037222C2239303735222C22222C2230222C2254584E204E4F5420464F554E44222C22222C22222C22222C22222C2230222C2250524142484154222C2250696E656C616273222C224E4F494441222C2276312E302E30222C223139222C22222C22222C22222C22222C22222C22222C22313030222C22222C22222C22303232373230203230222C2231313532343222FF	™™— »txn002","","TXN NOT FOUND","","","","UPI","107","9075","","0","TXN NOT FOUND","","","","","0","PRABHAT","Pinelabs","NOIDA","v1.0.0","19","","","","","","","100","","","022720 20","115242"ÿ

JSON Request:

 
         
      Coming Soon

JSON Response:

 
         
      
      Coming Soon

PAPER POS	Entry Mode Id
PRINT/REPRINT[Last Y Minutes txns]	5
PRINT/REPRINT[Last N Number txns]	6

Twid

In integrated mode, Twid transactions can be launched directly from external billing/retail applications avoiding the need for dual amount input. Also, the transaction response details are passed to the external application. Transaction completion can be used to automatically link the EFT payment transaction with the billing transaction for reconciliation.

TRANSCATION TYPES

Sr. No.	Type of Transactions	lTxnType Value
1	Twid Sale	5131
2	Get Status	5122
2	Void	5121

Message Format


Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Transaction Type	Long Integer	4	Transaction request type to Plutus application. Please refer the Transaction Types Range: 4001-4216	5131	Mandatory
2	Billing reference number	String	0 – 25	Transaction reference number from external	“TX12345678”	Optional
3	Total EFT Amount	Long Integer	0 - 8	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa) Range: 1-99999999	999999	Mandatory
4	Bank Code	String	1 – 2	The bank code to which transaction will be routed	1	Optional
5	Track 1 data/Card PAN Number	String	1 – 76	Track1 data of the card or Card number if manual entry. If empty then Plutus will ask for card input.		Optional
6	Track 2 data / Expiry date	String	1 – 37	"Track2 data of the card or Expiry date if manual entry. If empty then Plutus will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual - 03"		Optional
7	Invoice Number	Long Integer	1 – 6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	12	Optional
8	Is Swipe entry	String	TRUE or FALSE	By default it is TRUE.	TRUE	Optional
9	Terminal ID	String	1-8	Reserved for future use		Optional
10	Operator	String	1-31	Reserved for future use		Optional
11	RFU2	String		Reserved for future use		Optional
12	EDC Batch ID	Integer	6	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.		Optional
13	EDC ROC	Integer	3	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc of parent transition. Range: 101-999	201	Optional
14	Transaction log ID	Long Integer	1 - 12	If independent transaction, then it is not required. Else in case of dependent transaction, it is the Transaction log of parent transition. Range: 1-184467440737	123234	Optional
15	Reward\Cash amount	Long Integer	1 – 8	Amount to be paid by reward points or in cash in paise (or in lowest currency) Range: 1 – 99999999	999999	Optional
16	Customer Mobile Number	String	1 – 100	Customer mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
17	Customer email id(s)	String	1 – 500	Customer email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
18	Merchant mobile number(s)	String	1 – 100	Merchant mobile number if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	9900000000\|8800000000	Optional
19	Merchant email id(s)	String	1 – 500	Merchant email Id if required to be captured. Can be used for sending SMS for charge slip. If there are more than one value pipe separated format can be used.	abc@xyz.com\|efg@xyz.com	Optional
20	Consent to send charge slip on customer mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her mobile number(s).	TRUE	Optional
21	Consent to send charge slip on customer email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant has taken consent from customer for sending charge slip on his/her email id(s).	TRUE	Optional
22	Consent to send charge slip on merchant mobile number(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her mobile number.	TRUE	Optional
23	Consent to send charge slip on merchant email id(s)	String	TRUE or FALSE	By default, this is FALSE. If this parameter is set as TRUE, it is assumed that the merchant gives consent for sending charge slip on his/her email id(s).	TRUE	Optional

Response Parameters
Position in CSV	Field Name	Data Type	Length	Description	Sample Value	Mandatory/ Optional
1	Billing Reference Number	String	0 - 25	Transaction reference number from external application.	TX12345678	Mandatory
2	Approval Code	String	1 - 6	Credit card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“5261AJ”	Mandatory
3	Host Response	String	0 - 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”	Mandatory
4	Card Number	String	0 - 19	Card number is valid if card was swiped. Otherwise, empty string.	“************2802”	Mandatory
5	Expiration Date	String	0 or 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked, in that case a value of “XXXX” will be returned.	“XXXX”	Mandatory
6	Cardholder’s Name	String	0 - 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present on Track 1. Otherwise, empty string.	“AMIT MOHAN”	Mandatory
7	Card Type	String	0 - 12	Card association name, if valid card was swiped. Otherwise, empty string.	“VISA”	Mandatory
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 6	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip). Range 0 - 999999 / 101 - 999 (in case of Reward Transaction)	78/101	Mandatory
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction).		Mandatory
10	Terminal ID	String	0 or 8	EFT TID, if transaction authorized. Otherwise, empty string.	“30000001”	Mandatory
11	Loyalty Points Awarded	Long	0 - 8	RFU – not used. Range: 0 – 99999999	0	Mandatory
12	Remark	String	0 - 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization.	“Failed to dial modem”	Mandatory
13	Transaction Acquirer Name	String	0 - 48	Name of acquirer to which transaction was routed.	“ICICI BANK”	Mandatory
14	Merchant ID	String	0 - 15	EFT ME ID, if transaction authorized. Otherwise, empty string.	“000100090015607”	Mandatory
15	Retrieval Reference Number	String	0 - 12	EFT RRN, if transaction authorized. Otherwise, empty string.	“000000012843”	Mandatory
16	Card Entry Mode	Integer	0 - 5	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated Range: 0 – 32767	1	Mandatory
17	Print Cardholder's Name on receipt	Integer	0 - 5	Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip. Range: 0 – 32767	0	Mandatory
18	Merchant Name	String	0 - 23	Merchant name, if transaction authorized. Otherwise, empty string.	“NOBLE MOTORS”	Mandatory
19	Merchant Address	String	0 - 23	Merchant address line, if transaction authorized. Otherwise, empty string.	“HAJI ALI”	Mandatory
20	Merchant City	String	0 - 23	Merchant city line, if transaction authorized. Otherwise, empty string.	“MUMBAI”	Mandatory
21	Plutus Version	String	0 - 40	Plutus version.	“v1.54 (for ICICI BANK)”	Mandatory
22	Acquiring Bank Code	Integer	0 - 999	Code for bank used for processing transaction. Enumeration of possible values: 01 – HDFC BANK, 02 – ICICI BANK, 03 – AMERICAN EXPRESS, 04 – CITIBANK, 05 – AXIS BANK, 06 – SBI, 07 – HSBC, 09 – CORP BANK, 10 – CUB (City Union Bank), 14 – IDBI Bank, 17 – LVB (Lakshmi Vilas Bank), 51 - PINE 360, 301 - Sodexo, 81 – Loyalty Reward, 82 – Aimia, 85 – SBI Rewards		Mandatory
23	Reward Redeemed Amount	Long Integer	0 - 10	Redeemed Amount in Paisa or in lowest currency.	“10000”	Optional
24	Reward Redeemed Points	Double	0 - 15	Redeemed Points.	“400.00”	Optional
25	Reward Balance Amount	String	0 - 10	Balance Amount.	“1000000”	Optional
26	Reward Balance Points	Double	0 - 15	Balance Point.	“40000.00”	Optional
27	Charge slip print data in tag value format (Optional)*	String		Charge slip data in form of tag and value separated with : and new pair separated with \|*(Only present if charge slip data on merchant is enabled)	Charge slip print data in tag value format(Optional)*	Mandatory
28	RFU1/Coupon code/Loyalty Card Number	String	0 - 23	Card Processing Fee in Rs (decimal) Or Coupon Code. Coupon code is the value which will be coming as a response to voucher redemption. This field will be present in case of voucher redemption. Or Loyalty number fetched if the transaction type is 4301.	“5.50”	Mandatory
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	0 - 99	Amount will always be in paisa or lowest currency.	“100000”	Mandatory
30	RFU3	String	0 - 23	Reserved for future use		Mandatory
31	RFU	String		Specific for merchant	Alhanumeric	Optional
32	Date of Transaction	String	0 - 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format.	“02012011”	Mandatory
33	Time of Transaction	String	0 - 6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24-hour format.	“210403”	Mandatory
34	PineLabs Client ID	Integer	0 - 6	Unique ID assigned to Pine Labs EDC.	12345	Mandatory

Twid Sale

CASE 1: Twid sale request (Transaction done on call back URL).

Request

HEX String Format	ASCII Format
100009970025353133312C54583132332C3130302C2C383835333934313635392C30312C2C2C2C2C2C2C2CFF	%5131,TX123,100,,8853941659,01,,,,,,,,ÿ

Response

HEX String Format

ASCII Format

999919970001010E225458313233222C22303030313234222C22415050524F564544222C22222C22222C22222C22222C22313032222C2239313136222C22323130303030303136222C2230222C22415050524F564544222C2274776964222C223134373930222C0D0A223336393136222C22222C2230222C2248617270726565742073746F7265222C2274747474747438376975796F222C2253524944554E47415247415248222C2276312E302E30222C223231222C22222C22222C22222C22222C22222C22222C22313030222C22222C22222C223037303732303230222C22313932353531220D0A2C22323130303030303136303030313234222C22222C22222C22222C22393131367C3130327C54583132332220FF

"TX123","000124","APPROVED","","","","","102","9116","210000016","0","APPROVED","twid","14790", "36916","","0","Harpreet store","tttttt87iuyo","SRIDUNGARGARH","v1.0.0","21","","","","","","","100","","","07072020","192551" ,"210000016000124","","","","9116|102|TX123" ÿ

JSON Request:

 
        
    Coming Soon

JSON Response:

 
        
    
    Coming Soon

CASE 2: Twid sale request(if the payment successful on app and time out occurs on EDC machine).

Request

HEX String Format	ASCII Format
100009970025353133312C54583132332C3130302C2C383835333934313635392C30312C2C2C2C2C2C2C2CFF	%5131,TX123,100,,8853941659,01,,,,,,,,ÿ

Response

HEX String Format

ASCII Format

9999199700010140225458313233222C22222C225452414E53414354494F4E20494E4954494154454420434845434B20474554200D0A535441545553222C22222C22222C22222C22222C22313035222C2239313136222C22323130303030303136222C2230222C225452414E53414354494F4E20494E4954494154454420434845434B2047455420535441545553222C2274776964222C223134373930222C22222C22222C2230222C224861727072656574200D0A73746F7265222C2274747474747438376975796F222C2253524944554E47415247415248222C2276312E302E30222C223231222C22222C22222C22222C22222C22222C22222C22313030222C22222C22222C223037303732303230222C2232303336333022202C22323130303030303136303030313237222C22222C22222C22222C22393131367C3130357C54583132332220FF

@"TX123","","TRANSACTION INITIATED CHECK GET STATUS","","","","","105","9116","210000016","0","TRANSACTION INITIATED CHECK GET STATUS","twid","14790","","","0","Harpreet store","tttttt87iuyo","SRIDUNGARGARH","v1.0.0","21","","","","","","","100","","","07072020","203630" ,"210000016000127","","","","9116|105|TX123" ÿ

JSON Request:

 
        
     Coming Soon

JSON Response:

 
        
     
     Coming Soon

Twid Getstatus:

Request

HEX String Format	ASCII Format
100009970029353132322C313234352C3130302C2C2C2C2C2C2C2C2C393032332C3131392C2C2C2C2C2C2C2C2C2C2CFF	)5122,1245,100,,,,,,,,,9023,119,,,,,,,,,,,ÿ

Response

HEX String Format

ASCII Format

999919970001010C2231323435222C22303030313238222C22415050524F564544222C22222C22222C22222C22222C22313134222C2239313136222C22323130303030303136222C2230222C22415050524F564544222C2274776964222C223134373930222C220D0A3336393139222C22222C2230222C2248617270726565742073746F7265222C2274747474747438376975796F222C2253524944554E47415247415248222C2276312E302E30222C223231222C22222C22222C22222C22222C22222C22222C22313030222C22222C22222C223037303732303230222C2232313030313422202C22323130303030303136303030313238222C22222C22222C22222C22393131367C3131337C54583132332220FF

"1245","000128","APPROVED","","","","","114","9116","210000016","0","APPROVED","twid","14790"," 36919","","0","Harpreet store","tttttt87iuyo","SRIDUNGARGARH","v1.0.0","21","","","","","","","100","","","07072020","210014" ,"210000016000128","","","","9116|113|TX123" ÿ

JSON Request:

 
     
    Coming Soon

JSON Response:

 
     
    
    Coming Soon

CASE 3:Twid Void request

Request

HEX String Format	ASCII Format
10000997002A353132312C54583132332C3130302C2C2C2C2C2C2C2C2C393130382C3130362C2C2C2C2C2C2C2C2C2C2CFF	*5121,TX123,100,,,,,,,,,9108,106,,,,,,,,,,,ÿ

Response

HEX String Format

ASCII Format

999919970001010D225458313233222C22303030313239222C22415050524F564544222C22222C22222C22222C22222C22313135222C2239313136222C22323130303030303136222C2230222C22415050524F564544222C2274776964222C223134373930222C0D0A223336393139222C22222C2230222C2248617270726565742073746F7265222C2274747474747438376975796F222C2253524944554E47415247415248222C2276312E302E30222C223231222C22222C22222C22222C22222C22222C22222C22313030222C22222C22222C223037303732303230222C22323130323531220D0A2C22323130303030303136303030313239222C22222C22222C22222C22393131367C3131347C545831323322FF

"TX123","000129","APPROVED","","","","","115","9116","210000016","0","APPROVED","twid","14790", "36919","","0","Harpreet store","tttttt87iuyo","SRIDUNGARGARH","v1.0.0","21","","","","","","","100","","","07072020","210251" ,"210000016000129","","","","9116|114|TX123"ÿ

JSON Request:

 
    
    Coming Soon

JSON Response:

 
    
    
    Coming Soon

Insurance and CCF

CCF

As part of our ICB & ISV offering to make the purchase more affordable, customer benefits from cashback and subvented offers. To sustain this benefit, a charge called as Instant Discount Charge is being charged to the customer who avails this benefit. This fee would be added as part of the purchase transaction.

Insurance

For the products sold on Brand EMI @Pineabs POS machine, merchants can use the existing Brand EMI flow to offer different Protection plans to customers. Plan purchased will be converted to same EMI tenure selected for product purchased. This program is launched in partnership with leading insurance/service provider across India.

Response Parameters
Position in CSV	Field Name	Data Type	Range/ Length	Description	Sample Value
50	Insurer Name	String	15	Name of the Insurer	Acko
51	Insurer Type	String	15	Plan selected of the insurer	Acko_EW
52	Insurer Tenure	String	10	Tensure of the Insurance	3 Months
53	Insurance Amount	Double (Upto 2 decimal Points)		Insurance Amount	500
54	CCF Amount	Double (Upto 2 decimal Points)		Customer Convenience Fee amount	143.67
55	GST on CCF	Double (Upto 2 decimal Points)		GST on CCF	25.86
56	Total CCF Amount (with GST)	Double (Upto 2 decimal Points)		Total Customer Convenience fee amount	169.53

Sample Request String

Brand EMI

HEX String Format	ASCII Format
	5002,invoice123,900000,,,,,,,,,,,45347845\|244\|\|\|\|\|\|brandEmi123\|9999999999,,,,ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

When brand emi with insurance and without CCF

HEX String Format

ASCII Format

"invoice123","00","APPROVED","************5742","XXXX","500766 VISA DEBITCARD /","VISA",28,13,"36381430",0,"PROCESSED","ICICI BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT ICICI BANK",02,"","","","","","106|3|ICICI Debit|810009|274515|90000|5514|66246|244|SAMSUNG MONITOR|45347845|LCD|brandEmi123|9999999999","","","","02022024","112528","","","","","","","","","","","","","","","","","Acko","EW_Acko","1 Months",0.09,0.00,0.00,0.00ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Brand EMI without Insurance and CCF

HEX String Format

ASCII Format

"invoice123","00","APPROVED","************5742","XXXX","500766 VISA DEBITCARD /","VISA",30,13,"36381430",0,"PROCESSED","ICICI BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT ICICI BANK",02,"","","","","","106|3|ICICI Debit|810000|274512|90000|5514|66246|244|SAMSUNG MONITOR|45347845|LCD|brandEmi123|9999999999","","","","02022024","121525","","","","","","","","","","","","","","","","","","","",0.00,0.00,0.00,0.00ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Brand EMI without Insurance and with CCF

HEX String Format

ASCII Format

"invoice123","00","APPROVED","************5742","XXXX","500766 VISA DEBITCARD /","VISA",30,13,"36381430",0,"PROCESSED","ICICI BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL", "Plutus v2.12 MT ICICI BANK",02,"","","","","","106|3|ICICI Debit|810000|274512|90000|5514|66246|244|SAMSUNG MONITOR|45347845|LCD|brandEmi123|9999999999","","","","02022024","121525","","","","","","","","","","","","","","","","","","","",0.00,143.67,25.86,169.53ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Brand EMI with Insurance and CCF

HEX String Format

ASCII Format

"invoice123","00","APPROVED","************5742","XXXX","500766 VISA DEBITCARD /","VISA",30,13,"36381430",0,"PROCESSED","ICICI BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ", "Plutus v2.12 MT ICICI BANK",02,"","","","","","106|3|ICICI Debit|810000|274512|90000|5514|66246|244|SAMSUNG MONITOR|45347845|LCD|brandEmi123|9999999999","","","","02022024","121525","","","","","","","","","","","","","","","","","Acko","EW_Acko","1 Months",0.09,143.67,25.86,169.53ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Bank EMI Txn

Flag=3

Sample Request String

Request

HEX String Format	ASCII Format
	— 5101,CsvBankEmi,900000,,,,,,,,,,,0\|0\|\|\|\|3\|\|\|,,,,ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Sample Response String

HEX String Format

ASCII Format

™™— "CsvBankEmi","00","APPROVED","************5742","XXXX","500766 VISA DEBITCARD /","VISA",29,13,"36381430",0,"PROCESSED","ICICI BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT ICICI BANK",02,"","","","","","105|3|ICICI Debit|870000|294846|30000","","","","02022024","114503","","","","","","","","","","","","","","","","","","","",0.00,0.00,0.00,0.00ÿ

Sale Txn

Flag=3

Sample Request String

Request

HEX String Format	ASCII Format
	— 4001,TX12345678,900000,,,,,,,ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Sample Response String

HEX String Format	ASCII Format
	™™— "TX12345678","00","APPROVED","************5742","XXXX","500766 VISA DEBITCARD /","VISA",30,20,"36381420",0,"PROCESSED","ICICI BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANAKPURI","NEW DELHI DEL ","Plutus v2.12 MT ICICI BANK",02,"","","","","","","","","","02022024","115423","","","","","","","","","","","","","","","","","","","",0.00,0.00,0.00,0.00ÿ

ZOMATO PAY

Zomato, a leading Food delivery company in India wants to integrate with PineLabs for their Restaurant Dining Payment experience. Objective of this integration is to solve the transaction reconciliation once the transaction is completed on Zomato app.

Request CSV Structure
Position in CSV	Field Name	Data Type	Range/ Length	Description	Sample Value
1	lTxnType	Long Integer	4001-4216	Transaction request type to Plutus application. for Zomato Pay it is 5137.	1
2	Billing Reference Number	String	Length: 0 – 25	OPTIONAL Transaction reference number from external application. Plutus will only use this value for printing on charge slip.	2
3	Bill Amount	Long Integer	Length: 1 - 99999999	Bill Amount	3
33	Auth Code	Integer	Length: 4	OPTIONAL Auth Code for Zomato Transaction.	33

Sample Request/Response String

Request CSV

HEX String Format	ASCII Format
	— 5137,TX0000001,201450ÿ

Response CSV

HEX String Format	ASCII Format
	™™— "TX0000001","543445","APPROVED","2986543445","","","161160","102","9088","10002010","0","APPROVED","40290","A3W17FVIWXD25S","6291","","0", "Utkarsh Merchant 1 Store 1","Indirapuram","GHAZIABAD","v1.0.0","31","","","","","","","201450","","","02022024","235739","10111120432540","","","","9088\|102\|TX0000001"ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Request CSV with field 33

Request

HEX String Format	ASCII Format
	— 5137,TX0000003,201450,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,6291ÿ

Response CSV

HEX String Format	ASCII Format
	™™— "TX0000003","543445","APPROVED","2986543445","","","161160","104","9088","10002010","0","APPROVED","40290","A3W17FVIWXD25S","6291","","0", "Utkarsh Merchant 1 Store 1","Indirapuram","GHAZIABAD","v1.0.0","31","","","","","","","201450","","","02032024","000852","10111120432542","","","","9088\|104\|TX0000003"ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Response CSV Structure

Following fields are specific for Zomato:

1. Auth Code in Request (field 33)

2. Zomato Txn ID (field 4)

3. Bill Amount (Total Invoice Amount) (field 29)

4. Discount Amount (field 13)

5. Amount Received (Field 7)

Request CSV Structure
Position in CSV	Field Name	Data Type	Range/ Length	Description	Sample Value
1	Approval Code	String	Length: 0 – 25	OPTIONAL Transaction reference number from external application.	“TX0000003”
2	Billing Reference Number	String	Length: 0 – 6	Last Six Digits of Zomato Transaction ID. Empty Value means Transaction has failed.	“543445”
3	Host Response	String	Length: 0 – 50	Response string received from Zomato.	“APPROVED”
4	Zomato Transaction ID	String	Length: 0 – 19	Zomato Transaction ID. missing value means Transaction has failed.	"2986543445"
5	Empty	Empty	Empty	Empty	“”
6	Empty	Empty	Empty	Empty	“”
7	Amount Received	Long Integer	0 - 19	Amount Received	"161160"
8	Invoice Number	Integer	Length: 10	Invoice Number	"102"
9	Batch Number	Integer	Length:10	Batch Number	"9088"
10	Terminal ID	String	0 - 10	Terminal ID	"10002010"
11	Zero	Zero	Zero	Zero	"0"
12	Response Code	String	Length: 0 – 50	Response Code	“APPROVED”
13	Discount Amount	Long Integer	Length: 0 – 19	Discount Amount	“40290”
14	Merchant ID	String	Length: 0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	“000100090015607”
15	Auth Code	Integer	4	Auth Code	"6291"
16	Empty	Empty	Empty	Empty	""
17	Zero	Zero	Zero	Zero	"0"
18	Merchant Name	String	Length: 0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	“LOVE COMMUNICATION"
19	Merchant Address	String	Length: 0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	“JANA PURI”
20	Merchant City	String	Length: 0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	“NEW DELHI DEL”
21	Plutus Version	String	Length: 0 – 40	Plutus version	“Plutus v1.49.3 MT HDFC BANK”
22	Acquirer Code	Integer	0 – 2	Acquirer Code - Zomato Pay 31	"31"
23	Empty	Empty	Empty	Empty	""
24	Empty	Empty	Empty	Empty	""
25	Empty	Long Integer	Empty	Empty	""
26	Empty	Empty	Empty	Empty	""
27	Empty	Empty	Empty	Empty	""
28	Empty	Empty	Empty	Empty	""
29	Bill Amount	Long Integer	Length: 0 –19	Bill Amount	“201450"
30	Empty	Empty	Empty	Empty	""
31	Empty	Empty	Empty	Empty	""
32	Transaction Date	Date	Length: 0/8	Transaction Date MMDDYYYY	"02022024"
33	Transaction Time	Time	Length: 0/ 8	Transaction Time HHMMSS	“235739”
34	Plutus Transaction Id	Long Integer	Length 0-19	Transaction Id Generated by PL	"10111120432540"
35	Empty	Empty	Empty	Empty	""
36	Empty	Empty	Empty	Empty	""
37	Empty	Empty	Empty	Empty	""
38	Batch_ID \|Invoice_ID \| bill_number	String	Length 0-40	Batch_ID\|Invoice_ID\|bill_number	"9088\|102\|TX0000001"

Flipkart Supercoin Partial Sale

Flipkart Supercoins wants to leverage our POS network to allow Flipkart Supercoins points redemption and earn to its customers while transacting on Pine Labs POS of a partner merchant.

Request CSV Structure
Position in CSV	Field Name	Data Type	Range/ Length	Description
1	lTxnType	Long Integer	4001-4216	Transaction request type to Plutus application. Please refer to the table above
2	Billing Reference Number	String	Length: 0 – 25	OPTIONAL Transaction reference number from external application. Plutus will only use this value for printing on charge slip.
3	Total EFT Amount	Long Integer	Length: 1 - 99999999	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa)
4	Bank Code	String	Length: 1-2	OPTIONAL The bank code to which transaction will be routed. Optional in case of sale transaction if Automatic Acquirer Selection is chosen
5	Track 1 data / Card Pan Number/Barcode/ Mobile Number	String	Length: 1 – 76	OPTIONAL Track1 data of the card or Card Number/Barcode number if manual entry. If empty e/Mobile, then PADController will ask for card number input. For Pine 360, this field can accommodate mobile number or barcode of Gift voucher.

Sample Request String

Request CSV

HEX String Format	ASCII Format
	— 4123,66668889,10000,,,,,,,8826897840,,,ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Response CSV Structure
Position in CSV	Field Name	Data Type	Range/ Length	Description	Sample Value
1	Billing reference number	String	Length: 0 – 25	OPTIONAL Transaction reference number from external application.	“66668889”
2	Approval Code	String	Length: 0 – 6	Credit Card authorization code, if transaction was approved. Otherwise empty string. Presence of non-zero length approval code string indicates successful authorization of transaction. This logic holds true for Pine 360 transactions as well.	“00”
3	Host Response	String	Length: 0 – 50	Response string if a response for transaction was received from bank switch. Otherwise, if any error occurs before response is received, this is an empty string.	“APPROVED”
4	Card Number	String	Length: 0 – 19	Card number is valid if card was swiped. Otherwise, empty string.	"************7665"
5	Expiration Date	String	Length: 0, 4	Card expiration date, expressed in format YYMM, if valid card was swiped. Otherwise, empty string. Some acquirers mandate Expiry date to be masked.	“XXXX”
6	Cardholder’s Name	String	Length: 0 – 25	Cardholder’s name from card track 1, if valid card was swiped and card holder name present. Otherwise, empty string.	“TEST1007 /”
7	Card Type	String	Length: 0 – 12	Card association name, if valid card was swiped. Otherwise, empty string	“MAESTRO”
8	Invoice Number/EDC ROC (in case of Reward Transaction)	Long Integer	0 - 999999/101– 999 (in case of Reward Transactions)	EFT transaction invoice number, if transaction authorized. Otherwise, 0/EDC ROC (the same is printed on charge slip)	42
9	Batch Number/EDC Batch ID (in case of Reward Transaction)	Integer	Length: 6	EFT transaction batch number, if transaction authorized Otherwise, 0/EDC Batch ID (in case of Reward transaction)	12
10	Terminal ID	String	Length: 0, 8	EFT TID, if transaction authorized. Otherwise, empty string	“69767976”
11	Loyalty Points Awarded	Long Integer.	0 - 99999999	RFU – not used	0.
12	Remark	String	Length: 0 – 100	Description of error, if an error occurs. Otherwise, empty string. An empty string in this field DOES NOT imply successful transaction authorization	“PROCESSED”
13	Transaction Acquirer Name	String	Length: 0 – 48	Name of acquirer to which transaction was routed	“HDFC BANK”
14	Merchant ID	String	Length: 0 – 15	EFT ME ID, if transaction authorized. Otherwise, empty string	“000100090015607”
15	Retrieval Reference Number	String	Length: 0 – 12	EFT RRN, if transaction authorized. Otherwise, empty string	“000000000020”
16	Card Entry Mode	Integer	0 – 32767	Enumeration of possible values: 0 – Manual entry 1 – Swipe entry 2 – Chip card entry Any other value – card not validated	2
17	Print Cardholder’s Name on receipt	Integer	0 – 32767	Use this value only if Billing application is printing the charge slip. Enumeration of possible values: 0 – Do not print cardholder’s name 1 – Print cardholder’s name Any other value – card not validated. This is used if external application is to print Plutus charge slip.	1
18	Merchant Name	String	Length: 0 – 23	Merchant name, if transaction authorized. Otherwise, empty string	“LOVE COMMUNICATION"
19	Merchant Address	String	Length: 0 – 23	Merchant address line, if transaction authorized. Otherwise, empty string	“JANA PURI”
20	Merchant City	String	Length: 0 – 23	Merchant city line, if transaction authorized. Otherwise, empty string	“NEW DELHI DEL”
21	Plutus Version	String	Length: 0 – 40	Plutus version	“Plutus v1.49.3 MT HDFC BANK”
22	Bank Code /UPI/Bharat QR	Integer	0 – 999	Bank Code /UPI/Bharat QR for which transaction was processed.	1
23	Redeemed Amount	Long Integer	Length 0-10	Redeemed Amount	2500
24	Redeemed Point	Double	Length 0-15	Redeemed Point	25
25	Balance Amount	Long Integer	Length: 0 –10	Balance Amount	0
26	Balance Points	Double	Length: 0 –15	Balance Points	0
27	Charge slip print data in tag value format (Optional)*	String	0 – 32767	Not Applicable	“Not Applicable"
28	RFU1/Coupon code/Loyalty Card Number	String	Length: 0 –23	Not Applicable	“Not Applicable"
29	Amount processed successfully by Plutus/ Amount Loaded on cards or wallets/amount voided/Amount loaded on cards/wallets	String	Length: 0 –99	Amount will always be in paisa or lowest currency.	“10000”
30	RFU3	String	Length: 0 –23	Reserved for future use	Reserved for future use
31	RFU4	String	Length: 0 –40	Not Applicable	Not Applicable
32	Date of Transaction	String	Length: 0/ 8	Date of the Transaction as per acquiring host. Date to be printed on charge slip. In MMDDYYYY Format	“11212023”
33	Time of Transaction	String	Length: 0 /6	Time of the Transaction as per acquiring host. Time to be printed on charge slip. HHMMSS where HH in 24 hour format.	“124509”
34	Plutus Transaction Id	Long Integer	Length 0-19	Transaction Id Generated by PL	4295209144
35	Other Amount	String	Length 0-40	Other Amount	7500
36	Transaction Type	String	Length 0-40	Transaction Type	4123
37	Card Entry Type	String	Length 0-40	Card Entry Type	CARD_CHIP
38	OrigBillDetails	String	Length 0-100	EDCBatchId + "\|" + OrigEDCRoc + "\|" + OrigBillingRefNumber	"9001\|101\|66668889”
39	RFU	String	Length 0-40	Not Applicable	Not Applicable
40	Wallet/Reward Transaction ID	String	Length 0-40	Wallet/Reward Transaction ID	123455

Sample CSV Responses:

Card:

Redeem:

Reponse CSV:

HEX String Format	ASCII Format
	"66668889","00","APPROVED","************7665","XXXX","TEST1007 /","MAESTRO",42,12,"69767976",0,"PROCESSED","HDFC BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANA PURI","NEW DELHI DEL ","Plutus v1.49.3 MT HDFC BANK",01,"2500","25","0","0","","",10000,"","","11212023","124509","4295209144","7500","4123","CARD_CHIP","","","123455"ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Earn:

Reponse CSV:

HEX String Format	ASCII Format
	"66668889","00","APPROVED","************7665","XXXX","TEST1007 /","MAESTRO",43,12,"69767976",0,"PROCESSED","HDFC BANK"," ","000000000020",2,1,"LOVE COMMUNICATION","JANA PURI","NEW DELHI DEL ","Plutus v1.49.3 MT HDFC BANK",01,"0","0","0","0","","",10000,"","","11212023","131401","4295209146","10000","4123","CARD_CHIP","","","123455"ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

UPI:

Redeem

HEX String Format	ASCII Format
	"66668889","004879","APPROVED","69947878527@paytm","","","UPI","126","9278","5651","0","APPROVED", "ICICI UPI","12345678","124107501581","","0","paxstore Testing","sec 04","ARAGA","v1.0.0","4","700","7","0","0","", "",7000,"","","11222023","144829","85082021004879","","4123","","9278\|126\|66668889","","123455"ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Earn:

HEX String Format	ASCII Format
	"66668889","004880","APPROVED","69947878527@paytm","","","UPI","127","9278","5651","0","APPROVED","ICICI UPI","12345678","124107501581","","0", "paxstore Testing","sec 04","ARAGA","v1.0.0","4","0","0","0","0","","",7000,"","","11222023","145120","85082021004880","","4123","","9278\|127\|66668889","","123455"ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Cash:

Redeem:

HEX String Format	ASCII Format
	"66668889","123455","APPROVED"," ********"," ","","","128","9278","0","","APPROVED","FLIPKART SUPERCOINS","11276","","", "0","paxstore Testing","sec 04","ARAGA","v1.0.0","112","700","7","0","0","","",7000,"","","11222023","145420","","","4123","","","","123455"ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

Earn:

HEX String Format	ASCII Format
	"66668889","123455","APPROVED"," ********"," ","","","129","9278","0","","APPROVED","FLIPKART SUPERCOINS","11276","","","0", "paxstore Testing","sec 04","ARAGA","v1.0.0","112","0","0","0","0","","",7000,"","","11222023","145648","","","4123","","","","123455"ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

PAY BY LINK

We can check the Pay By Link Transaction status in Integration Mode as well. "5033" is the new txn type for Pay By Link Get Status.

Below are Pay By Link Get Status Request/Response details-

Following is the format of the request CSV. The external application will set these values.

REQUEST STRING
Position in CSV	Field Name	Data Type	Range/ Length	Description	Sample Value
1	lTxnType	Long Integer	4001-4216	Transaction request type to Plutus application. Please refer to the table above	5033
2	Billing Reference Number	String	Length: 1 – 10	OPTIONAL Transaction reference number from external application. Plutus will only use this value for printing on charge slip.	“TX12345678”
3	Total EFT Amount	Long Integer	Length: 1 - 99999999	Amount to be charged to card – expressed as a whole number in lowest currency unit (ie. in paisa)	999999
4	Bank Code	String	Length: 1 – 2	OPTIONAL The bank code to which transaction will be routed. Optional in case of sale transaction if Automatic Ac.quirer Selection is chosen	01
5	Track 1 data / Card Pan Number/Barcode/ Mobile Number	String	Length: 1 – 76	OPTIONAL Track1 data of the card or Card Number/Barcode number if manual entry. If empty e/Mobile,then PADController will ask for card number input. For Pine 360, this field can accommodate mobile number or barcode of Gift voucher.
6	Track 2 data / Expiry date/ Card Mode	String	Length: 1 – 37	OPTIONAL Track2 data of the card or Expiry date if manual entry. If empty, then PADController will ask for card input. Expiry date is in YYMM format. In case of Pine 360, if Track 1 consists of mobile or GV number, this field will indicate the card entry mode. Mobile Number – 01 Barcode – 02 Manual Entry - 03
7	Invoice number	Long Integer	Length: 1 – 6	OPTIONAL If independent transaction, then it is not required. Else in case of dependent transaction, it is the Invoice number of parent transition.	000012
8	Is Swipe entry	String	TRUE/FALSE	OPTIONAL By default, it is TRUE	TRUE
9	Terminal ID	String	Length: 1 – 8	OPTIONAL Reserved for future use
10	Operator	String	Length:1-31	OPTIONAL
11	RFU2	String		OPTIONAL Reserved for future use
12	EDC Batch ID	Integer	Length: 6	OPTIONAL If independent transaction, then it is not required. Else in case of dependent transaction, it is the Batch Id of parent transition.
13	EDC ROC	Integer	101-999	OPTIONAL If independent transaction, then it is not required. Else in case of dependent transaction, it is the Roc Id of parent transition.	201
14	Pay By Link Reference Id	Long Integer	1- 18446744073 7	Pay By Link reference ID required to identify PBL transaction.	123234

Sample Request String

HEX String Format	ASCII Format
	5033, , 650000,,,,,,,,,,,2374ÿ

JSON Request:

 
                    
                    Coming Soon

JSON Response:

 
                    
                    
                    Coming Soon

RESPONSE STRING

Sample Response string

HEX String Format	ASCII Format
	"2374","00","APPROVED","******6517","PAY BY LINK TXN","104","9040","350368"ÿ

JSON Request:

 
                      
                      Coming Soon

JSON Response:

 
                
                
                Coming Soon

REQUEST STRING
Position in CSV	Field Name	Data Type	Range/ Length	Description	Sample Value
1	Pay By Link Reference Id	Numeric	Length: 0 – 15	Pay By Link reference ID	“2374”
2	Response Code	Numeric	Length: 0 – 2	Response code, if transaction was approved.	00 -success Other than 00 - Failure
3	Pay By Link Status	String	Length: 0 – 20	Response string if a response for transaction was received from host. Otherwise, if any error occurs before response is received, this is an empty string.	“INITIATED, APPROVED, SETTLED, VOIDED, REVERSED, CANCELLED”
4	Customer last Four Digit Mobile Number/Card No	String	Length: 0 – 19	Card number/Mobile number is valid if no.card/mobile was swiped. Otherwise, empty string.	“438624***** 2802" / *****6517
5	Txn Type	String	Length: 0 –12	Value is always same.	“PAY BY LINK TXN”
6	EDC ROC	Integer	0-999	EDC ROC (the same is printed on chargeslip)	“101” ”299”
7	Batch Number/EDC Batch ID	Integer	Length: 6	EFT transaction batch number, if transaction authorized. Otherwise, 0/EDC Batch ID (in case of Reward transaction)	“9040”
8	PineLabs Client ID	Integer	Length 0 - 8	Unique ID assigned to Pine Labs EDC.	12345

Appendix

Below are the details of Error code, Transaction type, and Function codes supported by the Payment Application. This section also covers the sub tag values received in specific special fields (27 & 31) in transaction response.

Error Code & Messages

Error Code	Error Message
-1000	Response Timeout
-1001	Network Error
-1002	Invalid Message Format
-1003	Unable to send
-1004	Terminal Busy
-1005	Comms Error
-1006	Destination Error
-1007	Power Failure
-1008	IP not configured
-1009	Port not configured
-1010	Invalid IP
-1011	Invalid Port
-1012	Connection lost

Transaction Types

Below is the list of Transaction types supported by Payment Application on Android device.

Type of Transaction	Function Code
Sale Transaction	4001
Refund Transaction	4002
Tip Adjust Transaction	4015
Adjust Transaction	4005
Void Transaction	4006
Pre Auth Transaction	4007
Sale Complete Transaction	4008
Reward Redemption	4101
Reward Void	4102
Reprint	4504
Settlement	6001
WalletPay	5102
WalletLoad	5103
WalletVoid	5104
Sodexo Sale	5106
Sodexo Void	5107
Brand EMI Transaction	5002
Bank EMI Transaction	5101
EMI as Single Txn Type for Brand & Bank EMI	5005
Sale With/Without Instant Discount	4603
QC Redemption	4205
HDFC Flexipay - POS (Pay Later)	5030
Zest Money - Invoice Sale	5367
Zest Money – Product Sale	5370
Zest Money – Void	5369
UPI Sale Request	5120
Bharat QR Sale request	5123
Paytm Sale	5125
Airtel Sale	5127
Google Pay Sale	5126
PayPal Sale	5554
Amazon Pay Request	5129
Paper POS Print	5568
Twid Sale	5131

Function Codes

Payment application processes the transactions based on the function codes listed below.

Function	Code	Comment
Do Transaction	0x0997	All the financial transactions shall set this function code in request
Set Connection	0x0998	Not required for direct connection over COM/Serial
Run PVM	0x0999
Main Node	0x0996
Response Do Transaction	0x1997	Payment application will send this function code in financial transaction response

Charge Slip Print data in tag Value Format

Below is the list of Tags and description of values received in transaction response CSV position 27.

Tag	Description
10001	Bank Name
10050	Address line 1
10051	Address line 2
10100	DATE
10101	TIME
10150	MID
10151	TID
10200	BATCH NUM
10201	INV. NUM
10250	Transaction type
10300	Card number masked
10301	Card entry mode
10350	EXP DATE
10351	CARD TYPE
10400	TXN ID
10401	APPR CODE
10450	RRN
10451	BASE AMT.
10500	TIP AMT.
10501	CASH AMT.
10600	TOTAL AMT.
10601	RDM POINTS
10650	RDM AMOUNT
10651	SIGN
10700	Customer name
10701	Issuer declaration
10750	Reward declaration
10801	App Version
10851	Report type string
10900	Address line 3
10901	Report sub type
10951	Audit report header
11000	Audit detail report
11001	Settlement type
11050	SALE
11051	TIP
11100	VOID
11101	TOTAL
11150	REFUND
11151	TOTAL
11200	NET TOTAL

Settlement Summary

Transaction response data Filed 31 will contain Batch Summaries of all batches in CSV format mentioned below: “Batch Name (HDFC), Acquire Code/host type, TID, MID, Credit Count, Credit Amount, Debit Count, Debit Amount| Batch Name (AXIS Credit), Acquire Code, TID, Credit Count, Credit Amount, Debit Count, Debit Amount| Batch Name (AXIS Debit), Acquire Code, TID, Credit Count, Credit Amount, Debit Count, Debit Amount| Batch Name (Loyalty), Acquire Code, TID, Credit Count, Credit Amount, Debit Count, Debit Amount”.

APIs

Overview

Message Protocol

Message Structure

Sale Transaction

Message Format

Refund Transaction

Message Format

Void Transaction

Message Format

Pre Auth Transaction

Message Format

Sale Complete Transaction

Message Format

Brand EMI Transaction

Message Format

Message Format

Bank EMI Transaction

Message Format

EMI as Single Transaction for Brand & Bank EMI

Message Format

Tip Adjust Transaction

Message Format

Adjust Transaction

Message Format

Reward Redemption

Message Format

Reward Void

Message Format

Reward Void

Message Format

Transaction Validation

Settlement

Message Format

Wallet

Wallet Pay

Message Format

Wallet Load

Message Format

Wallet Void

Message Format

Sodexo Sale

Message Format

Sodexo Void

Message Format

Sale With/Without Instant Discount

QC Redemption

Message Format

HDFC Flexipay - PoS (Pay Later)

Message Format

Zest Money

CSV Request

CSV RESPONSE

Zest Money - Invoice Sale

Message Format

Zest Money – Product Sale

Message Format

Zest Money – Void

UPI Sale Request

Message Format

Bharat QR Sale request

Message Formate

Airtel Sale

Message Format

Amazon Pay Request

TRANSCATION TYPES

Message Format

Paper PoS

Twid

TRANSCATION TYPES

Message Format

Twid Sale

Twid Getstatus:

Insurance and CCF

CCF

Insurance

Sample Request String

Brand EMI

When brand emi with insurance and without CCF

Brand EMI without Insurance and CCF