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 TypeSale
Your Business NameCSG Forte
Your Business Address2121 Providence Drive, STE 151
Fort Worth, TX 76106
Your Business Phone866-290-5400
The Local Date and Time of the Transaction9/9/2019 8:10am
Your Forte Merchant ID/LocationMerchant 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 Customerx___________________________________________________                                                              Signature



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


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article