- Home
- All APIs
- Worldpay Total
- IPC Receipt Generation
IPC Receipt Generation
IPC provides formatted text only receipts either on a socket or a file. In attended mode two receipts are returned: the Merchant and the Customer receipts. In case of a Kiosk or Semi-Attended mode only a Customer receipt is returned.
Below are the attributes of an EFT receipt.
Note: These are subject to change in future releases of IPC in compliance with requirements from UK APACS.
UK APACS Receipt Format
Mandatory (APACS) Fields | Property | |
---|---|---|
1 | Merchant/Outlet Number | MerchantID |
2 | Merchant Name | MerchantName |
3 | Merchant Address | MerchantAddress1, MerchantAddress2, City, State, ZipCode |
4 | Transaction Type e.g. SALE / REFUND | TransactionType |
5 | Card Number (PAN) - Truncated | ApplPAN |
7 | Transaction Data Source e.g. ICC, SWIPE, KEYED | ChipStripeorKeyed |
8 | Date of Transaction | TransactionDate |
9 | Terminal Number (TID) | TerminalID |
10 | Transaction Number | TransactionSeqNo or TransactionReference |
11 | Transaction Response e.g. Auth Code | AuthCode |
12 | Amount of Transaction (Inc. currency symbol) | Amount |
13 | Request for Signature (not required for PIN Transactions replaced by 17) | N/A |
14 | Space for Signature (nor required for PIN Transactions replaced by 17) | N/A |
15 | Declaration e.g. Please debit my account | N/A |
16 | Retention Reminder | N/A |
17 | Amount of Cash (for Purchase With Cashback transaction) | AmountOther |
18 | PIN Verified Statement | N/A |
19 | Application Identifier | applID |
20 | Gratuity Amount (where a gratuity amount is added to the original amount) | AmountGratuity |
21 | Diagnostic Message | N/A |
23 | Card Issue No / Sequence No - App PAN Sequence No for ICC Transactions | ApplPANSeqNo |
24 | Time of Transaction | TransactionTime |
25 | Application Preferred Name* | ApplPreferredName |
* If the Application Preferred Name is not provided, or not readable from the card, the Application Label is provided on the receipt.
Optional | Property | |
---|---|---|
1 | Card Scheme Name | ApplLabel |
2 | Courtesy Message | N/A |
3 | Receipt Number (not transaction number) | N/A |
4 | Goods Amount | N/A |
5 | Goods Description | N/A |
6 | Hot Card File Version Number | HotCardVerNo |
7 | Term Software Version Number | TermSoftVerNo |
IPC provides receipts in two text files in the receipt folder as configured in the YESEFTConfig:
MainReceipt.txt – Merchant receipt
CustomerReceipt.txt – Customer receipt
IPC also provides receipts on a socket connection, if configured in YESEFTConfig.
IPC provides a configuration option to suppress Merchant receipts. If this option is chosen then Merchant receipts are not issued except where signature verification is needed.
In case of signature verification, the Merchant receipt is received first from IPC. There is a possibility that the EPOS application may receive another Merchant receipt if the attendant rejects the signature verification on the IPC prompt. The Customer receipt follows the Merchant receipts.
This is the sequence that needs to be followed for receipt printing if the EPOS application is printing the receipts:
Check for Merchant Receipt
On receiving Merchant Receipt, print the receipt
Check for Merchant Receipt or Customer Receipt
If Merchant Receipt, print the receipt and then wait for Customer receipt
If Customer receipt, print the receipt and wait for response
The IPC transaction response is issued at the end of the transaction. There will be no more receipts after the response message is issued.
The receipts are validated as compliant EMV receipts as part of the accreditation process that IPC undergoes with the acquiring banks. All the information contained in the IPC Customer receipt should be printed by the EPOS application. The Customer receipt text should be at least 2.55mm in height and not narrower than 15 characters per inch. The EPOS application should print Customer receipts from all transactions where IPC issues such a receipt.
The examples below show typical Merchant and Customer receipts generated by IPC for a Chip and PIN transaction.
Receipts in Text Files MainReceipt.txt and CustomerReceipt.txt
CUSTOMER RECEIPT
YESPAY DEMO
153 CHECKNET HOUSE EAST BARNET ROAD
BARNET HERTS EN4 8QZ
06/11/2013 01:47:34
RECEIPT NO.: 3
MID:XXX49873 TID:XXXX0012
AID:A0000000041010
MASTERCARD
XXXX XXXX XXXX 0020
PAN SEQ NO. : 00
ICC
SALE GBP100.00
TOTAL GBP100.00
PLEASE DEBIT MY ACCOUNT
PIN VERIFIED
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE: 007054
MERCHANT RECEIPT
YESPAY DEMO
153 CHECKNET HOUSE EAST BARNET ROAD
BARNET HERTS EN4 8QZ
06/11/2013 01:47:34
RECEIPT NO.: 2
MID:21249872 TID:22980012
AID:A0000000041010
MASTERCARD
XXXX XXXX XXXX 0020
PAN SEQ NO. : 00
ICC
SALE GBP100.00
TOTAL GBP100.00
PLEASE DEBIT MY ACCOUNT
PIN VERIFIED
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE: 007054
Receipts in Text Files US MainReceipt.txt and CustomerReceipt.txt
Main Receipt
GREENS CROSSING BLVD
, , HOUSTON TX ,
SALE
MID: 0314 TID: 706
REF#:00000123
RRN: 500007218
07/03/2019 17:15:25
APPR CODE : 003364
DINERS CLUB CHIP
AID: A0000001523010
XXXX XXXX XXXX 0018 /
AMOUNT USD31.00
TOTAL USD31.00
APPROVED
VERIFIED BY PIN
I AGREE TO PAY THE ABOVE TOTAL
AMOUNT
(MERCHANT AGREEMENT IF CREDIT
VOUCHER)
RETAIN THIS COPY FOR STATEMENT
VERIFICATION
MERCHANT COPY
CUSTOMER RECEIPT
GREENS CROSSING BLVD
, , HOUSTON TX ,
SALE
MID: 0314
TID: 706 REF#: 00000123
RRN: 500006597
01/03/2019 17:09:23
APPR CODE : 003242
AID: A0000000651010
JCB CREDIT CHIP
XXXX XXXX XXXX 2211 /
AMOUNT USD10.00
TOTAL USD10.00
APPROVED
SIGNATURE VERIFIED
I AGREE TO PAY THE ABOVE TOTAL
AMOUNT
(MERCHANT AGREEMENT IF CREDIT
VOUCHER)
RETAIN THIS COPY FOR STATEMENT
VERIFICATION
CUSTOMER COPY
Receipts from the Receipt Socket port
Receipts issued on the Receipt Socket port are prefixed by labels CUSTOMER: and MERCHANT: so that their start point may be readily identified in the stream of data from the socket. These labels should be removed from the receipt data and not printed.
CUSTOMER:CUSTOMER RECEIPT
YESPAY DEMO
153 CHECKNET HOUSE EAST BARNET ROAD
BARNET HERTS EN4 8QZ
06/11/2013 01:47:34
RECEIPT NO.: 3
MID:XXX49873 TID:XXXX0012
AID:A0000000041010
MASTERCARD
XXXX XXXX XXXX 0020
PAN SEQ NO. : 00
ICC
SALE GBP100.00
TOTAL GBP100.00
PLEASE DEBIT MY ACCOUNT
PIN VERIFIED
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE: 007054
MERCHANT:MERCHANT RECEIPT
YESPAY DEMO
153 CHECKNET HOUSE EAST BARNET ROAD
BARNET HERTS EN4 8QZ
06/11/2013 01:47:34
RECEIPT NO.: 2
MID:21249872 TID:22980012
AID:A0000000041010
MASTERCARD
XXXX XXXX XXXX 0020
PAN SEQ NO. : 00
ICC
SALE GBP100.00
TOTAL GBP100.00
PLEASE DEBIT MY ACCOUNT
PIN VERIFIED
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE: 007054
Sample receipts for Gift Card Redemption/Sale Transaction
MERCHANT RECEIPT
YESPAY INTERNATIONAL LTD
CHECKNET HOUSE 153 EAST BARNET ROAD
BARNET HERTORDSHIRE EN4 8QZ
04/06/2013 07:33:23
RECEIPT NO.:2
MID:1234567 TID:22980061
YESPAY GIFT CARD
XXXX XXXX XXXX XXX 5280
MAG. STRIPE
SALE GBP25.00
TOTAL GBP25.00
PLEASE DEBIT MY ACCOUNT
NO CARDHOLDER VERIFICATION
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE: 073252
HOST BALANCE : UNAVAILABLE
EXPECTED BALANCE : GBP30.00
CUSTOMER RECEIPT
YESPAY INTERNATIONAL LTD
CHECKNET HOUSE 153 EAST BARNET ROAD
BARNET HERTORDSHIRE EN4 8QZ
04/06/2013 07:33:23
RECEIPT NO.:2
MID:XX34567 TID:XXXX0061
YESPAY GIFT CARD
XXXX XXXX XXXX XXX 5280
MAG. STRIPE
SALE GBP25.00
TOTAL GBP25.00
PLEASE DEBIT MY ACCOUNT
NO CARDHOLDER VERIFICATION
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE: 073252
HOST BALANCE : UNAVAILABLE
EXPECTED BALANCE : GBP30.00
Sample receipts for Gift Card Refund Transaction
MERCHANT RECEIPT
YESPAY INTERNATIONAL LTD
CHECKNET HOUSE 153 EAST BARNET ROAD
BARNET HERTORDSHIRE EN4 8QZ
04/06/2013 07:34:47
RECEIPT NO.:3
MID:1234567 TID:22980061
YESPAY GIFT CARD
XXXX XXXX XXXX XXX 5280
MAG. STRIPE
REFUND GBP20.00
TOTAL GBP20.00
PLEASE CREDIT MY ACCOUNT
NO CARDHOLDER VERIFICATION
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE: 073415
HOST BALANCE : UNAVAILABLE
EXPECTED BALANCE : GBP50.00
CUSTOMER RECEIPT
YESPAY INTERNATIONAL LTD
CHECKNET HOUSE 153 EAST BARNET ROAD
BARNET HERTORDSHIRE EN4 8QZ
04/06/2013 07:34:47
RECEIPT NO.:3
MID:XX34567 TID:XXXX0061
YESPAY GIFT CARD
XXXX XXXX XXXX XXX 5280
MAG. STRIPE
REFUND GBP20.00
TOTAL GBP20.00
PLEASE CREDIT MY ACCOUNT
NO CARDHOLDER VERIFICATION
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE: 073415
HOST BALANCE : UNAVAILABLE
EXPECTED BALANCE : GBP50.00
Sample receipts for Gift Card Top Up/Load Transaction
MERCHANT RECEIPT
YESPAY INTERNATIONAL LTD
CHECKNET HOUSE 153 EAST BARNET ROAD
BARNET HERTORDSHIRE EN4 8QZ
04/06/2013 07:35:44
RECEIPT NO.:4
MID:1234567 TID:22980061
YESPAY GIFT CARD
XXXX XXXX XXXX XXX 5280
MAG. STRIPE
LOAD GBP50.00
TOTAL GBP50.00
CARD HAS BEEN LOADED SUCCESSFULLY
NO CARDHOLDER VERIFICATION
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE: 073512
HOST BALANCE : UNAVAILABLE
EXPECTED BALANCE : GBP80.00
CUSTOMER RECEIPT
YESPAY INTERNATIONAL LTD
CHECKNET HOUSE 153 EAST BARNET ROAD
BARNET HERTORDSHIRE EN4 8QZ
04/06/2013 07:35:44
RECEIPT NO.:4
MID:XX34567 TID:XXXX0061
YESPAY GIFT CARD
XXXX XXXX XXXX XXX 5280
MAG. STRIPE
LOAD GBP50.00
TOTAL GBP50.00
CARD HAS BEEN LOADED SUCCESSFULLY
NO CARDHOLDER VERIFICATION
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE: 073512
HOST BALANCE : UNAVAILABLE
EXPECTED BALANCE : GBP80.00
Sample receipts for Gift Card Check Balance Transaction
CUSTOMER RECEIPT
YESPAY INTERNATIONAL LTD
CHECKNET HOUSE 153 EAST BARNET ROAD
BARNET HERTORDSHIRE EN4 8QZ
04/06/2013 07:15:42
RECEIPT NO.:1
MID:XX34567 TID:XXXX0061
YESPAY GIFT CARD
XXXX XXXX XXXX XXX 5280
MAG. STRIPE
NO CARDHOLDER VERIFICATION
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE: 071510
HOST BALANCE : GBP55.00
Sample receipt for Terminal Key recovery Sale Transaction
MERCHANT RECEIPT
YESPAY DEMO MERCHANT 4
CHECKNET HOUSE 153 EAST BARNET ROAD
BARNET HERTFORDSHIRE EN4 8QZ
02/05/2018 13:04:02
RECEIPT NO.:241
MID:100612000036 TID:33319560
NEWDAY STAFF CARD
XXXX XXXX XXXX 0990
RECOVERED DATA, KEYED
SALE GBP1.00
TOTAL GBP1.00
PLEASE DEBIT MY ACCOUNT
SIGNATURE VERIFIED
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE:123456
Sample receipt for Terminal Key recovery Refund Transaction
MERCHANT RECEIPT
YESPAY DEMO MERCHANT 4
CHECKNET HOUSE 153 EAST BARNET ROAD
BARNET HERTFORDSHIRE EN4 8QZ
02/05/2018 14:32:23
RECEIPT NO.:242
MID:100612000036 TID:33319560
NEWDAY STAFF CARD
XXXX XXXX XXXX 0990
RECOVERED DATA, KEYED
REFUND GBP2.00
TOTAL GBP2.00
PLEASE CREDIT MY ACCOUNT
SIGNATURE VERIFIED
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE:02031
Sample receipt for Account Verification Transaction
MERCHANT RECEIPT
YESPAY DEMO
153 CHECKNET HOUSE EAST BARNET ROAD
BARNET HERTS EN4 8QZ
21/12/2018 14:43
RECEIPT NO.:242
MID:21249872 TID:22980011
AID:A000000004101002
MASTERCARD
XXXX XXXX XXXX 0045
PAN SEQ NO. :03
ICC
ACCOUNT VERIFICATION
YOU WILL NOT BE CHARGED FOR THIS
TRANSACTION
PIN VERIFIED
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE:123
CUSTOMER RECEIPT
YESPAY DEMO
153 CHECKNET HOUSE EAST BARNET ROAD
BARNET HERTS EN4 8QZ
21/12/2018 14:43
RECEIPT NO.:242
MID:XXX49872 TID:XXXX0011
AID:A000000004101002
MASTERCARD
XXXX XXXX XXXX 0045
PAN SEQ NO. :03
ICC
ACCOUNT VERIFICATION
YOU WILL NOT BE CHARGED FOR THIS
TRANSACTION
PIN VERIFIED
PLEASE KEEP THIS RECEIPT FOR YOUR
RECORDS
AUTH CODE:123
Sample receipts for Alipay Sale Transaction using BarCode
Merchant Receipt
TEST 1 MBH
, , , , ,
27/06/2019 15:03:46
RECEIPT NO.:1170
MID:12345678 TID:31300136
ALIPAY BARCODE
281768579629176187
KEYED
SALE GBP2.00
TOTAL GBP2.00
PLEASE DEBIT MY ACCOUNT
NO CARDHOLDER VERIFICATION
PLEASE KEEP THIS RECEIPT FOR YOUR RECORDS
Customer Receipt
TEST 1 MBH
, , , , ,
27/06/2019 15:03:46
RECEIPT NO.:1170
MID:XXX45678 TID:XXXX0136
ALIPAY BARCODE
281768579729176187
KEYED
SALE GBP2.00
TOTAL GBP2.00
PLEASE DEBIT MY ACCOUNT
NO CARDHOLDER VERIFICATION
PLEASE KEEP THIS RECEIPT FOR YOUR RECORDS
Sample receipts for Alipay Cancel Transaction using BarCode
Merchant Receipt
TEST 1 MBH
, , , , ,
27/06/2019 15:36:46
RECEIPT NO.:1176
MID:12345678 TID:31300136
CANCEL APPROVED
Customer Receipt
TEST 1 MBH
, , , , ,
27/06/2019 15:36:46
RECEIPT NO.:1176
MID:XXX45678 TID:XXXX0136
CANCEL APPROVED
Sample receipts for Alipay Refund Transaction using BarCode
Merchant Receipt
TEST 1 MBH
, , , , ,
27/06/2019 14:57:39
RECEIPT NO.:1168
MID:12345678 TID:31300136
ALIPAY BARCODE
XXXX XXXX XXXX X 0495
KEYED
REFUND GBP2.00
TOTAL GBP2.00
PLEASE CREDIT MY ACCOUNT
NO CARDHOLDER VERIFICATION
PLEASE KEEP THIS RECEIPT FOR YOUR RECORDS
Customer Receipt
TEST 1 MBH
, , , , ,
27/06/2019 14:57:39
RECEIPT NO.:1168
MID:XXX45678 TID:XXXX0136
ALIPAY BARCODE
XXXX XXXX XXXX X 0495
KEYED
REFUND GBP2.00
TOTAL GBP2.00
PLEASE CREDIT MY ACCOUNT
NO CARDHOLDER VERIFICATION
PLEASE KEEP THIS RECEIPT FOR YOUR RECORDS