Provide Receipts
Review receipt requirements in the Card Network Rules resource.
Compile Receipts
| Data | Required? | Find in API vs. SDK | Resource/Class & Parameter |
|---|---|---|---|
| Merchant name | Required | API | Accounts; name |
| Merchant Location (city & state/province) | Required | API | Legal Entities; address |
| Transaction Type (abbreviation allowed) | Required | N/A | Option to always print “Pre-Authorization,” or build logic to identify transactions as pre-authorizations vs. sale and print the appropriate string. |
| Local date and time | Required | SDK | paymentDate |
| Entry Mode | Required | SDK | Payment Method; inputSource – print in uppercase |
| Card Issuer Name / Card Brand Name | Required | SDK | Payment Method; cardBrand – print in uppercase |
| Card Type | Required | N/A | Always print “CREDIT” |
| Masked PAN | Required | SDK | Payment Method; maskedPAN |
| Truncated Expiration Date | Required | SDK | Payment Method; expirationMonth & expirationYear |
| Transaction Amount | Required | SDK | Authorization Info; amount |
| Total Amount | Required | SDK | Authorization Info; - amount+tipAmount (tip on terminal)- amount (no tip)- blank (tip on receipt) |
| Authorization Code (including offline) | Required | SDK | Authorization Info; authorizationCode |
| Application ID | Required on EMV only | SDK | EMC Info: applicationIdentifier |
| Application Preferred Name | Required on EMV only | SDK | EMV Info: applicationLabel |
| Transaction Outcome | Recommended | SDK | Authorization Info; authorizationResult |
| MERCHANT COPY / CARDHOLDER COPY | Recommended | N/A | Print “Merchant Copy” or “Cardholder Copy” |
Deliver Receipts
Once a receipt has been compiled, the merchant can provide either an electronic or a paper receipt to the payer. The delivery method may be restricted, depending on the hardware that the merchant is set up with.
Terminals
Merchants using the VeriFone V400m can leverage the receipt printer included with the terminal itself. For these cases, simply inject any custom or required information needed into the customer receipt text blob returned by the SDK on the Payment Info class. These merchants can also provide electronic receipts.
Merchants using the VeriFone P400 must either exclusively offer electronic receipts or procure their own external receipt printer, compatible with the terminal being used.
Mobile Card Readers
Merchants using the Ingenico RP457c AudioJack or Ingenico Moby 5500 must either exclusively offer electronic receipts, or procure their own bluetooth receipt printer to offer paper receipts as well.
Questions? Need help? Visit our support page!