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 by orderId, 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 nameDescriptionData type
folioIdTransaction 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)
orderIdUnique 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 the orderId empty. If both parameters are sent with values at the same time, the service will give priority to the orderId, 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 reprint

The isReprint field 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, reprintModule comes 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, the reprintModule field 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 the responseCode field 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 transType field must not be used as a differentiator in a reprint, since it will always return the value A, regardless of the transaction's actual status. The reprintModule field is the only reliable field, as it indicates whether the transaction was approved, declined, canceled, or reversed.

reprintModuleMeaningmessage fieldDescription
CApproved transactionTransaccion ValidaConfirms that the transaction is approved.
VCanceled transactionTransaccion ValidaIndicates that the transaction was successfully canceled. The same message is used for approved sales; to differentiate between both cases, always validate the reprintModule field.
DDeclined transactionTransaccion DeclinadaThe transaction was declined by a fraud rule or by the issuer.
RVReversed transactionTransacción ReversadaThe transaction was successfully reversed and, therefore, must not be considered successful.
PRVTransaction pending reversalTransacción pendiente por reversarTransaction 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-folioId response will indicate, in the message field, 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 reprintModule field 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 message field, along with the validations of the fields discussed above (isReprint, reprintModule, among others).
❗️

Any change that affects the integration, or the implementation of new NetPay functionalities, must be certified with the Integrations team in order to validate its correct implementation and minimize incidents in production.


Did this page help you?