Reprint by Folio
This functionality is currently mandatory to implement in your point of sale, as it serves as a defense mechanism against contingencies that prevent the response from being received, allowing it to be recovered using this functionality.
This functionality is only available with:
- .NET Framework.
- Smart PinPad 2.0 or higher.
- DLL 1.6.0 onwards.
Note: This functionality is not available for Visual Basic 6 or Visual FoxPro, due to language limitations that only allow the use of DLL 1.2.0.
Reprint by folio serves 2 purposes:
- Printing a paper copy of approved and declined transactions (except reversals), while also returning the response in JSON format as a duplicate of the original sale.
- Serving as a query mechanism to recover the status of lost transactions, whether approved, declined, canceled, reversed, or pending reversal.
This functionality is similar to reprint byorderId, but with a broader scope, since it allows reprinting or recovering not only approved transactions, but also declined, canceled, and reversed ones.
Requirements for reprint by folio in 2026
- Have the latest version of the library, version 1.6.0: Download library
- Have Smart PinPad Dev 2.6.0.1.p.p installed for testing, or Smart PinPad 2.6 for production.
- To recover the response of a sale using the folio, this field must have been sent previously in the original sale transaction.
Fields used for reprinting
| Field name | Description | Data type |
|---|---|---|
| folioId | Transaction identifier that can be sent in the sale request and must be a unique internal value from the merchant's point-of-sale system. Sending it in the reprint can help retrieve approved, declined, canceled, reversed, and pending-reversal transactions. | String (Maximum of 250 characters) |
| orderId | Unique transaction identifier with NetPay. It is generated on a successful sale and can later be used to reprint approved transactions and for the sale cancellation operation. | String (Maximum of 250 characters) |
Sending the folio in the original sale
For reprint by folio to work correctly, the folioId field must be sent from the original sale transaction. Below is an example of a sale sending the folio:
connectorPAX.SetAmount(Convert.ToDouble(textBox1.Text));
if (CAMPOTIP == "")
{
connectorPAX.SetTip(0.0);
}
else
{
connectorPAX.SetTip(Convert.ToDouble(textBox5.Text));
}
connectorPAX.SetFolio(textBox2.Text); // The folio is sent in the sale
connectorPAX.SetMSI(Convert.ToInt32(msiValue));
connectorPAX.setDisablePrintAnimation(checkBox1.Checked);
connectorPAX.sendData(); // The sale is sent to the terminal
Keep in mind that the previous sale must have been generated with the folio from the merchant's point-of-sale system.
Implementing reprint by folio (sendPrint)
From Smart PinPad version 2.0 onwards and DLL 1.6.0, it is possible to query a wider variety of transaction statuses. When both conditions are met, the sendPrint() method can be executed, passing the sale's folio as a parameter to query its status. Below is an example of how to run reprint by folio in a separate internal process of the merchant's point-of-sale system:
private void button2_Click(object sender, EventArgs e)
{
connectorPAX.SetCustomeCOMM("COM9"); // For DLL 1.6.0, the COM port must be specified.
if (folioId.Text != "")
{
button2.Enabled = false;
button3.Enabled = false;
timer2.Enabled = true;
timer1.Enabled = true;
connectorPAX.setDisablePrintAnimation(checkBox1.Checked);
string result = connectorPAX.sendPrint("", folioId.Text);
textBox4.Text = result;
}
}
For the folio search to work correctly, it is recommended to send theorderIdempty. If both parameters are sent with values at the same time, the service will give priority to theorderId, which may prevent you from receiving the expected response.
Receiving the response of a sale and of a reprint
Below is an example of how to receive the response of this operation using the ReceiveData() and getResponse() methods:
private void getResponseData()
{
connectorPAX.ReceiveData();
if (connectorPAX.getResponse() != null)
{
responseTextbox.Text = JsonConvert.SerializeObject(connectorPAX.getResponse());
timer1.Enabled = false;
}
}The response object is received in JSON format. Below is an example of the response of an approved sale with its own response, and a reprint of that sale:
{
"data": {
"affiliation": "7286147",
"amount": "159.85",
"applicationLabel": "null",
"arqc": "6EAEB1A634241A44",
"aid": "A0000000041010",
"authCode": "222222",
"bankName": "NU MEXICO FINANCIERA",
"bin": "",
"cardExpDate": "06/30",
"cardType": "C",
"cardNumber": "9453",
"cardTypeName": "MASTERCARD",
"cityName": "Guadalupe,NUEVO LEON",
"responseCode": "00",
"folioNumber": "2-5645-1777567065362",
"hasPin": false,
"hexSign": "null",
"isQPS": 0,
"isReprint": true,
"message": "Transaccion Valida",
"moduleCharge": "292",
"moduleLote": "2",
"customerName": "null",
"terminalId": "2841260371",
"orderId": "260430103756-2841260371",
"preAuth": "0",
"preStatus": 0,
"promotion": "0",
"rePrintDate": "2.6.0.1.p.p_20260304",
"rePrintMark": "MASTER",
"reprintModule": "C",
"rrnNumber": "043010375634",
"storeId": "9194",
"storeName": "CICAP",
"streetName": "AVE PABLO LIVAS 7200",
"ticketDate": "ABR. 30, 26 10:38:25",
"tipAmount": "20.85",
"tipLessAmount": "139",
"transDate": "2026-04-30 10:37:56.0",
"transType": "A",
"transactionCertificate": "6EAEB1A634241A44",
"transactionId": "ED4AE88E-C087-F8E6-9FA2-E3495A7674A1",
"cashbackFee": "0",
"cardOrigin": null
},
"idReport": 1,
"applyCashback": false
}{
"data": {
"affiliation": "7286147",
"amount": "159.85",
"applicationLabel": "null",
"arqc": "6EAEB1A634241A44",
"aid": "A0000000041010",
"authCode": "222222",
"bankName": "NU MEXICO FINANCIERA",
"bin": "",
"cardExpDate": "06/30",
"cardType": "C",
"cardNumber": "9453",
"cardTypeName": "MASTERCARD",
"cityName": "Guadalupe,NUEVO LEON",
"responseCode": "00",
"folioNumber": "2-5645-1777567065362",
"hasPin": false,
"hexSign": "null",
"isQPS": 0,
"isReprint": true,
"message": "Transaccion Valida",
"moduleCharge": "292",
"moduleLote": "2",
"customerName": "null",
"terminalId": "2841260371",
"orderId": "260430103756-2841260371",
"preAuth": "0",
"preStatus": 0,
"promotion": "0",
"rePrintDate": "2.6.0.1.p.p_20260304",
"rePrintMark": "MASTER",
"reprintModule": "C",
"rrnNumber": "043010375634",
"storeId": "9194",
"storeName": "CICAP",
"streetName": "AVE PABLO LIVAS 7200",
"ticketDate": "ABR. 30, 26 10:38:25",
"tipAmount": "20.85",
"tipLessAmount": "139",
"transDate": "2026-04-30 10:37:56.0",
"transType": "A",
"transactionCertificate": "6EAEB1A634241A44",
"transactionId": "ED4AE88E-C087-F8E6-9FA2-E3495A7674A1",
"cashbackFee": "0",
"cardOrigin": null
},
"idReport": 1,
"applyCashback": false
}
Difference between a sale and a reprintThe
isReprintfield indicates whether the response corresponds to a sale or to a reprint:
isReprint: false→ The response corresponds to the original sale process. In this case,reprintModulecomes with a different value, since this field is only determined when a reprint is executed.isReprint: true→ The response corresponds to a reprint by folio. In this case, thereprintModulefield must be validated to determine the final status of the transaction.
Determining a transaction's status from a reprint by folio
To assess the status of a transaction from a reprint-by-folio response, the field that must be validated is reprintModule. The possible values and their meaning are detailed below:
It is critically important not to rely solely on theresponseCodefield to validate the result of a reprint since, being a query-type operation, this field will return a generic value that does not reflect the actual status of the transaction.Likewise, the
transTypefield must not be used as a differentiator in a reprint, since it will always return the valueA, regardless of the transaction's actual status. ThereprintModulefield is the only reliable field, as it indicates whether the transaction was approved, declined, canceled, or reversed.
| reprintModule | Meaning | message field | Description |
|---|---|---|---|
| C | Approved transaction | Transaccion Valida | Confirms that the transaction is approved. |
| V | Canceled transaction | Transaccion Valida | Indicates that the transaction was successfully canceled. The same message is used for approved sales; to differentiate between both cases, always validate the reprintModule field. |
| D | Declined transaction | Transaccion Declinada | The transaction was declined by a fraud rule or by the issuer. |
| RV | Reversed transaction | Transacción Reversada | The transaction was successfully reversed and, therefore, must not be considered successful. |
| PRV | Transaction pending reversal | Transacción pendiente por reversar | Transaction scheduled to be reversed on a subsequent transaction. |
Exceptions
- When using a repeated
folioId, the reprint will show the latest transaction performed with the entered folio. - When entering a non-existent
folioId, the terminal will display the message "No se encontraron datos" (No data found). - When querying a transaction that had a connection error during the original sale, the reprint-by-
folioIdresponse will indicate, in themessagefield, a transaction pending reversal.
Reprint by folio of approved transactions
Below is the response obtained when performing a reprint by folio of an approved transaction. The reprintModule field shows the value C:
{
"data": {
"affiliation": "7286147",
"amount": "159.85",
"applicationLabel": "null",
"arqc": "6EAEB1A634241A44",
"aid": "A0000000041010",
"authCode": "222222",
"bankName": "NU MEXICO FINANCIERA",
"bin": "",
"cardExpDate": "06/30",
"cardType": "C",
"cardNumber": "9453",
"cardTypeName": "MASTERCARD",
"cityName": "Guadalupe,NUEVO LEON",
"responseCode": "00",
"folioNumber": "2-5645-1777567065362",
"hasPin": false,
"hexSign": "null",
"isQPS": 0,
"isReprint": true,
"message": "Transaccion Valida",
"moduleCharge": "292",
"moduleLote": "2",
"customerName": "null",
"terminalId": "2841260371",
"orderId": "260430103756-2841260371",
"preAuth": "0",
"preStatus": 0,
"promotion": "0",
"rePrintDate": "2.6.0.1.p.p_20260304",
"rePrintMark": "MASTER",
"reprintModule": "C",
"rrnNumber": "043010375634",
"storeId": "9194",
"storeName": "CICAP",
"streetName": "AVE PABLO LIVAS 7200",
"ticketDate": "ABR. 30, 26 10:38:25",
"tipAmount": "20.85",
"tipLessAmount": "139",
"transDate": "2026-04-30 10:37:56.0",
"transType": "A",
"transactionCertificate": "6EAEB1A634241A44",
"transactionId": "ED4AE88E-C087-F8E6-9FA2-E3495A7674A1",
"cashbackFee": "0",
"cardOrigin": null
},
"idReport": 1,
"applyCashback": false
}Reprint by folio of cancellations
Below is the response obtained when performing a reprint by folio of a successful cancellation. The reprintModule field shows the value V, indicating that the transaction was canceled:
{
"data": {
"affiliation": "7286147",
"amount": "160",
"applicationLabel": "null",
"arqc": "8BD396EDEE3C1118",
"aid": "A0000000041010",
"authCode": "222222",
"bankName": "NU MEXICO FINANCIERA",
"bin": "",
"cardExpDate": "06/30",
"cardType": "C",
"cardNumber": "9453",
"cardTypeName": "MASTERCARD",
"cashbackFee": "0",
"cityName": "Guadalupe,NUEVO LEON",
"responseCode": "00",
"folioNumber": "2-5631-1777482670950",
"hexSign": "null",
"isQPS": 0,
"isReprint": true,
"message": "Transaccion Valida",
"moduleCharge": "269",
"moduleLote": "2",
"customerName": "null",
"terminalId": "2841260371",
"orderId": "260429111118-2841260371",
"preAuth": "0",
"preStatus": 0,
"promotion": "0",
"rePrintDate": "2.6.0.1.p.p_20260304",
"rePrintMark": "MASTER",
"reprintModule": "V",
"rrnNumber": "042911111875",
"storeId": "9194",
"storeName": "CICAP",
"streetName": "AVE PABLO LIVAS 7200",
"ticketDate": "ABR. 29, 26 11:11:48",
"tipAmount": "0",
"tipLessAmount": "0",
"transDate": "2026-04-29 11:11:18.0",
"transType": "A",
"transactionCertificate": "8BD396EDEE3C1118",
"transactionId": "4267CF8B-FEA5-F96F-21A0-DDCAFE4E8056",
"hasPin": false,
"cardOrigin": null
},
"idReport": 1,
"applyCashback": false
}Reprint by folio of declined transactions
The status D in the reprintModule field of a reprint by folio indicates that the transaction was declined. The message field confirms it as well.
{
"data": {
"affiliation": "7286147",
"amount": "15600",
"bankName": "SANTANDER",
"cardType": "D",
"cardNumber": "7934",
"cardTypeName": "MASTERCARD",
"cityName": "APODACA,NUEVO LEON",
"responseCode": "05",
"folioNumber": "transaccion-declinada",
"isReprint": true,
"message": "Transaccion Declinada",
"moduleCharge": "5",
"moduleLote": "1",
"terminalId": "2840224321",
"rePrintDate": "2.6.0.1.p.p_20260304",
"rrnNumber": "null",
"storeId": "550011",
"streetName": "CHV",
"ticketDate": "JUL. 07, 26 16:58:37",
"transType": "A",
"transactionId": "6217516F-C93C-6D62-9AFD-899610D10A0C",
"storeName": "Chevron",
"reprintModule": "D",
"applicationLabel": "Debit MasterCard",
"customerName": "DEBITO UNIVERSIDADES /",
"preAuth": "0",
"transDate": "2026-07-07 15:58:40.0",
"authCode": "null",
"tipLessAmount": "0",
"tipAmount": "0",
"aid": "A0000000041010",
"arqc": "ACC94719F099DDDC",
"cardExpDate": "10/23",
"orderId": "",
"promotion": "0",
"rePrintMark": "MASTER",
"hexSign": "null",
"transactionCertificate": "ACC94719F099DDDC",
"preStatus": 0,
"isQPS": 0,
"hasPin": false,
"cashbackFee": "0"
},
"idReport": 1,
"applyCashback": false
}Reprint by folio of reversed transactions
The status RV in the reprintModule field of a reprint by folio indicates that the transaction has been reversed. In most cases, the terminal performs the reversal automatically, as long as it has an internet connection during the interruption or communication loss.
{
"data": {
"affiliation": "7286147",
"amount": "115",
"bankName": "BBVA",
"bin": "",
"cardType": "C",
"cardNumber": "3827",
"cardTypeName": "VISA",
"cityName": "Guadalupe,NUEVO LEON",
"responseCode": "05",
"folioNumber": "2-5650-1781118562363",
"isReprint": true,
"message": "Transacción Reversada",
"moduleCharge": "353",
"moduleLote": "2",
"terminalId": "2841260371",
"rePrintDate": "2.6.0.1.p.p_20260304",
"rrnNumber": "null",
"storeId": "9194",
"streetName": "AVE PABLO LIVAS 7200",
"ticketDate": "JUN. 10, 26 13:10:11",
"transType": "A",
"transactionId": "423DBCB1-61E9-BE0C-ACE8-1A7A56C7372C",
"storeName": "CICAP",
"reprintModule": "RV",
"applicationLabel": "null",
"customerName": "null",
"preAuth": "0",
"transDate": "2026-06-10 13:09:49.0",
"authCode": "222222",
"tipLessAmount": "0",
"tipAmount": "0",
"aid": "A0000000031010",
"arqc": "607BB6C289B7C328",
"cardExpDate": "10/30",
"orderId": "",
"promotion": "0",
"rePrintMark": "VISA",
"hexSign": "null",
"transactionCertificate": "607BB6C289B7C328",
"preStatus": 0,
"isQPS": 0,
"hasPin": false,
"cashbackFee": "0",
"cardOrigin": null
},
"idReport": 1,
"applyCashback": false
}Reprint by folio of transactions pending reversal
The status PRV in the reprintModule field of a reprint by folio indicates that the transaction is pending reversal, meaning it will be reversed on a subsequent transaction. The details are specified in the message field.
{
"data": {
"affiliation": "7286147",
"amount": "115",
"bankName": "BBVA",
"bin": "",
"cardType": "C",
"cardNumber": "3827",
"cardTypeName": "VISA",
"cityName": "Guadalupe,NUEVO LEON",
"responseCode": "05",
"folioNumber": "2-5651-1781119392104",
"isReprint": true,
"message": "Transacción pendiente por reversar",
"moduleCharge": "354",
"moduleLote": "2",
"terminalId": "2841260371",
"rePrintDate": "2.6.0.1.p.p_20260304",
"rrnNumber": "null",
"storeId": "9194",
"streetName": "AVE PABLO LIVAS 7200",
"ticketDate": "JUN. 10, 26 13:23:49",
"transType": "A",
"transactionId": "612A2DCC-A046-C005-867B-0DA6E72BA9E0",
"storeName": "CICAP",
"reprintModule": "PRV",
"applicationLabel": "null",
"customerName": "null",
"preAuth": "0",
"transDate": "2026-06-10 13:23:27.0",
"authCode": "222222",
"tipLessAmount": "0",
"tipAmount": "0",
"aid": "A0000000031010",
"arqc": "3AF7225647B2B9AD",
"cardExpDate": "10/30",
"orderId": "",
"promotion": "0",
"rePrintMark": "VISA",
"hexSign": "null",
"transactionCertificate": "3AF7225647B2B9AD",
"preStatus": 0,
"isQPS": 0,
"hasPin": false,
"cashbackFee": "0",
"cardOrigin": null
},
"idReport": 1,
"applyCashback": false
}
This information applies only to reprints by folio.
- During the sale process (not a reprint), the
reprintModulefield remains null or contains different values, so its value should only be validated in a reprint by folio.- This information does not apply to reprint by
orderId, since that method can only reprint approved transactions.- These statuses are only returned when reprinting by folio and help provide more detail. NetPay requests that, when a reprint by folio is executed, you update these statuses in your database.
- NetPay also currently requests that all messages be displayed in your point-of-sale system's interface dynamically, that is, display whatever NetPay provides in the
messagefield, along with the validations of the fields discussed above (isReprint,reprintModule, among others).
Updated 8 days ago
