eDynamo - Compliant Receipts

Modified on Thu, 4 Sep at 12:08 PM

EMV - Compliant Receipts

Merchants are required to generate and provide EMV-compliant receipts for all EMV transaction sales and authorizations. These receipts serve as a critical component of payment compliance, ensuring that all necessary EMV data is properly captured and communicated to the cardholder at the point of sale.

The data required to build an EMV-compliant receipt is available directly within the transaction response data returned from your integration method:

Forte Checkout: Required fields are provided in the callback data.
REST API or AGI integrations: Required fields are provided in the response objects.

For clarity:

Fields displayed in angle brackets < > correspond to the callback field names from Forte Checkout.
Fields displayed in square brackets [ ] correspond to the response field names from the REST or AGI response messages.

It is important to note that these represent the minimum required fields for EMV compliance. Merchants may apply their own custom formatting, branding, or receipt layout as long as the required EMV data is present.

Included in this documentation are:

Sample EMV responses from Forte Checkout, REST API, and AGI integrations.
A sample EMV receipt showing how the required fields can be displayed.

Sample AGI EMV Response

pg_response_type=A 
pg_response_code=A01 
pg_response_description=TEST APPROVAL 
pg_authorization_code=123456 
pg_trace_number=7D2A316E-08FA-4418-B06F-80FEEC53C697 
pg_avs_code=Y 
pg_cvv_code=M 
pg_merchant_id=176645 
pg_transaction_type=10 
ecom_billto_postal_name_first=Test 
ecom_billto_postal_name_last=User 
pg_total_amount=1.0 
pg_cc_enc_decryptor=21079802 
pg_emv_receipt_data=application_label:VISA DEBIT|entry_mode:CHIP|CVM:5E0000|AID:A0000000031010|TVR:8000008000|IAD:06010A03A08000|TSI:6800|ARC: 
endofdata

Sample REST EMV Response

stdClass Object
(
    [transaction_id] => trn_d675487d-3fb6-413d-9e9c-e3e69f6307c5
    [location_id] => loc_xxxxxx
    [action] => sale
    [authorization_amount] => 2
    [entered_by] => ce71ece4f900dcb11b30e511b0b97ea6
    [billing_address] => stdClass Object
        (
            [first_name] => Test
            [last_name] => User
            [physical_address] => stdClass Object
                (
                    [street_line1] => 123 Main Street
                    [postal_code] => 12345
                )

        )

    [response] => stdClass Object
        (
            [environment] => live
            [response_type] => A
            [response_code] => A01
            [response_desc] => APPROVED
            [authorization_code] => 074457
            [avs_result] => N
            [cvv_result] => P
            [emv_receipt_data] => application_label:VISA DEBIT|entry_mode:CHIP|CVM:5E0000|AID:A0000000031010|TVR:8000008000|IAD:06010A03A08000|TSI:6800|ARC:
        )

)

Forte Checkout EMV Response

{
   "event":"success",
   "method":"sale",
   "request_id":"d51906d5-5fdf-48e0-e551-5992217e48a",
   "response_code":"A01",
   "response_description":"TEST APPROVAL",
   "trace_number":"fc56ee93-d09e-49c7-91db-3e9c6f1265b9",
   "authorization_code":"8RO895",
   "total_amount":"1",
   "avs_code":"Y",
   "order_number":"OrderNumber",
   "version_number":"1.0",
   "last_4":"1365",
   "method_used":"disc",
   "hash_method":"md5",
   "billing_name":"SHONES GEORGE",
   "billing_street_line1":"500 W. Bethany Drive",
   "billing_street_line2":"Suite 200",
   "billing_locality":"Allen",
   "billing_postal_code":"75013",
   "billing_country":"US",
   "billing_email_address":"shone.george@csgi.com",
   "name_on_card":"SHONES GEORGE",
   "expire_month":"02",
   "expire_year":"2023",
   "signature":"bdb29857d36590cac577471fa1b6afa2",
   "utc_time":"637274902251420000",
   "terminal_number":"B48F051032019AA",
   "emvReceiptData":"application_label:Discover Credit|entry_mode:CHIP|CVM:1E0300|AID:A0000001523010|TVR:8000008000|IAD:0105A000034000001E030000000000000000|TSI:6800|ARC:"
}

Sample EMV Receipt

Receipts must contain all the below elements:

Callback Response Field or Description	Receipt Format
Transaction Type	Sale
Your Business Name	CSG Forte
Your Business Address	2121 Providence Drive, STE 151 Fort Worth, TX 76106
Your Business Phone	866-290-5400
The Local Date and Time of the Transaction	9/9/2019 8:10am
Your Forte Merchant ID/Location	Merchant ID: 173185
<terminal_number>	Terminal: B43A775
<method_used>	Card Type: Visa
<authorization_code>, [pg_authorization_code]	Auth Code: 123456
<last_4>	Acct No: *************8569
<total_amount>	Amount: $10.81
<trace_number>, [pg_trace_number]	Transaction ID: 8b0a7b87-09a2-4cb8-a9ea-545881ce80c4
<response_description>, [pg_response_description]	Approved
<emvReceiptData.application_label>, [pg_emv_receipt_data.application_label]	Application: Capital One
<emvReceiptData.entry_mode>, [pg_emv_receipt_data.entry_mode]	Entry Mode: Chip
<emvReceiptData.CVM>, [pg_emv_receipt_data.CVM]	CVM: Sign
<emvReceiptData.AID>, [pg_emv_receipt_data.AID]	AID: A0000000041010
<emvReceiptData.TVR>, [pg_emv_receipt_data.TVR]	TVR: 0000008000
<emvRceiptData.IAD>, [pg_emv_receipt_data.IAD]	IAD: 0110606001220000AAC1000
<emvReceiptData.TSI>, [pg_emv_receipt_data.TSI]	TSI: E800
<emvReceiptData.ARC>, [pg_emv_receipt_data.ARC]	ARC: 01
A Signature Line for the Customer	x___________________________________________________ Signature

For complete instructions, please refer to the eDynamo documentation on Forte’s developer portal:

eDynamo – CSG Forte