# Digital Receipts Test Cases source: https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md This article provides test case data that shows the digital receipt responses you can expect to receive from some example requests sent to the Consumer Clarity API. Tip: The receipt URL provided in these test case responses is an example and doesn't represent an actual receipt. The receipt URL you receive when you run each test case in your testing tool is live and will remain available for 15 minutes, at which time it expires. See [Provide a Digital Receipt](https://developer.mastercard.com/consumer-clarity/documentation/tutorials-and-guides/how-to-use-response-data/displaying-transaction-details/index.md#provide-a-digital-receipt) for more information about digital receipt expiration. Note: The sample images provided show both the new **Modern** receipt, introduced in Q2 2026, and the older **Legacy** version of the receipt. See [New Digital Receipts UI layout](https://developer.mastercard.com/consumer-clarity/documentation/release-history/index.md#august-2026-new-digital-receipts-ui-layout) for more details about the new **Modern** receipt. ## Test Cases {#test-cases} These are the types of test cases provided in this article: #### Transactions using different payment schemes {#transactions-using-different-payment-schemes} * [Mastercard transaction with ARN and issuer authorization code](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc1-mastercard-transaction-with-arn-and-issuer-authorization-code) * [Visa transaction with ARN and issuer authorization code](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc2-visa-transaction-with-arn-and-issuer-authorization-code) * [AMEX transaction](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc6-response-includes-receipt-showing-refund) * [Another AMEX transaction](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc9-response-includes-receipt-for-lodging) #### Merchant details only returned without receipt {#merchant-details-only-returned-without-receipt} * [Request sent without any transaction criteria](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc3-request-without-transaction-criteria) #### Receipts with credits {#receipts-with-credits} * [Line item discount](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc4-response-includes-receipt-showing-line-item-discount) * [Overall discount](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc5-response-contains-receipt-showing-overall-discount) * [Refund](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc6-response-includes-receipt-showing-refund) #### Receipts for different currencies {#receipts-for-different-currencies} * [US Dollar (USD)](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc5-response-contains-receipt-showing-overall-discount) * [Euro (EUR)](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc7-response-includes-receipt-in-euros) * [British pound sterling (GBP)](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc8-response-includes-receipt-in-british-pound-sterling) #### Receipts for different industries {#receipts-for-different-industries} * [Lodging](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc9-response-includes-receipt-for-lodging) * [Air travel](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc10-response-includes-receipt-for-air-travel) * [Clothing](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc11-response-includes-receipt-for-clothing-retailer) #### Receipts for Amazon transactions in different countries {#receipts-for-amazon-transactions-in-different-countries} * [Amazon in Canada](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc12-response-includes-receipt-from-amazon-canada) * [Amazon in the US](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc13-response-includes-receipt-from-amazon-us) * [Amazon in the UK](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc14-response-includes-receipt-from-amazon-uk) #### Receipt returned when transaction not found {#receipt-returned-when-transaction-not-found} * [Transaction not found](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc15-receipt-returned-when-transaction-not-found) #### Lite receipt returned {#lite-receipt-returned} * [Lite receipt returned](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc16-lite-receipt-returned)
This table shows the request fields that are part of each test case and lists the values that are used in each one. | Test Case | cardAcceptor Location | cardAcceptor Name | cardAcceptor RegionCode | cardAcceptor CountryCode | acquirer ReferenceNumber | issuer AuthorizationCode | transaction DateTime | transaction Amount | card FirstSix | card LastFour | payment Type | transaction IdentifierValue/Type | clearingDateTime | clearingAmount | |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------|----------------------|-------------------------|--------------------------|--------------------------|--------------------------|----------------------|--------------------|---------------|---------------|--------------|----------------------------------|------------------|----------------| | [TC1](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc1-mastercard-transaction-with-arn-and-issuer-authorization-code) | PITTSBURGH | ETHOCA NINJA GAMES | PA | US | 20292029202920292029101 | 1B2A3Q | null | null | null | null | MC | null | null | null | | [TC2](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc2-visa-transaction-with-arn-and-issuer-authorization-code) | PITTSBURGH | ETHOCA NINJA GAMES | PA | US | 20292029202920292028001 | 1B2A3T | null | null | null | null | VISA | null | null | null | | [TC3](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc3-request-without-transaction-criteria) | AUSTIN | ETHOCA TICKETS | TX | US | null | null | null | null | null | null | null | null | null | null | | [TC4](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc4-response-includes-receipt-showing-line-item-discount) | PITTSBURGH | ETHOCA NINJA GAMES | PA | US | 20292029202920292029001 | 0A2B3C | null | null | null | null | MC | null | null | null | | [TC5](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc5-response-contains-receipt-showing-overall-discount) | SUNNYVALE | ETHOCA CHAIRS | CA | US | null | 2A2B3C | 2022-10-23 | 361.56/USD | 452316 | 5489 | MC | null | null | null | | [TC6](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc6-response-includes-receipt-showing-refund) | PITTSBURGH | ETHOCA NINJA GAMES | PA | US | null | 6A2B3C | null | null | null | null | AMEX | RCPT2029_6/BANKNET_REF_NUM | null | null | | [TC7](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc7-response-includes-receipt-in-euros) | SUNNYVALE | ETHOCA CHAIRS | CA | US | 20292029202920292029002 | 2A2B3C | 2022-10-23 | 361.56/EUR | 452316 | 5489 | MC | null | null | null | | [TC8](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc8-response-includes-receipt-in-british-pound-sterling) | SUNNYVALE | ETHOCA CHAIRS | CA | US | 20292029202920292029002 | 2A2B3C | 2022-10-23 | 361.56/GBP | 452316 | 5489 | MC | null | null | null | | [TC9](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc9-response-includes-receipt-for-lodging) | MICHIGAN | ETHOCA HOTEL GROUP | IL | US | null | 4A2B3C | null | null | null | null | AMEX | RCPT2029_4/BANKNET_REF_NUM | null | null | | [TC10](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc10-response-includes-receipt-for-air-travel) | HOUSTON | ETHOCA AIR | TX | US | null | null | null | null | 768954 | 7654 | MC | null | null | null | | [TC11](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc11-response-includes-receipt-for-clothing-retailer) | AUSTIN | ETHOCA THREADS | TX | US | 20292029202920292029014 | null | null | null | null | null | MC | null | null | null | | [TC12](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc12-response-includes-receipt-from-amazon-canada) | Toronto | ETHOCA AMAZON CANADA | ON | CAN | 20292029202920292029107 | 1J2A3R | null | null | null | null | VISA | null | null | null | | [TC13](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc13-response-includes-receipt-from-amazon-us) | Seattle | ETHOCA AMAZON US | WA | US | 20292029202920292029109 | 1B2A3W | null | null | null | null | VISA | null | null | null | | [TC14](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc14-response-includes-receipt-from-amazon-uk) | Salisbury | ETHOCA AMAZON UK | null | GBR | 20292029202920292029108 | 1B2A3R | null | null | null | null | VISA | null | null | null | | [TC15](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc15-receipt-returned-when-transaction-not-found) | AUSTIN | ETHOCA THREADS | TX | US | 20292029202920292021234 | null | null | null | null | null | MC | null | null | null | | [TC16](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#tc16-lite-receipt-returned) | AUSTIN | ETHOCA THREADS | TX | US | 20292029202920292029018 | null | null | null | null | null | MC | null | null | null | ### TC1: Mastercard transaction with ARN and issuer authorization code {#tc1-mastercard-transaction-with-arn-and-issuer-authorization-code} In this scenario, the request is sent for a transaction processed with a Mastercard and the `acquirerReferenceNumber` and `issuerAuthorizationCode` are provided. The transaction is found and a digital receipt URL is returned in the response. #### Request {#request} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "acquirerReferenceNumber": "20292029202920292029101", "issuerAuthorizationCode": "1B2A3Q", "paymentType": "MC" }, "merchantCriteria": { "cardAcceptorLocation": "PITTSBURGH", "cardAcceptorName": "ETHOCA NINJA GAMES", "cardAcceptorRegionCode": "PA", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response} ```JSON { "searchResults": [ { "recordId": "0.d01c2117.1697197777.2a1ae675-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Ninja Games", "address": { "line1": "1000 Town center way", "line2": "Suite 210", "city": "Pittsburgh", "postalCode": "15210", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "PA" }, "description": "Gaming platform where kids come to play, share, and imagine", "websiteUrl": "www.ethocaninjagames.com", "merchantCategory": { "code": "7993", "description": "VIDEO AMUSEMENT GAME SUPPLIES" }, "logos": [ { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=400", "type": "INDUSTRY", "altTextTag": "Video and Game Rentals Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Ninja Games Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Ninja Games Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=200", "type": "INDUSTRY", "altTextTag": "Video and Game Rentals Logo" } ], "merchantLocation": { "latitude": "40.4396", "longitude": "-79.9762", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2023-10-14T11:49:38.289+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1697197778/716dca6a-47b4-4a35-9fa1-531f1c6ce1e4/Uf0RxFOK6L_yhIiCSn5ulw/buBS3_ObS-Sb6dHTLm4AOx4ajebBWLUK7ejYci94fv3fUo_pu0pgpB2qBcrKViZc0_GUBqLCzUUqkF68_CEnHCYFYslc6tRujKfCASkUAlqPwh0enxxwyTmsFoUise9a2z5RhnpgC1E_VNBsA5Zf0WXrFRhWJrocAVG4BvHquOv-yxY1rk_GsKh1HZEMibdToq1T6nVchOIm59KUoVks3Wp_1yebLjDyb-iTLspFgbdHIahaxcEgr7cqod3r-leqkuC_v9ZVY5uWPd6bYEXGYgz9lVQZzhoQhG5BH5e_s5LpO7G2C82kbmObTo0oRhgPvW7P2OVCElT1inxKtjYO9ZuG6IoKFV8NxlZS7ewrfQLxUEdMy1YI9DTebbJoWtdB4o0bqgHlUDqB3ux5nmC3-36i1l1R7WfQI1yj3VQ09-W24qmUF3V_OJ-PY-_LfQpHl-QCcFUdoRjaJk19BAkjdqTFuWiggWxfDBCQLulySO5i6IXDBIm9-SylQ6fRTRSqQS0npV67LfUz3O_1dXDamQnoODrv9zLgGC9UCnCkiZXOnTfj8oR3Jt1jaaQqO3GiRYv2-9wJc5yg6fDOrpjCY1hkiQpaNo-M9n532NGu7321-JFcD4Q8BhWhOW9bmNASV46F90IRNVtH1kPleLrkDmgNrW39wSW0rlLB1TGmig4IG162gi8PCujy-x8ozfzjbw5udG43BSecKng39ARgUN38fQmEZxVrGuYkENhM-pVZutNM6JY-Me-9UdVGkRG1NbPkiyfd?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Ik1FbHpvRnQ0Ny00ZTNPQ1JhYW1kdHJBM0N5Zm9PTGFoM29XS0U3TzRBZmciLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZSIsImN0eSI6IkpXUyIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNjk3MTk3NzY4LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNjk3MTk4Njc4LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE2OTcxOTc3NzgsImp0aSI6ImQ3MmI0OWNlODRhMzRkNDU2OGQxODQzZWZkZWFmYjI3IiwiY2lkIjoiTDFReG5KU2hzajd4LXk2c1dSYWJGdkNTOVV1YTFmNTdDcG5OMHZpXzdkMjRjMzFmIn0.xnDNxOtAU-l-T2UAGHCY9DGtnhgVG-_jlcwqcPuTEB6HGg6zy_LSRVA3ExHuXQ7zNilKfD5gP8x5KAZdU0vjgMfD3CKMqtSHo4YDU-5w418TX3YayOkaAYoal3BPciXv9Ja19_pAdruwZC-acUxek8b2M9AdRr5pSl04lzu918bsgIq_3XL3nl3V3HzafKFy75_PCiJYAQEDRv5IU_PARvTH8iNMDCQ8Zgqegc0Q-tzP4iC_TEPqLMzEtZ-5hLfO9PJJNtXkDvm9_5jzUxKTbOvtRtdfJZE4BLUsK4kLOYnkQz-t9SHcn_BY_hLSTxp9pE1fIr8pM17PjLLtN2EjnA", "contentType": "RECEIPT", "expiresOn": "2023-10-13T12:04:38+00:00" } } ] } ``` #### Receipts returned for test case 1 {#receipts-returned-for-test-case-1} ![Digital receipts returned for test case 1](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc1-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC2: Visa transaction with ARN and issuer authorization code {#tc2-visa-transaction-with-arn-and-issuer-authorization-code} For this test case, a request is sent for a Visa transaction and the request includes the `acquirerReferenceNumber` and `issuerAuthorizationCode`. The transaction is found and a digital receipt URL is returned in the response. . #### Request {#request-1} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "acquirerReferenceNumber": "20292029202920292028001", "issuerAuthorizationCode": "1B2A3T", "paymentType": "VISA" }, "merchantCriteria": { "cardAcceptorLocation": "PITTSBURGH", "cardAcceptorName": "ETHOCA NINJA GAMES", "cardAcceptorRegionCode": "PA", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-1} ```JSON { "searchResults": [ { "recordId": "0.d01c2117.1697198104.2a3264ce-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Ninja Games", "address": { "line1": "1000 Town center way", "line2": "Suite 210", "city": "Pittsburgh", "postalCode": "15210", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "PA" }, "description": "Gaming platform where kids come to play, share, and imagine", "websiteUrl": "www.ethocaninjagames.com", "merchantCategory": { "code": "7993", "description": "VIDEO AMUSEMENT GAME SUPPLIES" }, "logos": [ { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=400", "type": "INDUSTRY", "altTextTag": "Video and Game Rentals Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Ninja Games Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Ninja Games Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=200", "type": "INDUSTRY", "altTextTag": "Video and Game Rentals Logo" } ], "merchantLocation": { "latitude": "40.4396", "longitude": "-79.9762", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2023-10-14T11:55:04.939+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1697198104/716dca6a-47b4-4a35-9fa1-531f1c6ce1e4/hnOqIcprkoGqbwqj05bDBQ/QBe0ms0WgunV0NH29wHh648P6IYM-wcrUDZuTCjwqJvisXCJVFOR_Ei2nG7oH-7OPsTA8WNwZ_7hLMl6BqfWuLKau4VuWW6D5J53DX5iHRLQyLyXE4fJ9N69vX6I-3PvPhDvwtHdWdXycS78vqxU9JXR0-2nhFXKTEL840_3uafVOj-fKym8DRb-BRxnSfngbp3WABDmXtHACKeHk7268f1SZH-Ob2M_VEugbMRfAj034dGqhjWGfBrjSDxf2IKsZ41l03GgkIUNpjV1gvJkTiJU6eoHkgSnDfSnQHJrkwOpQnBc2hXQAuydAlZ9bsQVvCgJm_76eQyVjTgpfwzP9yBGL4t3GAkqeLnoANHic9D2jfi6faXs6YuAGfEQp2yQ4ZIYEl-6yRterpNJXCkBlFcirSKarv-IunNGBUIG6yroo_Em4sq8778js3dN56shtCkTAxQ2ATClj4bAYQ-ipfudR-NV1vTNtTkZteSPNsf2ppDaWhPylDVoPp_8qnphfadJhNBjKXz1InnU5Dd-lnE01ntDyYRgPwrD6eP98ptZsEidD1sLtDMqRVT7VKNI6FvPXOaBVXU8E7PAyZI28wdd0iTo3fyuZWx_aW95kPHq5G5YSd_Hc13StQCDzwTpHVulAotrcIF6JpoEKEOd8UfBdOylhO4DO9IctNepyGMytLkcb_eThU-tVljB3FQg8-JWs4HwfGw6eXQWdnfTpJJ5P41qhffNTu8q308ncP09pDbwkqSS5rTFik_9DsJyBUaRK43_6Rw?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Ik1FbHpvRnQ0Ny00ZTNPQ1JhYW1kdHJBM0N5Zm9PTGFoM29XS0U3TzRBZmciLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZSIsImN0eSI6IkpXUyIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNjk3MTk4MDk0LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNjk3MTk5MDA0LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE2OTcxOTgxMDQsImp0aSI6IjUyYjQ0YjkzMzE2NTM3MWU0YjgxMzBlM2Y0MThhYjBmIiwiY2lkIjoiTDFReG5KU2hzajd4LXk2c1dSYWJGdkNTOVV1YTFmNTdDcG5OMHZpXzdkMjRjMzFmIn0.4ItqnRSikzVEyHw-MBwUPNchfFRsyks_-EulLmmc4YPU_CjFtLH-8FSI0ehu1zV64SWoPlPKQwPNl4F_Kunihz2C5TTq6XeFZRPPYBd_AsyJdhHoLCusv1g-X4-RLjIvOZfAxuEonCdxKL-FajQDhL0BCEdSTkYfUUL3L6vgkG_d2MowHCqtahBKmkNzHXNxx-AgJ7mbRAyuaITXLKybK0cPRkvqaC6zr45tTt4nkjsTHbT1awrSUDV6qx3h43HKvBqwb1_A9T1lAsqZj1bo6JSC0-cgZquL7B3mjbGrywc-HmjgbYTt1I_GgJvuaL3Tm1DltI-XcvbpRVAU1fpBvA", "contentType": "RECEIPT", "expiresOn": "2023-10-13T12:10:04+00:00" } } ] } ``` #### Receipts returned for test case 2 {#receipts-returned-for-test-case-2} ![Digital receipts returned for test case 2](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc2-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC3: Request without transaction criteria {#tc3-request-without-transaction-criteria} Here, you see a request that contains no `transactionCriteria`. As a result, the response doesn't include a digital receipt URL but instead returns basic merchant details along with a `RECEIPT_NOT_AVAILABLE` message. #### Request {#request-2} ```JSON { "locale": "en-US", "searchCriteria": [ { "merchantCriteria": { "cardAcceptorLocation": "AUSTIN", "cardAcceptorName": "ETHOCA TICKETS", "cardAcceptorRegionCode": "TX", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-2} ```JSON { "searchResults": [ { "recordId": "0.4e53d117.1757457721.ee7a6d54-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Tickets", "address": { "line1": "1234 Main St", "city": "Austin", "postalCode": "78701", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "TX" }, "description": "Ethoca Tickets is an online portal to find the best tickets for the fine arts, music, sports, and so much more.", "websiteUrl": "https://www.merchant.com", "merchantCategory": { "code": "7922", "description": "THEATRICAL PRODUCERS(EXCL MOTION PIX) TICKET AGENCY" }, "logos": [ { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/b88c39c4-65db-4dd1-bf2f-26dc338da32b.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Tickets Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/b88c39c4-65db-4dd1-bf2f-26dc338da32b.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Tickets Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/1bec2398-980f-43ef-8fe6-9005219ec339.png?size=200", "type": "INDUSTRY", "altTextTag": "T+E Airlines Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/1bec2398-980f-43ef-8fe6-9005219ec339.png?size=400", "type": "INDUSTRY", "altTextTag": "T+E Airlines Logo" } ], "merchantLocation": { "latitude": "30.3004", "longitude": "-97.7522", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2025-09-10T22:42:01.387+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_NOT_AVAILABLE", "message": "Purchase Receipt not available for this merchant." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1757457721/342a1667-6c65-409f-b502-f605a4c81d61/Cm6TFLJMAeBQenq1ezEDgQ/3vm-1bTTPVXjO94CdFMk0nETWhoWBnNOUgEq-uwoX_abX2__rq_TXfbBgvDQDbAiMvUS2hI_OKNHPcsaA67Ou3MbLz70it5_JDJrJh1JrOGsQ_BfvO-m20oeQO_B6Z1Panm82qfLafPzfj2FzpB5GtpFl6rRJNfREOmbPPpEkzY9Hn0qbarOl349E4gg3d4MkjcQpbftl5hMzEvcdeFiP1Sy7oyZeovcmdjm045JjCiJEupgiGYU5Jls0YiwcanZjjyLpGLMmo4JmdpQWrPzzIzGFqp7qDCuM7bHHqmyQ5cJxQVZOlZx1bbhLwMhkNtkSl8r46Dkt_tUtiO-GhUuiHvvvn8DhfGJ07K7w6n6yyR7senrByKyqPnM4vbTcFZobnc9S5Q5kJsNALqU8oYTKrE1HdAAI3bpBBNUZjuAuYLkmzOo0vfMw73mM85LDkA9sgCRpQscgTitZvkJF_2-5AI9tnLdZamEP4f-lnhkmeHwFAhpYkFYw6qVrX4Lt9GmEtudW8-dZRtPgru3zH53KzIY66IITOUWoboLotKlEWQuLYAt1xynekD2cF3KAujwM-rhGHoNo_N9MaluTzjrR6TSvw42fHM3NEOrXoTNGOaIW18wzSj5orcSsZ3SrwKaf-cJ1mAzPZXNyEFh2xnjbGu2d4bMRugwRB3ELvFAObnpf-22Z2_gVBoXqwyeYSvLDl9ztYNPlQtUsLAVsFEQOpSKXzIYntTB4ndPYG56Fps5NpuEr-HKBHP9X7YurkgI_UnA0d6y1RXU_heSVnj9r51mbKN6Cw?locale=en-US&access_token=eyJ4NXQjUzI1NiI6IlhjcFJqTDN2a1N2cVF1Z3N6aXBpejhfdFFzRWg0X28teHhoMDNvT2Y2TlkiLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0xIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoibG95YWx0eS13aWZpLGluc3RhbGxtZW50c2JucGxzZXJ2aWNlLG11bHRpdG9rZW5uZXR3b3JrLGJlbmVmaXRzLWVsaWdpYmlsaXR5LXdlYnNlcnZpY2UsUGVyc29uYWxpemVkTG95YWx0eU9mZmVycyxlbnRlcnByaXNlb2ZmZXJzcGxhdGZvcm1hcGksZW5oYW5jZWQtY3VycmVuY3ktY29udmVyc2lvbi1jYWxjdWxhdG9yLG9wZW4tYmFua2luZy1jb25uZWN0LWFpcyxJc3N1ZXJQcm9kdWN0Q29uZmlndXJhdGlvbixTbWFsbEJ1c2luZXNzRGVjaXNpb25FbmhhbmNlcixMb3lhbHR5Q29ubmVjdElzc3VlcixUcmF2ZWxSZWNvbW1lbmRlckFQSSxSQkQsU2VjdG9ySW5zaWdodHMsYmlsbGVyLW1haW50ZW5hbmNlLEVhc3lTYXZpbmdzU3BlY2lhbHMsUHJpY2VsZXNzU3BlY2lhbHMsYnB4LWJpbGxlci1zZWFyY2gsU2VjdXJlUmVtb3RlQ29tbWVyY2VEcGFSZWcsTWVkaWFNZWFzdXJlbWVudCxwcm9jZXNzaW5nZGlnaXRhbCxwcm9jZXNzaW5nZnJhdWQsTG9jYXRpb25zLERpZ2l0YWxFbmFibGVtZW50QVBJLGFjY291bnRzcmVjZWl2YWJsZWludGVsbGlnZW5jZWFwaSx0ZXN0YW5kbGVhcm5jb3JlYXBpLGNyZWRpdG9yLW1hbmFnZW1lbnQsb3Blbi1iYW5raW5nLWNvbm5lY3QtYXBpLGNyZWRpdG9yLXJldHJpZXZhbC1tdGYsYmlsbGVyLW1haW50ZW5hbmNlLW10ZixicHMtYnBhLXNlcnZpY2UsTWFzdGVyQ2FyZFNlbmQyLjAsQklOVGFibGVSZXNvdXJjZSxJbnN0YWxsbWVudEFQSSxwcm9jZXNzaW5nZGViaXQsTWFzdGVyY29tQ2xhaW1zTWdyLGNyeXB0b2Nvbm5lY3QsTUFXUyxRUlBheUdvLGN1cnJlbmN5Y29udmVyc2lvbmZvcnRyYW5zYWN0aW9uY3VycmVuY3kscHJvY2Vzc2luZ2F1dGhlbnRpY2F0aW9uLDNkc2VjdXJlYXV0aGVudGljYXRpb25jaGFsbGVuZ2VzZXJ2aWNlaXNzdWVyLGJpb21ldHJpY21hbmFnZW1lbnRzZXJ2aWNlLFBheXdpdGhSZXdhcmRzLHRlc3RhbmRsZWFybmV2ZW50Y3JlYXRpb24sQ29uc3VtZXJDb250cm9scyxicHMtc3BhLXNlcnZpY2UsUGF5bWVudEFjY291bnRNYW5hZ2VtZW50QVBJLFRlc3RBUEksYXV0by10cmlkLWFwaSx0cmFjay1zZWFyY2gtc2VydmljZSxDb25zdW1lckNvbnRyb2xzVmlydHVhbENhcmROdW1iZXJzLGlzc3Vlcl9jb25zZW50X21hbmFnZW1lbnQsc21hcnRjb250cmFjdHBsYXRmb3JtLGN1cnJlbmN5Y29udmVyc2lvbmZvcm9yaWdpbmF0aW5naW5zdGl0dXRpb24sTG95YWx0eU9mZmVycyxNYXN0ZXJjYXJkTG95YWx0eUNvbm5lY3RTZXJ2aWNlLFBheW1lbnRBY2NvdW50UmVmZXJlbmNlSW5xdWlyeUFQSSxNZXJjaGFudElkZW50aWZpZXIsY29sbGFib3JhdGlvbixTcGVuZGluZ1B1bHNlLFFrciwzZHNlY3VyZWF1dGhlbnRpY2F0aW9uY2hhbGxlbmdlc2VydmljZWFjcyxiZW5lZml0c19jb250ZW50X2VsaWdpYmlsaXR5X3NlcnZpY2UsTWFzdGVyY2FyZE9OU2VydmljZSxwcm9jZXNzaW5nZGlzcHV0ZSxkb25hdGlvbl9wbGF0Zm9ybSx0cmFjay1kZWNpc2lvbi1zZXJ2aWNlLHByb2Nlc3Npbmdjb3JlLE1hc3RlcmNhcmRSZWJhdGVzU2VydmljZSxJU1NNTWVyY2hhbnRFbnJvbGxtZW50LGNyZWRpdG9yLW1hbmFnZW1lbnQtbXRmLG9uYm9hcmRSaXNrQ2hlY2ssQU1MTmV0LGxveWFsdHktYmVuZWZpdHMsZGlyZWN0LXNlcnZpY2UtYXBpLEJ1bmRsZUVuYWJsZW1lbnQsQ3VycmVuY3lDb252ZXJzaW9uQ2FsY3VsYXRvcixNREVTLFByb21vdGlvbnNEaWdpdGFsRW5hYmxlbWVudCxldGhvY2FfYWxlcnRzX21lcmNoYW50X2FwaSxMb3N0U3RvbGVuLGJlbmVmaXRhbGxvY2F0aW9uLGxpY2Vuc2UtYW5kLWNlcnRpZmljYXRlLXZhbGlkYXRpb24tc2VydmljZSxjYXJib25fY2FsY3VsYXRvcixCaWxsUGF5LG9uZGVjayx0cmFuc2FjdGlvbi1jYXJib24taW1wYWN0LHByb2Nlc3Npbmdjb21ibyxNYXN0ZXJDYXJkUmV0YWlsTG9jYXRpb25JbnNpZ2h0cyx4Yi10YXgtcmVmdW5kLE1hc3RlckNhcmRTZW5kLGV0aG9jYW1lcmNoYW50c2VsZnNlcnZpY2UsSWRlbnRpdHlDaGVja0V4cHJlc3NFbnJvbGxlZENhcmRSYW5nZXMsQmxvY2tjaGFpbixjcmVkaXRhbmFseXRpY3NhcGksYmlvbWV0cmljYXV0aGVudGljYXRpb25zZXJ2aWNlLGxveWFsdHktYWlycG9ydCxwcm9jZXNzaW5nY3JlZGl0LENvbW1lcmNpYWxFdmVudE5vdGlmaWNhdGlvbnMsUGxhY2VzLEV0aG9jYUVucmljaGVkVHJhbnNhY3Rpb25zLGNyZWRpdG9yLXJldHJpZXZhbCxTcGVuZENvbnRyb2xzLFN0cmFpZ2h0VGhyb3VnaFByb2Nlc3NpbmcsbG95YWx0eS1pbnN1cmFuY2UsdHJhbnNhY3Rpb24tbm90aWZpY2F0aW9ucyxyZWZlcmVuY2VzZXJ2aWNlbmd3LEZyYXVkU2NvcmVNZXJjaGFudHMsTG95YWx0eVVzZXJNYW5hZ2VtZW50LEF1ZGllbmNlcyxNREVTVG9rZW5Db25uZWN0LGZsaWdodC1kZWxheS1wYXNzLGNpdHlfa2V5X2V6YWNjZXNzX3NlcnZpY2UscHJvY2Vzc2luZ2F1dGhlbnRpY2F0aW9uYWNzcHJvdmlkZXIsVXNlckNvbnNlbnRBUEkscHJvZHVjdC1pZGVudGlmaWVyLE1hc3RlcmNhcmRSZXdhcmRzU2VydmljZSxiZW5lZml0X2Nvbm5lY3Rfc2VydmljZSxtZXJjaGFudC1tYXRjaC10b29sLWFwaSxwYXlvbmRlbWFuZGZvcmRpZ2l0YWxpbmNsdXNpb24scHJvY2Vzc2luZy1wdixNQVRDSCIsIm5iZiI6MTc1NzQ1NzcxMSwiZ3JhbnRfdHlwZSI6ImNsaWVudF9jcmVkZW50aWFscyIsImV4cCI6MTc1NzQ1ODYyMSwiYXV0aFR5cGUiOiJPQXV0aDIiLCJvbmVfdGltZSI6ImZhbHNlIiwiaWF0IjoxNzU3NDU3NzIxLCJqdGkiOiJiMzBhYzYzYjJmYTE0NDczNTcyNGFlZWYwODVjMDhlYiIsImNpZCI6IkZkenkzLTdGUUZRamxsYWZXTUVFWmZhcm5IYW5WWEp1djdWV2ZXaVNmYjJjMGFlMSJ9.E3_MryEG9Sx9r_vA4eAlWEnTlJBvaxs7_LcAQqiXaJdBU4kRRMnaW0nrKVQyA2fL7qn7bgYS13nq7k3oEv0Uh5_GNy5UIJQRzF9H06zqU6T8sTd71C8yEkjrdQVRQJBJt3oUirue3QP7eh_q_ePgbqYZvE3-qG4YcLUXVndBaqltjf-s3b2xN2c31HWWmdfqMDQen4GRiYPvAkNmDL8gag-aV8C4PBbnyoogQ5VLrW3iWCx1GhhTlTfAu2IPwy575JlyW65yuRocahx1YgAYgaej7zE6wZF86ryHD72ESBL-7GyqRIEu_sbLB_ebFzPP1zhRQmpD_ovKt-8_OqxoiQ", "contentType": "MERCHANT_DETAILS", "expiresOn": "2025-09-09T22:57:01+00:00" } } ] } ``` #### Receipts returned for test case 3 {#receipts-returned-for-test-case-3} ![Digital receipts returned for test case 3](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc3-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC4: Response includes receipt showing line item discount {#tc4-response-includes-receipt-showing-line-item-discount} For this test case, a digital receipt URL is returned that shows a discount was made on one of the items in the purchase. #### Request {#request-3} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "acquirerReferenceNumber": "20292029202920292029001", "issuerAuthorizationCode": "0A2B3C", "paymentType": "MC" }, "merchantCriteria": { "cardAcceptorLocation": "PITTSBURGH", "cardAcceptorName": "ETHOCA NINJA GAMES", "cardAcceptorRegionCode": "PA", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-3} ```JSON { "searchResults": [ { "recordId": "0.d01c2117.1697198768.2a6238db-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Ninja Games", "address": { "line1": "1000 Town center way", "line2": "Suite 210", "city": "Pittsburgh", "postalCode": "15210", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "PA" }, "description": "Gaming platform where kids come to play, share, and imagine", "websiteUrl": "www.ethocaninjagames.com", "merchantCategory": { "code": "7993", "description": "VIDEO AMUSEMENT GAME SUPPLIES" }, "logos": [ { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=400", "type": "INDUSTRY", "altTextTag": "Video and Game Rentals Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Ninja Games Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Ninja Games Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=200", "type": "INDUSTRY", "altTextTag": "Video and Game Rentals Logo" } ], "merchantLocation": { "latitude": "40.4396", "longitude": "-79.9762", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2023-10-14T12:06:08.345+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1697198768/716dca6a-47b4-4a35-9fa1-531f1c6ce1e4/07TbOi0wy7OI2MtS-9zJFg/uTdzlfyrmFUwJTPUA1vPFDEUO8G-_pUUOXoRtPrzO8hMQsFfVx3mPKE9E32Fc51A0ff45twlgIfWhSNHe8vN8CaAXWuTVX0TA6kmvfVuOv0beI1a9aDC1XDonlhHf4l-6eRDjhYF5pdEMrHws2RIC0iOP9JcGrSCc_oSsIuaqQhwfauBdxFf1N-PX_1TgACnw1-WM7kD_0q5_Bxc_4--5srgqgtcmozY9azERPNPDYMGzqzkH4oLa1bYHidby3PCP3dXVZL2PAQesd2Ppf1pZaxiqFexhdgrNWHikhfZVqLPe8tFtLeb-tONa4EUJxO8ymhqFVhXEaDwxyVBfgVOYKBsFV7r70QCEzFBfUlpaRF0TiMAv7U5Qbg4OpwivpevWE-GwGrUQW1ITYzHXxNFhkUIXqoIA5Wg5VHUNlO3xJ3-cV3otpDhY6c1UqWi_iHkZbbAnhkM_W_GvnY0IL9QoLil_3GuiZSuCXJV339csB1O8Rayl4MrT6Crg5w-QmOIO-fOHx5QFesddk8lFcENwLEN34MzHwV7p1ud-0FEGM8ev4DrBz4EOYRztY3SMVPKuMfLXz03px6c_gvyv9wA3Z8pZzyiG5griv005CEiPZ8QDcj34fPBrKLEfesHUo_jMmWgM_jjZEjblnWkvIlM1oXY9fIGyT8epOF5vAjWoV822fft7e-X-DVvbvCJ2990GIwWS7xMnyvf2k3E4SK5RDO24pWmue0n3NiAek7_MVaHBtat80EnYj1OOhYG2Z-0nxrGJzTD?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Ik1FbHpvRnQ0Ny00ZTNPQ1JhYW1kdHJBM0N5Zm9PTGFoM29XS0U3TzRBZmciLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZSIsImN0eSI6IkpXUyIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNjk3MTk4NzU4LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNjk3MTk5NjY4LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE2OTcxOTg3NjgsImp0aSI6IjE3OTkwMzBmZjgxMGQxNDViMDRmNDUyNjZjMjIxYTEzIiwiY2lkIjoiTDFReG5KU2hzajd4LXk2c1dSYWJGdkNTOVV1YTFmNTdDcG5OMHZpXzdkMjRjMzFmIn0.rPndajkxN8UPKKsnJEfX8yUaGieEix-cx5LNdhLqHvW9wt7SRnVu6btoQWPI8i7KN10haT2u0nyioRj85Dpd5pppQvRB8IuEwDVA5BTMB-pycdyo7BjVFpd3qpTxa14wWYIl2cms_1aac2xmHfw7VkWmL_npbWb8d8G14zCSuLy7HNAnar2JTOH7AkrMAvVvrcLyThEIrKDGx1_PGwZL8lhCItY6euMfX55Mj0rgao4LXfWjq2hilV2wu2Ri3gIBKLJF9J-PbPpaai3BPsCLrIyhSBjA_cBlJnwIo08ilFeLvdLueqgYXKmN6tXEoBMbcfjfWm872-y9HJA0EEHsvw", "contentType": "RECEIPT", "expiresOn": "2023-10-13T12:21:08+00:00" } } ] } ``` #### Receipts returned for test case 4 {#receipts-returned-for-test-case-4} ![Digital receipts returned for test case 4](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc4-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC5: Response contains receipt showing overall discount {#tc5-response-contains-receipt-showing-overall-discount} In this scenario, a digital receipt URL is returned that shows a discount was made on the entire purchase. The purchase in this case was made in US dollars. #### Request {#request-4} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "issuerAuthorizationCode": "2A2B3C", "transactionDateTime": "2022-10-23", "transactionAmount": { "value":"361.56", "currencyCode":"USD" }, "cardFirstSix": "452316", "cardLastFour": "5489", "paymentType":"MC" }, "merchantCriteria": { "cardAcceptorLocation": "SUNNYVALE", "cardAcceptorName": "ETHOCA CHAIRS", "cardAcceptorRegionCode": "CA", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-4} ```JSON { "searchResults": [ { "recordId": "0.4e53d117.1758062587.5b146c08-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Chairs", "address": { "line1": "1243 East Riverside", "city": "Sunnyvale", "postalCode": "94089", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "CA" }, "description": "Ethoca Chairs has been in the furniture business for 100 years creating thoughtfully designed chairs, crafted by hand. We sell our chairs online and through our Retail Partners in stores throughout the world.", "websiteUrl": "www.ethocachairs.com", "merchantCategory": { "code": "7641", "description": "FURNITURE-REUPHOLSTERY AND REPAIR REFINISHING" }, "logos": [ { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/8206a2be-b261-4140-8ab4-41a96463c746.png?size=400", "type": "INDUSTRY", "altTextTag": "Miscellaneous Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/8206a2be-b261-4140-8ab4-41a96463c746.png?size=200", "type": "INDUSTRY", "altTextTag": "Miscellaneous Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/49d8f0d2-5eaa-4080-bb1d-7d4b03f247ad.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Chairs Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/49d8f0d2-5eaa-4080-bb1d-7d4b03f247ad.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Chairs Logo" } ], "merchantLocation": { "latitude": "37.3836", "longitude": "-122.0256", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2025-09-17T22:43:07.398+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1758062587/342a1667-6c65-409f-b502-f605a4c81d61/gnispI0O6K5JZ53DNTGLrw/HV-NC9x2VUaRGSa3mNwDvXKzPpxLHds06QwTB_eNW-szZx5Kemm52Y18ftYO-wPS4iEmMrlTOEVhV6Hs1d7pa-5ZRJ9Qa0eHfRuz9PPuhAEpq2zzwfBpg8-aBTO0Zz6VLcbcXkmCo3-RMFKIwcwyFiohAdVnSPRSdIYGTQEerEqbUPm1CpllYIH6rqgK3JGOb4d9kQJzlvjGFEcmuJSEs8OaH78LXFr6Y-o3IFER7AFfmN_QfaKVTxTm1gMyEZpocz6YuAIUwAZYdd0WhBYhXr6Ah1sjOFAka_s3ZkHbPvd1XCdVa2duH_QHok4ouv2OuZ0-sEd4CCkymQSshcjLa47wbCdtA8ijPAC0PGlxWIuBuq4m9R4Camti1ZgPse_1LFQa7EWvXUBMHXFPy6CLso1gfP6AI39gkHm6COMq_oJ93MlcfKdFBhmqnEhXsZW7RFtd7KblLKKxgUBdaH3fRVUOwUP98HKHnORkXqfMOkQ6wwxWD7kfuyrE_KmxhUOrz8ogD0EQggBxCqaqCP7nqjtBIYSDcbF-ZcySsWQuoS3eLVBOZipxZaKGLsRRsnnzsG3kYn-N8QhjOrQkolAeE7oGf98lMJXsknNaSHbsOsctheEPxekVRD3RR-uK7SeSXJpLdSjHBseeOTLHzdtZ-DrrC-xylg8TTYPBCU_gVo2Norq_-Vdyr-YLZ3jUoqHR4IHdPAxu5CV4vIgSXMVePcgh32KcjxOLlpLOPESW-1R2Clzzo5ACPPUR3mdmOUDJSC6FTFeBwhzHrMMGHGymWR0JKVy_Gi3GW9SSbxWZ8mJML6oaduvR-5p4mRO408n0tgpYCZXLPbIzRCeZIUuF8fjo5p6yHETMvbxUf_wH9aqLKgG1xaVSOLO-cJKVO1pBnsNRlrzZ6XQB7oMJMbcJDxMvrHfOOGVhv4o88_eNhpI-7oifhPCw_O-M7h909savAEG3RkuqbGv4Nj7TOqlrxMoC3y5xx6ig5KPvQM8rKW4GwEOvOxDROjKXbByxB77DYZ1OzvXsPTcCyA?locale=en-US&access_token=eyJ4NXQjUzI1NiI6IlhjcFJqTDN2a1N2cVF1Z3N6aXBpejhfdFFzRWg0X28teHhoMDNvT2Y2TlkiLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0xIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoibG95YWx0eS13aWZpLGluc3RhbGxtZW50c2JucGxzZXJ2aWNlLG11bHRpdG9rZW5uZXR3b3JrLGJlbmVmaXRzLWVsaWdpYmlsaXR5LXdlYnNlcnZpY2UsUGVyc29uYWxpemVkTG95YWx0eU9mZmVycyxlbnRlcnByaXNlb2ZmZXJzcGxhdGZvcm1hcGksZW5oYW5jZWQtY3VycmVuY3ktY29udmVyc2lvbi1jYWxjdWxhdG9yLG9wZW4tYmFua2luZy1jb25uZWN0LWFpcyxJc3N1ZXJQcm9kdWN0Q29uZmlndXJhdGlvbixTbWFsbEJ1c2luZXNzRGVjaXNpb25FbmhhbmNlcixMb3lhbHR5Q29ubmVjdElzc3VlcixUcmF2ZWxSZWNvbW1lbmRlckFQSSxSQkQsU2VjdG9ySW5zaWdodHMsYmlsbGVyLW1haW50ZW5hbmNlLEVhc3lTYXZpbmdzU3BlY2lhbHMsUHJpY2VsZXNzU3BlY2lhbHMsYnB4LWJpbGxlci1zZWFyY2gsU2VjdXJlUmVtb3RlQ29tbWVyY2VEcGFSZWcsTWVkaWFNZWFzdXJlbWVudCxwcm9jZXNzaW5nZGlnaXRhbCxwcm9jZXNzaW5nZnJhdWQsTG9jYXRpb25zLERpZ2l0YWxFbmFibGVtZW50QVBJLGFjY291bnRzcmVjZWl2YWJsZWludGVsbGlnZW5jZWFwaSx0ZXN0YW5kbGVhcm5jb3JlYXBpLGNyZWRpdG9yLW1hbmFnZW1lbnQsb3Blbi1iYW5raW5nLWNvbm5lY3QtYXBpLGNyZWRpdG9yLXJldHJpZXZhbC1tdGYsYmlsbGVyLW1haW50ZW5hbmNlLW10ZixicHMtYnBhLXNlcnZpY2UsTWFzdGVyQ2FyZFNlbmQyLjAsQklOVGFibGVSZXNvdXJjZSxJbnN0YWxsbWVudEFQSSxwcm9jZXNzaW5nZGViaXQsTWFzdGVyY29tQ2xhaW1zTWdyLGNyeXB0b2Nvbm5lY3QsTUFXUyxRUlBheUdvLGN1cnJlbmN5Y29udmVyc2lvbmZvcnRyYW5zYWN0aW9uY3VycmVuY3kscHJvY2Vzc2luZ2F1dGhlbnRpY2F0aW9uLDNkc2VjdXJlYXV0aGVudGljYXRpb25jaGFsbGVuZ2VzZXJ2aWNlaXNzdWVyLGJpb21ldHJpY21hbmFnZW1lbnRzZXJ2aWNlLFBheXdpdGhSZXdhcmRzLHRlc3RhbmRsZWFybmV2ZW50Y3JlYXRpb24sQ29uc3VtZXJDb250cm9scyxicHMtc3BhLXNlcnZpY2UsUGF5bWVudEFjY291bnRNYW5hZ2VtZW50QVBJLFRlc3RBUEksYXV0by10cmlkLWFwaSx0cmFjay1zZWFyY2gtc2VydmljZSxDb25zdW1lckNvbnRyb2xzVmlydHVhbENhcmROdW1iZXJzLGlzc3Vlcl9jb25zZW50X21hbmFnZW1lbnQsc21hcnRjb250cmFjdHBsYXRmb3JtLGN1cnJlbmN5Y29udmVyc2lvbmZvcm9yaWdpbmF0aW5naW5zdGl0dXRpb24sTG95YWx0eU9mZmVycyxNYXN0ZXJjYXJkTG95YWx0eUNvbm5lY3RTZXJ2aWNlLFBheW1lbnRBY2NvdW50UmVmZXJlbmNlSW5xdWlyeUFQSSxNZXJjaGFudElkZW50aWZpZXIsY29sbGFib3JhdGlvbixTcGVuZGluZ1B1bHNlLFFrciwzZHNlY3VyZWF1dGhlbnRpY2F0aW9uY2hhbGxlbmdlc2VydmljZWFjcyxiZW5lZml0c19jb250ZW50X2VsaWdpYmlsaXR5X3NlcnZpY2UsTWFzdGVyY2FyZE9OU2VydmljZSxwcm9jZXNzaW5nZGlzcHV0ZSxkb25hdGlvbl9wbGF0Zm9ybSx0cmFjay1kZWNpc2lvbi1zZXJ2aWNlLHByb2Nlc3Npbmdjb3JlLE1hc3RlcmNhcmRSZWJhdGVzU2VydmljZSxJU1NNTWVyY2hhbnRFbnJvbGxtZW50LGNyZWRpdG9yLW1hbmFnZW1lbnQtbXRmLG9uYm9hcmRSaXNrQ2hlY2ssQU1MTmV0LGxveWFsdHktYmVuZWZpdHMsZGlyZWN0LXNlcnZpY2UtYXBpLEJ1bmRsZUVuYWJsZW1lbnQsQ3VycmVuY3lDb252ZXJzaW9uQ2FsY3VsYXRvcixNREVTLFByb21vdGlvbnNEaWdpdGFsRW5hYmxlbWVudCxldGhvY2FfYWxlcnRzX21lcmNoYW50X2FwaSxMb3N0U3RvbGVuLGJlbmVmaXRhbGxvY2F0aW9uLGxpY2Vuc2UtYW5kLWNlcnRpZmljYXRlLXZhbGlkYXRpb24tc2VydmljZSxjYXJib25fY2FsY3VsYXRvcixCaWxsUGF5LG9uZGVjayx0cmFuc2FjdGlvbi1jYXJib24taW1wYWN0LHByb2Nlc3Npbmdjb21ibyxNYXN0ZXJDYXJkUmV0YWlsTG9jYXRpb25JbnNpZ2h0cyx4Yi10YXgtcmVmdW5kLE1hc3RlckNhcmRTZW5kLGV0aG9jYW1lcmNoYW50c2VsZnNlcnZpY2UsSWRlbnRpdHlDaGVja0V4cHJlc3NFbnJvbGxlZENhcmRSYW5nZXMsQmxvY2tjaGFpbixjcmVkaXRhbmFseXRpY3NhcGksYmlvbWV0cmljYXV0aGVudGljYXRpb25zZXJ2aWNlLGxveWFsdHktYWlycG9ydCxwcm9jZXNzaW5nY3JlZGl0LENvbW1lcmNpYWxFdmVudE5vdGlmaWNhdGlvbnMsUGxhY2VzLEV0aG9jYUVucmljaGVkVHJhbnNhY3Rpb25zLGNyZWRpdG9yLXJldHJpZXZhbCxTcGVuZENvbnRyb2xzLFN0cmFpZ2h0VGhyb3VnaFByb2Nlc3NpbmcsbG95YWx0eS1pbnN1cmFuY2UsdHJhbnNhY3Rpb24tbm90aWZpY2F0aW9ucyxyZWZlcmVuY2VzZXJ2aWNlbmd3LEZyYXVkU2NvcmVNZXJjaGFudHMsTG95YWx0eVVzZXJNYW5hZ2VtZW50LEF1ZGllbmNlcyxNREVTVG9rZW5Db25uZWN0LGZsaWdodC1kZWxheS1wYXNzLGNpdHlfa2V5X2V6YWNjZXNzX3NlcnZpY2UscHJvY2Vzc2luZ2F1dGhlbnRpY2F0aW9uYWNzcHJvdmlkZXIsVXNlckNvbnNlbnRBUEkscHJvZHVjdC1pZGVudGlmaWVyLE1hc3RlcmNhcmRSZXdhcmRzU2VydmljZSxiZW5lZml0X2Nvbm5lY3Rfc2VydmljZSxtZXJjaGFudC1tYXRjaC10b29sLWFwaSxwYXlvbmRlbWFuZGZvcmRpZ2l0YWxpbmNsdXNpb24scHJvY2Vzc2luZy1wdixNQVRDSCIsIm5iZiI6MTc1ODA2MjU3NywiZ3JhbnRfdHlwZSI6ImNsaWVudF9jcmVkZW50aWFscyIsImV4cCI6MTc1ODA2MzQ4NywiYXV0aFR5cGUiOiJPQXV0aDIiLCJvbmVfdGltZSI6ImZhbHNlIiwiaWF0IjoxNzU4MDYyNTg3LCJqdGkiOiJkYzVkN2I4ZTJjMWNiNjRiYzUyMzI3NGUyYTQ0ZDI3OCIsImNpZCI6IkZkenkzLTdGUUZRamxsYWZXTUVFWmZhcm5IYW5WWEp1djdWV2ZXaVNmYjJjMGFlMSJ9.DrxWQDW8-c6BCwGJBQVuVkOLGUa0SqT8ooI5CAEmxIxOtS34Ubbzf7Mzv8rxGXMoFW3lRV_bO-ejJr9pS8tEIVQr0wxEwqdqo35MqNRxlrOUDhqKD9_tInlWr5D44t_oOd0-008qTka3LiwxjgHVWikTpDCTuHDUWAzF-VjNvCZJxvmCP8cQOWwmGs_UKWM7_4BXF8dpkOqigHHSNYYHdpq9SS5IDRo2Mt5nQHhXcPmaDJSPR2klE36UVrnDHpAFrT1b2wLq97GIuGKFtcjQ_PLTdNOhjE05y66mBrIWrA6TTqwkrwl3Ev-0iTLJtAcTrWcyDJznBgSRQQM3QZVWlw", "contentType": "RECEIPT", "expiresOn": "2025-09-16T22:58:07+00:00" }, "carbonFootprint": { "carbonEmissionInGrams": 61507.25, "carbonEmissionInOunces": 2169.61, "category": { "mainCategory": "Furniture & Decoration", "subCategory": " Furniture & Home Furnishings", "sector": "Equipment", "sectorCode": "702" } } } ] } ``` #### Receipts returned for test case 5 {#receipts-returned-for-test-case-5} ![Digital receipts returned for test case 5](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc5-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC6: Response includes receipt showing refund {#tc6-response-includes-receipt-showing-refund} In this scenario, a digital receipt URL is returned in the response and indicates a refund was made of the entire purchase. #### Request {#request-5} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "transactionIdentifierValue": "RCPT2029_6", "issuerAuthorizationCode": "6A2B3C", "paymentType": "AMEX", "transactionIdentifierType": "BANKNET_REF_NUM" }, "merchantCriteria": { "cardAcceptorLocation": "PITTSBURGH", "cardAcceptorName": "ETHOCA NINJA GAMES", "cardAcceptorRegionCode": "PA", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-5} ```JSON { "searchResults": [ { "recordId": "0.d01c2117.1697199070.2a77613f-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Ninja Games", "address": { "line1": "1000 Town center way", "line2": "Suite 210", "city": "Pittsburgh", "postalCode": "15210", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "PA" }, "description": "Gaming platform where kids come to play, share, and imagine", "websiteUrl": "www.ethocaninjagames.com", "merchantCategory": { "code": "7993", "description": "VIDEO AMUSEMENT GAME SUPPLIES" }, "logos": [ { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=400", "type": "INDUSTRY", "altTextTag": "Video and Game Rentals Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Ninja Games Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Ninja Games Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=200", "type": "INDUSTRY", "altTextTag": "Video and Game Rentals Logo" } ], "merchantLocation": { "latitude": "40.4396", "longitude": "-79.9762", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2023-10-14T12:11:11.060+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1697199071/716dca6a-47b4-4a35-9fa1-531f1c6ce1e4/vijRrB-j1iTxBrV6IwiLdQ/uacSPTGu08REpYrg0NegGDqqAEATeKgQfIzXGJRtcWRpTU7ejOHiUWnkcSaxVAyrXfaD8DdH7KnUyipHS6LvGP1pw4ef_B6YKi8Nahhb8otmWWP7_XDwiGK7zlLuqh4a8EjdChjKPUzSF4qxB9fhZFnWxU-8fMklc-9SznicNMpT6kmxSlFj0b5BahbRyt4pVlWqwWzKuy_a3Zev99EBnYBMH7h6cUPM9aSCLdbMoWiXzevRlPf_Ow8K8yARobK9mClYyzzhGh2cckShOm8dBUyS5Fmz-5fA0sce2TVLMYSGh4_LSADOiACBfLlsw8C4uB5O1O4AQBJgDGnkAGMP2m197VMwHRRgSKDFQW9dR7jtFj3UCT0niz8B8WtbP9zWBQ-9ZUO7SHAjkMBWIGSNwLY7-efU7hosbCqAc3c9hhQSaOhqkAcefeMC9XAUxIuxYMPJLQ_tBWJXG-TW9tULy507guoS_w3wzS1BfwNggyndZC1EWwXnCZWPfSAiwFVQipx5g1kf_G_Gw7X2smtPW6qZbblK5aOQDiBgCDb105e2A_XZ2GZVJ5kOds_P7BfTp250B_FLUYORdcztdBYjirKXluJthLxE73Vk1Cej_YoFK0G3RUTqD3NpzcJcF0uR5F-uGUsjXlhC-0-p7DwwLhn8mjmjvMQLmOmwcgPWD9S-btIunRSoDnGJpdXwGFpYyG8aqD_lqmWv1kKBEgDqNmNoqGhFp75qCSx0UQPeI1-6YUkdNvShB3EHnmySsVqu3nBRNLt5jL8OXJSIdhbg1fDL8MhLDenZ4E8HoeDrr9gsHV41ZZxv8bXHZqc?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Ik1FbHpvRnQ0Ny00ZTNPQ1JhYW1kdHJBM0N5Zm9PTGFoM29XS0U3TzRBZmciLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZSIsImN0eSI6IkpXUyIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNjk3MTk5MDYxLCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNjk3MTk5OTcxLCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE2OTcxOTkwNzEsImp0aSI6ImY1OGFjZGVhODhkMTU3MjFmNDZlNmZiMjQ4NDkwODMxIiwiY2lkIjoiTDFReG5KU2hzajd4LXk2c1dSYWJGdkNTOVV1YTFmNTdDcG5OMHZpXzdkMjRjMzFmIn0.prvfjmVp_IWNtRrO1YkKcUonhDRvtsCsdswugo1a-M_sCfVubSScepRg3NJi4IA8X3zRhjJ2zhx7I5qSsQBER8EWkiOvPh1AZgO_8tFj3_ljxxGNlEKVWZFGpHHPkAIRFDA6BN_M1PpVMyS93AG1GglND9VR5aR09csNYxbGSzC2IGY3bR8HLBVpbYF5C7Jjk0I3gakWvAC-7ISm51swjxhiSAjCwHNFFVHGsoX3DGcAd4V5-hpMGuqtnkwUulEZZIrVB9qxE_MSAlJUT9O8ZO9v8xoh1NtlwAMybHtkjcRehYekBX9K1pxSDvme2t4KMi4poEoaOMgXxjR0ST0UtQ", "contentType": "RECEIPT", "expiresOn": "2023-10-13T12:26:11+00:00" } } ] } ``` #### Receipts returned for test case 6 {#receipts-returned-for-test-case-6} ![Digital receipts returned for test case 6](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc6-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC7: Response includes receipt in Euros {#tc7-response-includes-receipt-in-euros} Here, you see the request indicates the transaction was made in Euros. A digital receipt is found that matches the `transactionCriteria` and a URL is returned in the response. #### Request {#request-6} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "acquirerReferenceNumber":"20292029202920292029002", "issuerAuthorizationCode": "2A2B3C", "transactionDateTime": "2022-10-23", "transactionAmount": { "value": "361.56", "currencyCode": "EUR" }, "cardFirstSix": "452316", "cardLastFour": "5489", "paymentType": "MC" }, "merchantCriteria": { "cardAcceptorLocation": "SUNNYVALE", "cardAcceptorName": "ETHOCA CHAIRS", "cardAcceptorRegionCode": "CA", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-6} ```JSON { "searchResults": [ { "resultStatus": { "code": "OK", "message": "OK." }, "recordId": "0.d01c2117.1697199299.2a802754-01", "merchantResult": { "merchantName": "Ethoca Chairs", "address": { "line1": "1243 East Riverside", "city": "Sunnyvale", "postalCode": "94089", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "CA" }, "description": "Ethoca Chairs has been in the furniture business for 100 years creating thoughtfully designed chairs, crafted by hand. We sell our chairs online and through our Retail Partners in stores throughout the world.", "websiteUrl": "www.ethocachairs.com", "merchantCategory": { "code": "7641", "description": "FURNITURE-REUPHOLSTERY AND REPAIR REFINISHING" }, "logos": [ { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/49d8f0d2-5eaa-4080-bb1d-7d4b03f247ad.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Chairs Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/49d8f0d2-5eaa-4080-bb1d-7d4b03f247ad.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Chairs Logo" } ], "merchantLocation": { "latitude": "37.3836", "longitude": "-122.0256", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2023-10-14T12:14:59.711+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1697199299/716dca6a-47b4-4a35-9fa1-531f1c6ce1e4/k_8_jw9wfLEa-_IRH-hDgw/jEao7IrZHwzo2NL-gJxq8X8FfwIl-fCGkw33SnNEwOOhZ81I7g1u8eJvfGctY4FLUNXn82CDDSloL0SadMa-ODYHxN_ybsGuPl45074phEMIu7wBsd7TDR6G54u1G00C0Mdt7Dsj4Xx0k4R1hKOv8XKv9nqUcxvv5RCTuOGcXndHS9JwQRW_gglVgAkCSGME-f6Mq1y1nIMGy4fzwQjzM4BhnKoqzT2en0hAYU-yt9NJ0tYC_ftm_YzKtLpIomzQ5vvV73Z_vPNfA04t7rz74p_6_2Jf-MWIoQNfiS2MMVSpfc2xHbjEdGXUlxZyzostKDd1lEwc2aqGxMm0vzKgLsZRMCgBa3mqln5FGm-0t7jT9_Vt0cTSKT2mIus3rJLplO-AlJ-SEXbGfG35JFix7gJ7CrdWlWgw03V-IzJULIq-SWB2lNioVW3xMGdb10q4Czah6Uft9QX1Gm3Z8RA2Vs5Uv6NRhI4Mu4egaMg9ZPqqWqQMdur9nLYLyeGRi9yCZ3qHpgbjF1Dl7L39VzdH8wVCiKHd2Bl7K1eUEocDIQ1UyUqtmCvuEFRa1DvHEeh8T-aDIYach7nlEn6ahu48shQZgfDzP7VEZvJ8nGT0OmYJvFIECAtlyGJ2yzFXBbo3EwXjdV4uZNW5n0qgiVnNCJNDOoPe3ggFQeoS86Dp5rS2Y5_KQ-C65eCS5YQHJ8owTfMt3pNvJ7A9msnExekMcPKL9q_8unlEIKUCssXMH1gE6o5WBwoUY7UDlbQ12-uLIFKoe7NK03YjtsFpmyYFFjegGd440QqrjWOQgn5EdeGNMLEVNVYkHuIY5-TDuDrHdFSkZ-XrZp684v8CpejUKaPUXJI0c-IWSA2-z7NHgPk7lf_FYUUNbRmmpAGBPiUENU6H5BAjOEqNcN8pxddT0YlQ-Yudk6ojvrKh64puonnHze5ovSTCLyjHab8?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Ik1FbHpvRnQ0Ny00ZTNPQ1JhYW1kdHJBM0N5Zm9PTGFoM29XS0U3TzRBZmciLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZSIsImN0eSI6IkpXUyIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNjk3MTk5Mjg5LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNjk3MjAwMTk5LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE2OTcxOTkyOTksImp0aSI6ImRkYjllYzg3NzBkMjgyMzg2Y2Y5MzE5N2E4ZmUwNWUwIiwiY2lkIjoiTDFReG5KU2hzajd4LXk2c1dSYWJGdkNTOVV1YTFmNTdDcG5OMHZpXzdkMjRjMzFmIn0.jgO-gicfsgaM8pS_h4J86NGP7G5_ehlFD1n5MhfDZS9aAt9h2lEViiNT6nqLSbln0oYgcMGE4jqLytGk2KrN5uoj1vUP6BYy5jf-JdJm-bF0coCqnDud4HaWAuVSDTbmTRahCLi5nCrFkm8ZeBRMUmYkf3I3kaEluwoftyeyFwF_pgURocStmAUhqfxPzjfYtkmERO4NeR1kI-wDlMiApmVM62yZYWCksGcmbTekU7iGJO5v0-Ft9baRp6Mi0ECCyGpeVuWdPfty9Xdu0YmnW0MXVbi4fEJZqQMBGl0FK3asAmIK9xu24OlDiTd4wtO5ema23dbHO6Osx7r7g3r72A", "contentType": "RECEIPT", "expiresOn": "2023-10-13T12:29:59+00:00" } } ] } ``` #### Receipts returned for test case 7 {#receipts-returned-for-test-case-7} ![Digital receipts returned for test case 7](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc7-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC8: Response includes receipt in British pound sterling {#tc8-response-includes-receipt-in-british-pound-sterling} For this test case, a request is sent for a transaction made in British pound sterling. A digital receipt is found that matches the `transactionCriteria` and a URL is returned in the response. #### Request {#request-7} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "acquirerReferenceNumber":"20292029202920292029002", "issuerAuthorizationCode": "2A2B3C", "transactionDateTime": "2022-10-23", "transactionAmount": { "value": "361.56", "currencyCode": "GBP" }, "cardFirstSix": "452316", "cardLastFour": "5489", "paymentType": "MC" }, "merchantCriteria": { "cardAcceptorLocation": "SUNNYVALE", "cardAcceptorName": "ETHOCA CHAIRS", "cardAcceptorRegionCode": "CA", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-7} ```JSON { "searchResults": [ { "recordId": "0.4e53d117.1758062952.5b15de97-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Chairs", "address": { "line1": "1243 East Riverside", "city": "Sunnyvale", "postalCode": "94089", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "CA" }, "description": "Ethoca Chairs has been in the furniture business for 100 years creating thoughtfully designed chairs, crafted by hand. We sell our chairs online and through our Retail Partners in stores throughout the world.", "websiteUrl": "www.ethocachairs.com", "merchantCategory": { "code": "7641", "description": "FURNITURE-REUPHOLSTERY AND REPAIR REFINISHING" }, "logos": [ { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/8206a2be-b261-4140-8ab4-41a96463c746.png?size=400", "type": "INDUSTRY", "altTextTag": "Miscellaneous Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/8206a2be-b261-4140-8ab4-41a96463c746.png?size=200", "type": "INDUSTRY", "altTextTag": "Miscellaneous Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/49d8f0d2-5eaa-4080-bb1d-7d4b03f247ad.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Chairs Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/49d8f0d2-5eaa-4080-bb1d-7d4b03f247ad.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Chairs Logo" } ], "merchantLocation": { "latitude": "37.3836", "longitude": "-122.0256", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2025-09-17T22:49:13.023+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1758062953/342a1667-6c65-409f-b502-f605a4c81d61/Swqlo1C4K9iiTDam8hHshw/acg1z34RbahSfou6kXiUUn6Ys7b3o__gYaygKabMo_BI-uugsoPX4mDiTM0276m4od7b1Sy6xdhNhRJymWWM9_96PF9iCTkQuS_Ws3IghBJDJ7vH1BvE5WPxP9T1fJPOW4ERawpU54_f2NpzTslmxBAECX3szP8ZqAujENwHKRn4JJ9MIyEyEu6ysZu-oa8v2DL68uZNKf8ReOQTJ_T44tc_TNiRXgr6ADt4eAkO9P9oshRUQ9Lj9aWyo0pEGOOBRtvBi2D1cLIWhuJL6tilq_PK_OTxEybQ1Bcl62bv7pKrLCavhJ9YRPTd1GzJb7mqxIrFsysFNorjUZKFfaNZNY3IOrikuuEN31pPWDJ3SPZ6EdjY0Hxb-eaL-ve8pc-EB5mcExhjpOzpQzK61drWU3D_r-9MnaKxepAHseXJlSgOHXl0P1jsdKjXSD08QyAbbjSMSi5FSX9yTf8K15aOVIoW1zclp2uhSazx5WqP_HhMtHSWWMsnRAK6ccyKBWkoVYeD9lF4G3eRQR6gHIWsY8A8ncn5lwhRqixeD2zSBvpJKP4hJPoJg-Mc0AmjYn7R-DjVHbRHnteDYOoVas5MrVOWwBXNF71iITI8uFuX6yi7sJwgtVXiEQHyo7YS8ljl-FTyJvbeQkdcEp2vWm0EAoUfYfx5b5znhDDkgL1-ePPScMc-jXsA71p0MXDPECFDfr6CGJR6daNIITL1aU9yTw_qEIImaAW-7b6NwUgohUONDjxCCUW30Fp0ElkwbnaeWzXNtoLaGtUIndQtTZflc_LZjkK634JYj1rO_mh4-N7gA-rlOuPyGU--HE8nvPzwsy_2cjhoPD-z9AJjPEsWpuU2uO3x-u5yT3ejF18qsOffuRM-5Dib7VePItk5YKskst5eQLF49FiXIP26a8D1tbaphhjuKW-o4iL-8CeYV9-Im_881J79CAuvTgN0PPAr1itrrUzfB-y2oikuq8rBHE-N9ZpTvmmWo6ovcmuY_pQ9KSYCMxi67jqeK4glEgVNScSFX5193ILii38I2wep3_5QCUGPcsdIVBlKEdRFDClPDAfICz48G391H2tCXv85FC1HTLPyfGm8wYz216Q?locale=en-US&access_token=eyJ4NXQjUzI1NiI6IlhjcFJqTDN2a1N2cVF1Z3N6aXBpejhfdFFzRWg0X28teHhoMDNvT2Y2TlkiLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0xIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoibG95YWx0eS13aWZpLGluc3RhbGxtZW50c2JucGxzZXJ2aWNlLG11bHRpdG9rZW5uZXR3b3JrLGJlbmVmaXRzLWVsaWdpYmlsaXR5LXdlYnNlcnZpY2UsUGVyc29uYWxpemVkTG95YWx0eU9mZmVycyxlbnRlcnByaXNlb2ZmZXJzcGxhdGZvcm1hcGksZW5oYW5jZWQtY3VycmVuY3ktY29udmVyc2lvbi1jYWxjdWxhdG9yLG9wZW4tYmFua2luZy1jb25uZWN0LWFpcyxJc3N1ZXJQcm9kdWN0Q29uZmlndXJhdGlvbixTbWFsbEJ1c2luZXNzRGVjaXNpb25FbmhhbmNlcixMb3lhbHR5Q29ubmVjdElzc3VlcixUcmF2ZWxSZWNvbW1lbmRlckFQSSxSQkQsU2VjdG9ySW5zaWdodHMsYmlsbGVyLW1haW50ZW5hbmNlLEVhc3lTYXZpbmdzU3BlY2lhbHMsUHJpY2VsZXNzU3BlY2lhbHMsYnB4LWJpbGxlci1zZWFyY2gsU2VjdXJlUmVtb3RlQ29tbWVyY2VEcGFSZWcsTWVkaWFNZWFzdXJlbWVudCxwcm9jZXNzaW5nZGlnaXRhbCxwcm9jZXNzaW5nZnJhdWQsTG9jYXRpb25zLERpZ2l0YWxFbmFibGVtZW50QVBJLGFjY291bnRzcmVjZWl2YWJsZWludGVsbGlnZW5jZWFwaSx0ZXN0YW5kbGVhcm5jb3JlYXBpLGNyZWRpdG9yLW1hbmFnZW1lbnQsb3Blbi1iYW5raW5nLWNvbm5lY3QtYXBpLGNyZWRpdG9yLXJldHJpZXZhbC1tdGYsYmlsbGVyLW1haW50ZW5hbmNlLW10ZixicHMtYnBhLXNlcnZpY2UsTWFzdGVyQ2FyZFNlbmQyLjAsQklOVGFibGVSZXNvdXJjZSxJbnN0YWxsbWVudEFQSSxwcm9jZXNzaW5nZGViaXQsTWFzdGVyY29tQ2xhaW1zTWdyLGNyeXB0b2Nvbm5lY3QsTUFXUyxRUlBheUdvLGN1cnJlbmN5Y29udmVyc2lvbmZvcnRyYW5zYWN0aW9uY3VycmVuY3kscHJvY2Vzc2luZ2F1dGhlbnRpY2F0aW9uLDNkc2VjdXJlYXV0aGVudGljYXRpb25jaGFsbGVuZ2VzZXJ2aWNlaXNzdWVyLGJpb21ldHJpY21hbmFnZW1lbnRzZXJ2aWNlLFBheXdpdGhSZXdhcmRzLHRlc3RhbmRsZWFybmV2ZW50Y3JlYXRpb24sQ29uc3VtZXJDb250cm9scyxicHMtc3BhLXNlcnZpY2UsUGF5bWVudEFjY291bnRNYW5hZ2VtZW50QVBJLFRlc3RBUEksYXV0by10cmlkLWFwaSx0cmFjay1zZWFyY2gtc2VydmljZSxDb25zdW1lckNvbnRyb2xzVmlydHVhbENhcmROdW1iZXJzLGlzc3Vlcl9jb25zZW50X21hbmFnZW1lbnQsc21hcnRjb250cmFjdHBsYXRmb3JtLGN1cnJlbmN5Y29udmVyc2lvbmZvcm9yaWdpbmF0aW5naW5zdGl0dXRpb24sTG95YWx0eU9mZmVycyxNYXN0ZXJjYXJkTG95YWx0eUNvbm5lY3RTZXJ2aWNlLFBheW1lbnRBY2NvdW50UmVmZXJlbmNlSW5xdWlyeUFQSSxNZXJjaGFudElkZW50aWZpZXIsY29sbGFib3JhdGlvbixTcGVuZGluZ1B1bHNlLFFrciwzZHNlY3VyZWF1dGhlbnRpY2F0aW9uY2hhbGxlbmdlc2VydmljZWFjcyxiZW5lZml0c19jb250ZW50X2VsaWdpYmlsaXR5X3NlcnZpY2UsTWFzdGVyY2FyZE9OU2VydmljZSxwcm9jZXNzaW5nZGlzcHV0ZSxkb25hdGlvbl9wbGF0Zm9ybSx0cmFjay1kZWNpc2lvbi1zZXJ2aWNlLHByb2Nlc3Npbmdjb3JlLE1hc3RlcmNhcmRSZWJhdGVzU2VydmljZSxJU1NNTWVyY2hhbnRFbnJvbGxtZW50LGNyZWRpdG9yLW1hbmFnZW1lbnQtbXRmLG9uYm9hcmRSaXNrQ2hlY2ssQU1MTmV0LGxveWFsdHktYmVuZWZpdHMsZGlyZWN0LXNlcnZpY2UtYXBpLEJ1bmRsZUVuYWJsZW1lbnQsQ3VycmVuY3lDb252ZXJzaW9uQ2FsY3VsYXRvcixNREVTLFByb21vdGlvbnNEaWdpdGFsRW5hYmxlbWVudCxldGhvY2FfYWxlcnRzX21lcmNoYW50X2FwaSxMb3N0U3RvbGVuLGJlbmVmaXRhbGxvY2F0aW9uLGxpY2Vuc2UtYW5kLWNlcnRpZmljYXRlLXZhbGlkYXRpb24tc2VydmljZSxjYXJib25fY2FsY3VsYXRvcixCaWxsUGF5LG9uZGVjayx0cmFuc2FjdGlvbi1jYXJib24taW1wYWN0LHByb2Nlc3Npbmdjb21ibyxNYXN0ZXJDYXJkUmV0YWlsTG9jYXRpb25JbnNpZ2h0cyx4Yi10YXgtcmVmdW5kLE1hc3RlckNhcmRTZW5kLGV0aG9jYW1lcmNoYW50c2VsZnNlcnZpY2UsSWRlbnRpdHlDaGVja0V4cHJlc3NFbnJvbGxlZENhcmRSYW5nZXMsQmxvY2tjaGFpbixjcmVkaXRhbmFseXRpY3NhcGksYmlvbWV0cmljYXV0aGVudGljYXRpb25zZXJ2aWNlLGxveWFsdHktYWlycG9ydCxwcm9jZXNzaW5nY3JlZGl0LENvbW1lcmNpYWxFdmVudE5vdGlmaWNhdGlvbnMsUGxhY2VzLEV0aG9jYUVucmljaGVkVHJhbnNhY3Rpb25zLGNyZWRpdG9yLXJldHJpZXZhbCxTcGVuZENvbnRyb2xzLFN0cmFpZ2h0VGhyb3VnaFByb2Nlc3NpbmcsbG95YWx0eS1pbnN1cmFuY2UsdHJhbnNhY3Rpb24tbm90aWZpY2F0aW9ucyxyZWZlcmVuY2VzZXJ2aWNlbmd3LEZyYXVkU2NvcmVNZXJjaGFudHMsTG95YWx0eVVzZXJNYW5hZ2VtZW50LEF1ZGllbmNlcyxNREVTVG9rZW5Db25uZWN0LGZsaWdodC1kZWxheS1wYXNzLGNpdHlfa2V5X2V6YWNjZXNzX3NlcnZpY2UscHJvY2Vzc2luZ2F1dGhlbnRpY2F0aW9uYWNzcHJvdmlkZXIsVXNlckNvbnNlbnRBUEkscHJvZHVjdC1pZGVudGlmaWVyLE1hc3RlcmNhcmRSZXdhcmRzU2VydmljZSxiZW5lZml0X2Nvbm5lY3Rfc2VydmljZSxtZXJjaGFudC1tYXRjaC10b29sLWFwaSxwYXlvbmRlbWFuZGZvcmRpZ2l0YWxpbmNsdXNpb24scHJvY2Vzc2luZy1wdixNQVRDSCIsIm5iZiI6MTc1ODA2Mjk0MiwiZ3JhbnRfdHlwZSI6ImNsaWVudF9jcmVkZW50aWFscyIsImV4cCI6MTc1ODA2Mzg1MiwiYXV0aFR5cGUiOiJPQXV0aDIiLCJvbmVfdGltZSI6ImZhbHNlIiwiaWF0IjoxNzU4MDYyOTUyLCJqdGkiOiI2M2FkNjEzNmJiNTI3ZTk0YTQ3OGYzY2U5NmQ0NDk0ZSIsImNpZCI6IkZkenkzLTdGUUZRamxsYWZXTUVFWmZhcm5IYW5WWEp1djdWV2ZXaVNmYjJjMGFlMSJ9.hhcFrHWG968xISz_B1jT2_ACQUeyJ0kIWHXVUaaq1yVEi8rtl1BSmPl1t06NgTdt5HmVKYhdphBGA-MJnMgDjfks1ySvAFAeZONjadd3cWybBBaWkUMVMbv7gf-ASo2sptnijPI8EuR2r3mZuZLER-qQ6oyUkxXrlKU9XjGhJg2016YbY-XWUWKXujM7fbXSyoCnaHtzYRFgw5LLfa1LCcW2VN-9ib14xozv-bvTGJPE-EaSinTc7b_RwGds_3NCAJlVWMghXsJe5GL06VYUTlfAhMtKJlK7Q3fozqo38jMIWYeyME_KV2XLW1q2q_rXRud6hBihc_t6SWQpcs6hTw", "contentType": "RECEIPT", "expiresOn": "2025-09-16T23:04:13+00:00" }, "carbonFootprint": { "carbonEmissionInGrams": 80859.83, "carbonEmissionInOunces": 2852.25, "category": { "mainCategory": "Furniture & Decoration", "subCategory": " Furniture & Home Furnishings", "sector": "Equipment", "sectorCode": "702" } } } ] } ``` #### Receipts returned for test case 8 {#receipts-returned-for-test-case-8} ![Digital receipts returned for test case 8](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc8-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC9: Response includes receipt for lodging {#tc9-response-includes-receipt-for-lodging} Here, a digital receipt URL is returned in the response for a transaction related to lodging. #### Request {#request-8} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "transactionIdentifierValue": "RCPT2029_4", "issuerAuthorizationCode": "4A2B3C", "paymentType": "AMEX", "transactionIdentifierType": "BANKNET_REF_NUM" }, "merchantCriteria": { "cardAcceptorLocation": "MICHIGAN", "cardAcceptorName": "ETHOCA HOTEL GROUP", "cardAcceptorRegionCode": "IL", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-8} ```JSON { "searchResults": [ { "recordId": "0.d01c2117.1697199518.2a9275f0-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Hotel Group", "address": { "line1": "919 Michigan Ave", "city": "Chicago", "postalCode": "15210", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "IL" }, "description": "Ethoca Hotel Group is a hotelier focused on delivering delightful experiences for travelers as we become their home away from home", "websiteUrl": "www.ethocahotelgroup.com/custservice", "merchantCategory": { "code": "3529", "description": "CP (CANADIAN PACIFIC) HOTELS" }, "logos": [ { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/a5aedeb1-d70d-4832-9bc4-8b83e74c1213.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Hotel Group Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/a5aedeb1-d70d-4832-9bc4-8b83e74c1213.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Hotel Group Logo" } ], "merchantLocation": { "latitude": "41.8373", "longitude": "-87.6862", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2023-10-14T12:18:38.306+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1697199518/716dca6a-47b4-4a35-9fa1-531f1c6ce1e4/rN9zyOwMKSIjROK8T0PGFQ/iGVWGPDn0ELMvB1lK4BP47TOrj-exkheBG3PYvm4-AJaLLp4x40G9VyCFKx_wXmGPs64f45Cj2VunReSPP-dGaqc5PgG_uQLeWq5clRS5sU4lyPosdu1ApQJIRH570hvmvOwbntTMc3ctOwza3a2SZyjmHmDGKk3_-Y5i7SCvwAfVIjTtvYCe2393Gbm90y9Wpk_YwI5FdIxdwRhZ87Z0pXfcXqXkfEtXcIyFiNJ_n1MXSkWRaesGAKcD-lqDVcNI6l4MHDotaHspFDr7NOfl4ECP5hjo0UUJgoEtchmnBlfbU-m5eDnpBzQrfZm01-IOiwLZBklP_3kDcjX6tyIXIgft77BIobZzt9n-u3-MLFmjs8We0mpMV-KSwLurDvl0syWieNyp2ONp7OY9v3odjNv4A2d1CbLXUd4Soa7jqq80TdIXZIVJ9HR7xHQq5eeV35IGNTmBdRNrCXD_hgxQSIIOrkrFhckNoJq-LJwyX_XvF-d_MeamnjQqqxYvwI6AiB2YSykghPJeaoDPBJ2KYcUCDnt9Mo-quAFRUcCDWgaa2fjAPfMbHAMB8v_hxZjb1EWxrpTc2Zb7y-F-2FyL9njl2hUKFAbOtp3dhLGR2gC9ZlYD0VyL2ThjYLNgI9z1NhI1S119ivYa6Voc403pt2aEaKgdjd_J64CxNO_mqFetSuKY_x1eF_htj4JMdhPshtNVr-QV3BPzwjfgWrpz1IqEYiwMoPS6J7qLwab2HOGmKtswVvFEvFzBltzegEWyff1A40bbpASSQrBcw5J4PrRzfCxif_6-iauvgBuzzbX85umgL1j9OJvmZg?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Ik1FbHpvRnQ0Ny00ZTNPQ1JhYW1kdHJBM0N5Zm9PTGFoM29XS0U3TzRBZmciLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZSIsImN0eSI6IkpXUyIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNjk3MTk5NTA4LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNjk3MjAwNDE4LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE2OTcxOTk1MTgsImp0aSI6IjZhOGRhOTIzNTdiNzVkMTQ1ZjA2ODMzNGZmM2YyYTAwIiwiY2lkIjoiTDFReG5KU2hzajd4LXk2c1dSYWJGdkNTOVV1YTFmNTdDcG5OMHZpXzdkMjRjMzFmIn0.WHCP4JH9YVmdQHk-NTPsbjxJPas7-j7wpNL94z5Cyr2mP53dpLSY4EmygWaTRDEsd9RL_7mOEMl7YuAaL2PPH1L1ZGgOVBHLLIBtKxUR9rJPnQR_GUSy1b01MUlVjLmcmot46WbPQrtLWSwk_EAp2ifwFey2Cnp5oaE7Zm3F49wJ6tvjmqv8up4ByBnkVSPEvyPg0ZxCWzlzbfveZo7JFgAd-MaiU3WhzfwRvUuwHuGQaZTu_czy8HQPWh3ChFGIIUtBT9gqgpB8phgzs0XeQhpGrA3FNS1X_7W5qP57kfrdS0XZ1CxvwglUxyYvrEe6RFYbNIXCUl4VnD0F4NLycg", "contentType": "RECEIPT", "expiresOn": "2023-10-13T12:33:38+00:00" } } ] } ``` #### Receipts returned for test case 9 {#receipts-returned-for-test-case-9} ![Digital receipts returned for test case 9](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc9-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC10: Response includes receipt for air travel {#tc10-response-includes-receipt-for-air-travel} Here, the `transactionCriteria` provided locates a digital receipt for air travel and the digital receipt URL is returned in the response. #### Request {#request-9} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "cardFirstSix": "768954", "cardLastFour": "7654", "paymentType": "MC" }, "merchantCriteria": { "cardAcceptorLocation": "HOUSTON", "cardAcceptorName": "ETHOCA AIR", "cardAcceptorRegionCode": "TX", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-9} ```JSON { "searchResults": [ { "recordId": "0.d01c2117.1697199657.2a9b393f-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Air", "address": { "line1": "5410 Airport Way", "city": "Houston", "postalCode": "77065", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "TX" }, "description": "Ethoca Air is a global airline providing non-stops to business and vacation hubs around the world", "websiteUrl": "www.ethocaair.com", "merchantCategory": { "code": "5021", "description": "OFFICE AND COMMERCIAL FURNITURE" }, "logos": [ { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/1bec2398-980f-43ef-8fe6-9005219ec339.png?size=400", "type": "INDUSTRY", "altTextTag": "T+E Airlines Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/1bec2398-980f-43ef-8fe6-9005219ec339.png?size=200", "type": "INDUSTRY", "altTextTag": "T+E Airlines Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/d26408d5-ad67-4cf5-a0dc-12a4f6e42de2.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Air Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/d26408d5-ad67-4cf5-a0dc-12a4f6e42de2.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Air Logo" } ], "merchantLocation": { "latitude": "29.7863", "longitude": "-95.3889", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2023-10-14T12:20:58.089+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1697199658/716dca6a-47b4-4a35-9fa1-531f1c6ce1e4/sBL9YS5sDewW4wgzTh8oMg/9eSB78obaWf0RO8grBgf2BpQ1f-OZcpwkVoQHwfCUIrr3dp0QP1YF_pvdkxxGbCpa6sB3TcHypQWMMhCiktzRvY8TxbyJGvgoGRgCwlSJf12wVOSvGf4lIJ9YDXkYE9ZGoeTVzWeOcT8HedS95PZgKSJ3JFG1w31iLs1XAViwhbSyXWv8ir4ojqVJ4Mnktx2Wg-UGDN5cf2Xsn0hsu0OplJTnLYqEoPVHMc4DzCAlq6C2qC6UZRTebpHMJmYQLyW6hMJrSqwNZGEtqQJbokHnaG9zAOjYlQhZyl6_-s_JED1sP3nlq_nU1gfy9U9QuIevLp-o4jo9BzKO8ArN3CClYDtU8nWUr9s8OpT28HuzWwa4Fi1y0qcjA6xqUg2swi2zMPSSkM-a7HznjbDFy1sPmJgxVgOzaPbhcCfq-DrTgvkEt5UGZ25DyJqiUN6iRsqc4UJuqjjl-c5-h4xWoN4agQMHD95Svwx60YzVAwhp_wQ0Ox67n_IXO40qJwKkGdPY06rg-P59E0B-3fmdQJToADs4YIfMkCggIANUfgkAq1p6qMtQ-KvL_nkDAyA47U6ZbLqylH75NNgld3nDvbNi1MKkmGdoFXl424YwteKoN1kZsomGGv_psw1FM2VkYYJ2exfwkClgVylXGMNH-HxH8OYzq6oupwPiwvLAsysbW2891kuyo6GRO-89_XT2rtLHJY?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Ik1FbHpvRnQ0Ny00ZTNPQ1JhYW1kdHJBM0N5Zm9PTGFoM29XS0U3TzRBZmciLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZSIsImN0eSI6IkpXUyIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNjk3MTk5NjQ4LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNjk3MjAwNTU4LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE2OTcxOTk2NTgsImp0aSI6ImEwMGNmZGM4YWVlNjJjNTdkMjkxMzFjMzdiODFjM2M3IiwiY2lkIjoiTDFReG5KU2hzajd4LXk2c1dSYWJGdkNTOVV1YTFmNTdDcG5OMHZpXzdkMjRjMzFmIn0.13UwncoJYz9y2AcXxBmK4WUoJW_ADaZHdUnv0MRi97kh84vlu4MbbicvzHmfhsnFV9359osF_Wv81QqpnvrCgRGsJCFaa6oE2EvBBhOvQEAhG0y24FjtMrieKPD6lX9yh3L9BlHEu5EXdlWeaCOurHk-b2NGCodvUJ80nHAbQRdI1ljLye5Cn9ciqhKorL3FJX__Mrl4doA8xQ6Jiy_f0wKv4rjmZKG2olqdbfbykgF4i04SQzafPP-dKV7I4Dr5MCC9MZ-uX6POzKe62kSBOBJddOX7Dyh3-FlxeZUjLdB5GnKN5kXSSkiUUS2GwfojYEruzPNlr6Yylbh-VcSfTQ", "contentType": "RECEIPT", "expiresOn": "2023-10-13T12:35:58+00:00" } } ] } ``` #### Receipts returned for test case 10 {#receipts-returned-for-test-case-10} ![Digital receipts returned for test case 10](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc10-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC11: Response includes receipt for clothing retailer {#tc11-response-includes-receipt-for-clothing-retailer} Here, the `transactionCriteria` provided locates a digital receipt for a clothing retailer and the digital receipt URL is returned in the response. The receipt includes **call to action** links, red-outlined in the example receipt, so that the cardholder can initiate communication with the merchant. #### Request {#request-10} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "acquirerReferenceNumber": "20292029202920292029014", "paymentType": "MC" }, "merchantCriteria": { "cardAcceptorLocation": "AUSTIN", "cardAcceptorName": "ETHOCA THREADS", "cardAcceptorRegionCode": "TX", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-10} ```JSON { "searchResults": [ { "recordId": "0.d01c2117.1697200544.2ad88f7e-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Threads", "address": { "line1": "1485 Pea Green Road", "city": "Austin", "postalCode": "78681", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "TX" }, "description": "Ethoca Threads Desc", "websiteUrl": "www.ethocathreads.com", "merchantCategory": { "code": "5999", "description": "MISCELLANEOUS AND SPECIALTY RETAIL STORES" }, "logos": [ { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/34303650-630b-46b0-82c2-e01cbced3d18.png?size=400", "type": "INDUSTRY", "altTextTag": "Family Apparel Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/6c437557-4d44-4951-b86a-75f7639ffcda.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Threads Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/6c437557-4d44-4951-b86a-75f7639ffcda.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Threads Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/34303650-630b-46b0-82c2-e01cbced3d18.png?size=200", "type": "INDUSTRY", "altTextTag": "Family Apparel Logo" } ], "merchantLocation": { "latitude": "30.3004", "longitude": "-97.7522", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2023-10-14T12:35:44.916+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1697200544/716dca6a-47b4-4a35-9fa1-531f1c6ce1e4/lnQnaeuw76IjjFXlPebSVg/Ou2BDsw3J8Wmb8H4vXjZpEuBPmdwBNVd79AJ3wcKEpYsE1gjlKm138G6iE7RDbRck-l511Y-XtaYQZ1E2gci9d8eHHGofNIwawXREdhMJIO0XEoOzej5eVn4Luq0xaCNrcSryXavHi1KrG_EVVXl4vrS-e3RBQar6DWG1v7s2aqZ7vTD9Wz36NI4Nn9QcmliBUR4J0WH0eAzqJFBUqiU7y57loM2lmG6pGwQwLu5lXPArs0Gm7oai_nlil_VW4tixMvM3u_2UJwC7bR2SK9yNodUCxbHZuBSja7_CKZlRAzoAKvlsLHjVkh5e234qgSmBs77GdZ3LCnjGM9aXPigtlIFtXTDoV1qgxkkYmNHAtFAcC4ySy1UH_azRd6mnnmAeY3n4PybGiRWtFwBt6PeZcVB1-qgBKM6BvjgnFKRuWuNJpsxbP0MtAXrtdEUKL8E66K9-jrLIL7GwPs-JwXp4PpvmMHzzjCfqbQqT9bG42BCoL7k69s12pqZFhJNLxqvoWqS3fyV1WuQTut9VXpiHjs27rW49NH_LBEM_HnLOgS2i98GWDxO1eYjiOitRokzpFQ_guMH_oZAfH8cdM5ivtEQPA96JxmW-UG4ihMomlK3vhSeGC_KMA9Dxb3pwmGTCM8fvLG5N5AUbdqI8jsz3bofRhJqZWB-Rco5ARYcAKn2P4nd5uF43DZ6c77pIdKoc1GRf60PKHwPWLc?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Ik1FbHpvRnQ0Ny00ZTNPQ1JhYW1kdHJBM0N5Zm9PTGFoM29XS0U3TzRBZmciLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZSIsImN0eSI6IkpXUyIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNjk3MjAwNTM0LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNjk3MjAxNDQ0LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE2OTcyMDA1NDQsImp0aSI6Ijg1MjAwYzk3ZDA2MTMwMDFkMjQ5N2I3OGFkZjQwMTc0IiwiY2lkIjoiTDFReG5KU2hzajd4LXk2c1dSYWJGdkNTOVV1YTFmNTdDcG5OMHZpXzdkMjRjMzFmIn0.2_cNOsewtDdE0C3bZO3Q14j5SqHFvYiVWTokBwFRwu4E1U1jovDBMh5hgrStyMIE9Hdmv16QojXV4V5XtCoUMfUT9lbrU3QJGlWJ0h_loLdWxAWeZVKQQlni7qTVrV55P2O_pyYUVy5G9opoxg6mowvQ5UE32IlCX-V2oetOpM7G-DZguW-UQuY2YzFlFv0ov6dOAip8b08CVCuXrm8DJtWt4S1Tsw0-u9uz7C9OdYR3m7HT-3uYZ9JyOWnGlDockuKy6_GGE1BbVpVCXQU8gHOmQoo7wkHg-ajFlKaO-IwtolweGrdEDwsybKVXvs3nLnXXOUd5oF17sIBEBzYJgg", "contentType": "RECEIPT", "expiresOn": "2023-10-13T12:50:44+00:00" } } ] } ``` #### Receipts returned for test case 11 {#receipts-returned-for-test-case-11} ![Digital receipts returned for test case 11](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc11-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC12: Response includes receipt from Amazon Canada {#tc12-response-includes-receipt-from-amazon-canada} For this test case, the request is sent for a transaction processed through Amazon Canada. The receipt link that's returned takes an Amazon user to their **Order History** page for the merchant in the relevant region. Note that purchases made on Amazon.ca aren't visible on Amazon.com or Amazon.co.uk. These websites all function like separate merchants. #### Request {#request-11} ```JSON { "locale": "en-CA", "requestor": { "name": "name", "id": "id" }, "searchCriteria": [ { "merchantCriteria": { "cardAcceptorName": "ETHOCA AMAZON CANADA", "cardAcceptorCountryCode": "CAN", "cardAcceptorRegionCode": "ON", "cardAcceptorLocation": "Toronto" }, "transactionCriteria": { "paymentType": "VISA", "issuerAuthorizationCode": "1J2A3R", "acquirerReferenceNumber": "20292029202920292029107" } } ] } ``` #### Expected response {#expected-response-11} ```JSON { "searchResults": [ { "recordId": "0.4d18d017.1758223625.6b9c8143-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Amazon", "address": { "line1": "100 Main St", "city": "Toronto", "postalCode": "M1M1M1", "countryCode": "CAN", "countryName": "Canada", "countrySubdivisionCode": "ON" }, "description": "Ethoca Amazon is a multinational technology company focusing on e-commerce, cloud computing, online advertising, digital streaming, and artificial intelligence.", "websiteUrl": "www.ethoca-amazon.ca", "merchantCategory": { "code": "2174" }, "logos": [ { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/bc269f9a-bed7-4e7f-b78a-087d309c6a8d.png?size=200", "type": "INDUSTRY", "altTextTag": "Non-store General Merchandise Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/bc269f9a-bed7-4e7f-b78a-087d309c6a8d.png?size=400", "type": "INDUSTRY", "altTextTag": "Non-store General Merchandise Logo" } ], "merchantLocation": { "latitude": "-89.1234", "longitude": "129.123456", "type": "STOREFRONT" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2025-09-19T19:27:05.933+0000" }, "sensitiveContentTypes": [ "OTHER" ], "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1758223625/342a1667-6c65-409f-b502-f605a4c81d61/UFThThrDMxYVUjms1R9Knw/sf3efoPVGHT_9Wj8ZWdWvw_t6ibEapivpzxcxixyTk9BmeDrAkIaLgXz9GaZs4V7XtWqmxFyBF7U0-ue7eRRI7anlSOgDSRxMk-jrytAK3elxTpkI9JmsZ3wY7VOPdcaOHDtWJbiGGEOUBVRnZuGTsoXSsr4ASY8yUNwp0ZLmyL97lEMxbWXpoe-AgaS-mrgW6UBAModv5wu1W9Z838vEh-IgUof4p8qWXcLrEyBS1EfdlBFKronCbsWaWnFoZfwPbSgyDOxCgTFqWMPHWdccxNvFNDUTVCu66pFVDQXUzziqhEzxBByrgU2Lgp-_mMEgJnY_rEnZJJfYSbUxNsO7S-2u6xE1dhruiKi0LBaGuUA7KkaYEjbv_RyF5jrdDcJPN4yYH1wsw94BowtgpxOVOTefCJ84STgmDF1zONFG7I7Xg0bkV0CQ1oJHLPQrFV0Q1cFuxBigEq-Tg-rBq3zvOcpHjA7L8Am91djo2-Nmmr1Ji6jwuYI9lZifSFpRARjlkumRppxKrSjtKzfR8VN8L1V42dpZjlXf-rCRF1E0YXsPqG-dXv6rPNIvKi2gtibVT14u7xGiv4oQmI74oorJkPYRBuPLF-WuZ-RohbnhrQ061YkRRr94mHSMD0-fNHuEekygm3ZHRHlJt-mroVzVV-cFMnwBBkezyLku9Z_34pPulv2jVfdWEaoCL13GDOy6rukWwm8KAK7PlMyVGNMSH04O7dbXS3mQpBUFQ2GEBBjz8p7jE9IRCUfjFYIfswmeuyd6MJ6F3r-gZxoFeT-cs9NAQwLbaWoFOPLBIQ8zRuhCLcVwl8Y19uY4EikfG5s7CscjqkaN3y_uhS0uxgZh08u3gVR0V7x6Y749y-yT4w6C9RFCM0rfC1w1Ro1IQGiJbRp1JUcpGHLklwQkoW6xCaiEPgQ5Gxq77UvcaHJwsKnt2dyWPVZurlnt9qLV7NXqP0Vm2lqcnSOVv1wmGaffC1Wcq-TY4_GOKASCJlA2r5b8MhkPg?locale=en-US&access_token=eyJ4NXQjUzI1NiI6IlhjcFJqTDN2a1N2cVF1Z3N6aXBpejhfdFFzRWg0X28teHhoMDNvT2Y2TlkiLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0xIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNzU4MjIzNjE1LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNzU4MjI0NTI1LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE3NTgyMjM2MjUsImp0aSI6IjdkZDljNTAzMDFkY2FmYWI4NjI5ZDEyOGVkNTYyZDgwIiwiY2lkIjoiTDFReG5KU2hzajd4LXk2c1dSYWJGdkNTOVV1YTFmNTdDcG5OMHZpXzdkMjRjMzFmIn0.ucjsEXj7wBr06UnrqAybzQd5DtW6ukrteFhgxlExRjMpJP7YCM2tmiv3yZh-Zs4S9JSmvzAV3fhk62FI42rNRhow9y1ITRza1-zQGtt_OBViYtFLHfrqpBslc79RFlL6wlB9VG7Mk_gteRuBuLrw9CvdoLNAAVINjcLWbe-zqUR-i1R0z4vSbeaydN3Oxy7z_0H36JrdamqszFwB0qz765eUGQ_NAuaXPSBTJL9a0fWqhn44DguzAyXfHAEVIABUbL-y03iJH4D1Fp0A_Ro3M9gDN3btUNKaCVy3M1w67vtzTtSWCKoTjuTvqYxJBeRjGoStuIcEDamtDQGyoDiP9Q", "contentType": "RECEIPT", "expiresOn": "2025-09-18T19:42:05+00:00", "receiptRedirect": true } } ] } ``` [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC13: Response includes receipt from Amazon US {#tc13-response-includes-receipt-from-amazon-us} Here, the request is sent for a transaction processed through Amazon US. The receipt link that's returned takes an Amazon user to their **Order History** page for the merchant in the relevant region. Note that purchases made on Amazon.com aren't visible on Amazon.ca or Amazon.co.uk. These websites all function like separate merchants. #### Request {#request-12} ```JSON { "locale": "en-CA", "requestor": { "name": "name", "id": "id" }, "searchCriteria": [ { "merchantCriteria": { "cardAcceptorName": "ETHOCA AMAZON US", "cardAcceptorCountryCode": "USA", "cardAcceptorRegionCode": "WA", "cardAcceptorLocation": "Seattle" }, "transactionCriteria": { "paymentType": "VISA", "issuerAuthorizationCode": "1B2A3W", "acquirerReferenceNumber": "20292029202920292029109" } } ] } ``` #### Expected response {#expected-response-12} ```JSON { "searchResults": [ { "recordId": "0.6e18d017.1758219474.378d7bb-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Amazon", "address": { "line1": "100 Main St", "city": "Seattle", "postalCode": "28208", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "WA" }, "description": "Ethoca Amazon is a multinational technology company focusing on e-commerce, cloud computing, online advertising, digital streaming, and artificial intelligence.", "websiteUrl": "www.ethoca-amazon.com", "merchantCategory": { "code": "2174" }, "logos": [ { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/bc269f9a-bed7-4e7f-b78a-087d309c6a8d.png?size=200", "type": "INDUSTRY", "altTextTag": "Non-store General Merchandise Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/bc269f9a-bed7-4e7f-b78a-087d309c6a8d.png?size=400", "type": "INDUSTRY", "altTextTag": "Non-store General Merchandise Logo" } ], "merchantLocation": { "latitude": "-89.1234", "longitude": "129.123456", "type": "STOREFRONT" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2025-09-19T18:17:54.433+0000" }, "sensitiveContentTypes": [ "OTHER" ], "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1758219474/342a1667-6c65-409f-b502-f605a4c81d61/odxHR930XlZg_dJTCHx2nQ/pwL1dSZP1aw6w7KAL7MqZijyDKqHA9eRlhRnqH-FPAYm2LdUV8lhEEKfgjlFHcFiwmsObAuE45_hH0kflkKK6v2FHRO8-LsgBmaqSuSY6lkayIC5lPJFQ5K-qoQC7Cm1ihYOIaAMcnY17rWRlx-6crs2jW47xblnDgGSItGu0zCY4FodSQRIPWtsxyQfCep5FCw3n5amwPrC-Hc68i_ibCKDKotBu06x8gBl7qWreZZq_anheiIH7UbNCL66q9hEsDXT13b9sClI7Gv5i7cXZMF7dqNCP0ukAGmP34jlh0mHMiLid84U0sSMNkuiZY52xOhYrkuWQgAHy0E2Alpmh508onm_exjvcztqhKfz2NBe_BvPVYSbWaaqvHpUrsdYjKZKImIQT5Hyz-gnyNcuw5lOw2F8TGuD_0evHx0B-w6F3m19Dygek6uezmcojrf4xIIk0xRWzmEWBNIcZtT4fpnFBChb9QCPJ5KtC4-Te5WTUDswSshUtqqJ_iowCWzfLMkdyX7vvgw9aV3lnStZXL8GBowOEkAfyG3S2dhh4oygJIqaz8u2BwWH587cC10VkAKGr6UIEE2aEcq8N4M4hO3qfstwFa3M4TNeykmosyf8niM-NlUERrdWlGonrjOuK1mF_mZmE4luXRteS3ukXuI5wnnLJacNcVZD8B_uB824JgolhNhRLyL6VSZb5n0E2q4WsQczfBsvMW2UpjWkeFUDT5pcfD-fQ7CMODdqlF-hBXQ1HbrwyBQfHBw0J-W0GgC7lrkAyMnYBnwYWBkPjCcrDhKJ4Kol8zuQ2Jq3EoGwVvpFdHCeqGbjAIE2CmLtkG9l8N6LI359tiNVndZZLNJevsmfmWGADIWCmB3PzQ7f7zTdqi6NUOyxMHpZY0em6mf3iBJJmW612KjjJxt-PyDJz-qAhsuTu3wputl1mZdkKMiGrvRzheXEK60XHqgoJRos0lpLqLVI-g8K22zRQomD-WSDlDclUQmmMD0MbA?locale=en-US&access_token=eyJ4NXQjUzI1NiI6IlhjcFJqTDN2a1N2cVF1Z3N6aXBpejhfdFFzRWg0X28teHhoMDNvT2Y2TlkiLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0xIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNzU4MjE5NDY0LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNzU4MjIwMzc0LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE3NTgyMTk0NzQsImp0aSI6IjA2ODgwM2UxNWQ1MjI4Yjg0MDM0YjY5NWJkMTJhYmFlIiwiY2lkIjoiTDFReG5KU2hzajd4LXk2c1dSYWJGdkNTOVV1YTFmNTdDcG5OMHZpXzdkMjRjMzFmIn0.n3k8oFkSGyYdHGULB042x9OXxeBrGgSmAq_xLWzaIlWl4yC-_cYdhBjUwx0UHM-f3COLWFolhrL7jnaSKAURofggfXrUOfxAu7duUjy1Y3Gmg5Enz7Tj6Z6J_FEw5gz9ktI6Z_DCTP0dojJKERlnk7cy_UuC_4G-aN1zgh8ET2fts1lXwbtFQRb3i71CmPmWP3bv-fHmeJGGg5SehF0Hds47tTH_8muJuYNWDmWHWxkC_1zWviKBlLF5ZFh6yxdFrmjh--LaMbuyF7rLLwTZjB82VIGJ-L8NM2Xc7O9s1NmoBcgJ2LKf4Zs5D1ZTTdYHTZnYvzdtixBvNyU7Pk2cnw", "contentType": "RECEIPT", "expiresOn": "2025-09-18T18:32:54+00:00", "receiptRedirect": true } } ] } ``` [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC14: Response includes receipt from Amazon UK {#tc14-response-includes-receipt-from-amazon-uk} In this test case, the request is sent for a transaction processed through Amazon UK. The receipt link that's returned takes an Amazon user to their **Order History** page for the merchant in the relevant region. Note that purchases made on Amazon.co.uk aren't visible on Amazon.ca or Amazon.com. These websites all function like separate merchants. #### Request {#request-13} ```JSON { "locale": "en-CA", "requestor": { "name": "name", "id": "id" }, "searchCriteria": [ { "merchantCriteria": { "cardAcceptorName": "ETHOCA AMAZON UK", "cardAcceptorCountryCode": "GBR", "cardAcceptorLocation": "Salisbury" }, "transactionCriteria": { "paymentType": "VISA", "issuerAuthorizationCode": "1B2A3R", "acquirerReferenceNumber": "20292029202920292029108" } } ] } ``` #### Expected response {#expected-response-13} ```JSON { "searchResults": [ { "recordId": "0.4d18d017.1758223684.6ba6c282-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Amazon", "address": { "line1": "100 Main St", "city": "Salisbury", "postalCode": "28208", "countryCode": "GBR", "countryName": "United Kingdom", "countrySubdivisionCode": "ENG" }, "description": "Ethoca Amazon is a multinational technology company focusing on e-commerce, cloud computing, online advertising, digital streaming, and artificial intelligence.", "websiteUrl": "www.ethoca-amazon.uk", "merchantCategory": { "code": "2174" }, "logos": [ { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/bc269f9a-bed7-4e7f-b78a-087d309c6a8d.png?size=200", "type": "INDUSTRY", "altTextTag": "Non-store General Merchandise Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/bc269f9a-bed7-4e7f-b78a-087d309c6a8d.png?size=400", "type": "INDUSTRY", "altTextTag": "Non-store General Merchandise Logo" } ], "merchantLocation": { "latitude": "-89.1234", "longitude": "129.123456", "type": "STOREFRONT" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2025-09-19T19:28:04.850+0000" }, "sensitiveContentTypes": [ "OTHER" ], "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1758223684/342a1667-6c65-409f-b502-f605a4c81d61/epkClin8AA0xThYqwVu8gg/eamNNSc1XV5Kc7b2WALiCK-2NhJLsckRajmshRW3LlmMEZOV753lwwgkkjcuKKs-LGUVArczRpz5yr-VHwb9z9W6i7tHVerdGvzQ2LL70ASXbpLvOhYhoq2qlHRv2_q9XZUpTtlh2cFnM4gMqMl5nhxf8YF4EM0MQyILIGwvnPfae8lCwmXTatqrKG8CZL4MQLrhl0lUxDZjStvIlqZ-xcHjBc2W6copiN2sivGzYz0TQ-xNm89z6osKTe6l6XDLZwQZh-hK-7vfWNPaHPPGHMR41H3UZYlfOkNc1cGA1RPA56gvKrv5I4Mx6vxF8K7D7L2N9Qy28gAnSiEv5B0XWA3hLzGxv6OBnAXCGUsPXWOCDUwSvz5ajmLlqzi-OORXuunt04LKO2Jkxba1YAKP9Cvady1hEpO3Z6ijisJE66cboFJhp5nZAeOoCaQBtnG097TLwML2-yhMUZ1WKb_xR5CBM0SO6vIZWrIlu9f-eUH26XdXoboi3LRMOaLGxe-_Ta2u1BjtU1b6PgpIwGrreRK9WiykFHmHYNipkRshtBE3bAiLH8Oys1xiulV4LF1CM2mYo0ik_mYiOjjWdabBfO5Ca4O4MkLdgcJ-FnZ1l_gRw8_9RCLw9cTpVVoxYWGJRN7eCgbbBD86610wprJi-KPYrHXONqfP3ZaklYlwF23anend4rAmDVhPXZWFREfWv7vl-38Pkz4jy4hxCoPQNRq_P9WDaYFaDfHXN3FU1X1hvx2fCcwjfRBaIDc8igwQJ_c99tXuYaU02yAQf4qItcYcmwDsSYdtldwCrYPx_VoLw1MpBfBVQGNhPKPJvHt9eoN4CAtq7alNx9YNV9ZrgfuBgVEm2v1yRM-ZiT1_YRuMNecWzGB0bQ1S7aBegyMJu1aA0_2wlxI30w7pTwq0sJhzRYLcvDdbg0P4wHNCs6s7Ho3K9LHBEOo-NXmo-rLjl0PXrHY?locale=en-US&access_token=eyJ4NXQjUzI1NiI6IlhjcFJqTDN2a1N2cVF1Z3N6aXBpejhfdFFzRWg0X28teHhoMDNvT2Y2TlkiLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0xIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNzU4MjIzNjc0LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNzU4MjI0NTg0LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE3NTgyMjM2ODQsImp0aSI6ImJjZjZhYzRiNmVhNDYxZmIzODMwODdiZjViOTY2OTkzIiwiY2lkIjoiTDFReG5KU2hzajd4LXk2c1dSYWJGdkNTOVV1YTFmNTdDcG5OMHZpXzdkMjRjMzFmIn0.WDBi7pmbxMoe8_Z0LHcYkVk43czf84jKVoJdgJqPc6khYrpmY29XI36LHyz-66wo3c4qwsaGPIg68gwTtBFHfh-xj_E5ynvR5O6WZX7p86LeNUImukuH3VJkj0cEdjfpjDRQbM8yMU92t33pNK_nPStaAX8pQ7RuKNkFAZ8PR_sMBVwLOOA2U4kN1Tb1SaG6-Y-ocgSRD-t0tBhrKxDA31Geqd5-15i835qKzokHvb8zwaIe0zSGq-xa-xt0Ak0MWuEbqngI-MUN_eSCSxolrmFsaBVu9ZKfDxdYweuAP-wYmAcFZgiw2APn7mWdZK46DnSIdLiN8Gw8cKMmrYfxtw", "contentType": "RECEIPT", "expiresOn": "2025-09-18T19:43:04+00:00", "receiptRedirect": true } } ] } ``` [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC15: Receipt returned when transaction not found {#tc15-receipt-returned-when-transaction-not-found} For this test case, the `transactionCriteria` provided locates a digital receipt for a clothing retailer even though the transaction isn't found. A digital receipt URL is returned in the response. The receipt indicates that the transaction isn't found and also includes merchant details so that the cardholder can contact the merchant. #### Request {#request-14} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "acquirerReferenceNumber": "20292029202920292021234", "paymentType": "MC" }, "merchantCriteria": { "cardAcceptorLocation": "AUSTIN", "cardAcceptorName": "ETHOCA THREADS", "cardAcceptorRegionCode": "TX", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-14} ```JSON { "searchResults": [ { "recordId": "0.440f3417.1715179979.868dc540-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Threads", "address": { "line1": "1485 Pea Green Road", "city": "Austin", "postalCode": "78681", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "TX" }, "description": "Ethoca Threads Desc", "websiteUrl": "www.ethocathreads.com", "merchantCategory": { "code": "5999", "description": "MISCELLANEOUS AND SPECIALTY RETAIL STORES" }, "logos": [ { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/6c437557-4d44-4951-b86a-75f7639ffcda.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Threads Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/34303650-630b-46b0-82c2-e01cbced3d18.png?size=200", "type": "INDUSTRY", "altTextTag": "Family Apparel Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/6c437557-4d44-4951-b86a-75f7639ffcda.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Threads Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/34303650-630b-46b0-82c2-e01cbced3d18.png?size=400", "type": "INDUSTRY", "altTextTag": "Family Apparel Logo" } ], "merchantLocation": { "latitude": "30.3004", "longitude": "-97.7522", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2024-05-08T14:54:26.358+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1715179979/342a1667-6c65-409f-b502-f605a4c81d61/r0A5s5lHkUiQIM5Lja_WXg/It5Oo60z-ni2gd0on9X42BopmmXy-OiGBfvhQXufm_xWWuDzAMWUByl0eGvcrzupLc10a9TRZpjBhy3Yz4SqkxpuqDGXPikgonV8lOo6uXBQJdFew3GdIX9f7NYMlBx-6soDwv1yRBJ91XytofvDlsMFJWGxLpOmjf21YV4f9S_1WTbG9oYVkGbWBHirWi_JbChJZGCpUB5BWrKI5RndIcaj30ORPTjt6DhsfvRf3vXwdDUA72O2PFD1ZhRRkLMPyIKLhXNd3l57RY3xnTtcz7jp10eY2tW0O2bFc6_m1dNFLYlWrWrS_MeQt8YHViF1WgBlTOy6_PN7LKW7UTT-dW1PidSMEojGL2x3GA5hiX88Vu3XVbS-irhQncD9vqLx-vct3Yl0IH3o5qlX0R7unZqPI00qsRY4tA24rxov8dZQhwGmiM930e3Iau9wfgIbHQnKfpBk3x7oZp7y8iep0Qqz5ZXvxux87XYHVuLvp-hZ4c70-GD09zuuhTY6M7PaN5CpwIOdGlBJ5ig3RXiXgn8bk-IXxkCEoHYnjQ2WyvlS36y3J7-_CIqpAZ2JNa7PwFk5VqsIJHJiOy7urmMgsPxGrbITJd4E0XOX-FHYuxvYnyvWD2XQyaA1rMgj1IHE9PMkNGLcgU07eFrVDpMNe1Sqd5E0gwa9T8AFNQ22cSp586Wl5nYJAAcpsiFy4N3cqKnLRUxI0gVU26c?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Ik1FbHpvRnQ0Ny00ZTNPQ1JhYW1kdHJBM0N5Zm9PTGFoM29XS0U3TzRBZmciLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZSIsImN0eSI6IkpXUyIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRGlnaXRhbFJlY2VpcHRzLEV0aG9jYUVucmljaGVkVHJhbnNhY3Rpb25zIiwibmJmIjoxNzE1MTc5OTY5LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNzE1MTgwODc5LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE3MTUxNzk5NzksImp0aSI6ImQyMjg3NmE2ZmRmMWFhZDU4ZjVkNGE5OTU0YTgzMjJhIiwiY2lkIjoib1R4cThCYVoxS2xIU2h3S3RBeS13ZE1xWGkzNXRhYURnYktVd3NyRmY0MmQ2ZTJkIn0.Mt_exhBxy7AhVHJnKxZEs0ii3Ht-lWRQRkNts9zLmlUvLLHAhsuMJ5BmyWSuklhVc-PUlq1fm3QE-abHIUmnia3aIed_9B-5GLBTogSpfZNyurxoiwPe3xUiWeobjEaJQYqFfNw8bQ8EE-iNDcMbxV7hsHefEIZ-TIbGWygNIuuG37FJ23qkWOE86KCJ2VpgFZpJ3lZqouSuL6LhGwbr0uVe-N2pwj5AU4jvKkgaYtgRAwPyvK6Kk4iatuQXzs-_N23w1qK-zXTJsZfLUaszumd7QHdAdmygxmfUMvaNbgtIk6YKqQVLqxT6_BIKDu_Dqb8LteE7yJPT9GLKg26g6w", "contentType": "RECEIPT", "expiresOn": "2024-05-08T15:07:59+00:00" } } ] } ``` #### Receipts returned for test case 15 {#receipts-returned-for-test-case-15} ![Digital receipts returned for test case 15](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc15-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ### TC16: Lite receipt returned {#tc16-lite-receipt-returned} Here, the `transactionCriteria` provided locates a digital receipt that the merchant has indicated is a **lite receipt**. Because of this, no order items are included on the receipt. Instead, it provides a generic purchase confirmation and directs the cardholder to contact the merchant for more information. #### Request {#request-15} ```JSON { "locale": "en-US", "searchCriteria": [ { "transactionCriteria": { "acquirerReferenceNumber": "20292029202920292029018", "paymentType": "MC" }, "merchantCriteria": { "cardAcceptorLocation": "AUSTIN", "cardAcceptorName": "ETHOCA THREADS", "cardAcceptorRegionCode": "TX", "cardAcceptorCountryCode": "US" } } ] } ``` #### Expected response {#expected-response-15} ```JSON { "searchResults": [ { "recordId": "0.f1d6d717.1776958434.261de1b3-01", "resultStatus": { "code": "OK", "message": "OK." }, "merchantResult": { "merchantName": "Ethoca Threads", "address": { "line1": "1485 Pea Green Road", "city": "Austin", "postalCode": "78681", "countryCode": "USA", "countryName": "United States", "countrySubdivisionCode": "TX" }, "description": "Ethoca Threads Desc", "websiteUrl": "www.ethocathreads.com", "merchantCategory": { "code": "5999", "description": "MISCELLANEOUS AND SPECIALTY RETAIL STORES" }, "logos": [ { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/merchant/6c437557-4d44-4951-b86a-75f7639ffcda.png?size=200", "type": "MERCHANT", "altTextTag": "Ethoca Threads Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/merchant/6c437557-4d44-4951-b86a-75f7639ffcda.png?size=400", "type": "MERCHANT", "altTextTag": "Ethoca Threads Logo" }, { "height": 200, "width": 200, "url": "https://sandbox.content.ethoca.com/b/industry/34303650-630b-46b0-82c2-e01cbced3d18.png?size=200", "type": "INDUSTRY", "altTextTag": "Family Apparel Logo" }, { "height": 400, "width": 400, "url": "https://sandbox.content.ethoca.com/b/industry/34303650-630b-46b0-82c2-e01cbced3d18.png?size=400", "type": "INDUSTRY", "altTextTag": "Family Apparel Logo" } ], "merchantLocation": { "latitude": "30.3004", "longitude": "-97.7522", "type": "ADMINISTRATIVE_AREA" }, "dataPolicy": { "cacheable": true, "cacheExpiry": "2026-04-24T15:33:55.079+0000" }, "resultStatus": { "code": "MERCHANT_FOUND", "message": "Merchant results provided." } }, "purchaseReceipt": { "resultStatus": { "code": "RECEIPT_AVAILABLE", "message": "Purchase Receipt available." }, "url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1776958435/52532e50-de12-49fa-9a6e-1d979a8d423c/xlHGzaw67NSuyea7pa0-LQ/A60r21q1FgVEmDRdLPre-QaKhyWs2ppAABNNx0Nazdh5E7NpEmubGmOEP-s41cKtCbaeVBgJMV-Gto3st2MiRKdLK0C85vU65kTlTLv3WoSSz37LeZGefFn2q8jygIPa4SWjo-VlWIqdOY1GvAXPLAxvxKZUfA44HqXDCSgBw8JEa9Os6TmvppXO1iygj6xd6SegSU3NzGlbIUlk_fwLke7FidP6Sc5fUjxMVdUCI5hf3FGcb3yHBr_VFn2UXW2xBvRJ_VK4RJaYUMBa9-aw904qSDC2HMKQuKapXttxur2x8mZ1s_Rx-dSImQDhZ3OBciqqMvWprJv2IgZKl2oxXpFO4FwGhvAlMO9a60HRzaVSgb2Xxc0PqHAozIrvHUQMGaXl0R1uLk9GjWHi7sp8NEdo4ZuAIsT9L_NUaa5L143gF2VqB1JVXVRGW_xWq9hhXpvAoHDBVoaVhtBj0Qilxeors2DuymmQE68KjdGaqhBSC1JEQvlzfAIehM0dySFH-h83Jraheyu9-c94hWoCvPhH98-fvb67JnB06MbXgUFRbFZlglcDtpElz_f98uri1N-eVBSJFW3WTtoqJJQsz_56IX2Zzqw5bDqFyeiRm4jBo75TrXESI4t8VF9lu5Fo6j8zd8HyyquVJZEjZDGWqXu5ZKHmvUYPc8IcIVx-f-EaDVaLqWMmlIO0Dj-KaIfOX730hujzOffxzScRsbFkKZjfjgu_2LCtDeSgfSElEQwsN-E5NF5_jZGNG47nj7TT0u3Zw51Ed5PB5KoWTqeW7gqUHXR3Icg-gXPBSq9K2e1XdPJINX3cqCo-Pur8OCiqh1tiymTzcQkOwgyTpXUAYJom5_NCr3KWg1MJ1q-s2ePdPP5BiFhURExNYfPvc152CVc?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Im1nVG8zWGk5eS1obWwxTWpydTlNWTJkTkJCLWZSd3NEaGlNRDIybHA1dW8iLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0yIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNzc2OTU4NDI1LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNzc2OTU5MzM1LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE3NzY5NTg0MzUsImp0aSI6IjM5RkJGOTcxMzc1RUM3QzUwNUE1QTA2Nzg3NDk3OUNCREU4QUI2MkEyMDdBN0ZEMTkwNTlEMkNFNzMwN0U0NzkiLCJjaWQiOiJMMVF4bkpTaHNqN3gteTZzV1JhYkZ2Q1M5VXVhMWY1N0Nwbk4wdmlfN2QyNGMzMWYifQ.QGcFDKrOV0OM1De29nGNPUt3Epb5pvfxS89Hjhp-L6IMEgMO8YTJ-suXfQsAugtnAGxXa_sdXWEb3v6TXgQ6O6AvI9lXKffP0Xf-Ibx6aH9Nm-xSaOXipeqiIptIACfQ3LKTIcRJM57cKj0inKGdEeWU2HtYV1Np2h5U_HnZHRK51HWvZ5cPC2TNmMmvOIJ2YRHWNxKJ14TlpOADSebzxMy9_X0yv1_x_rjSZ9Qw04SmUIepr93HETzdG5tTQj3xH7ZA6k6TwkTssfTg6GZAVfOyiDQL8RkxgyNejo8LgAkUBTXdOU7kpqEeXoiWXRY4rb_P4_uDxW5LyjSaPRxqTQ", "contentType": "RECEIPT", "expiresOn": "2026-04-23T15:48:55+00:00" }, "transactionData": { "resultStatus": { "code": "TRANSACTION_DATA_ENCRYPTION_KEYS_NOT_ENABLED", "message": "Unable to proceed with the request. The client account is not enrolled for encryption keys in developer portal." } } } ] } ``` #### Lite receipts returned for test case 16 {#lite-receipts-returned-for-test-case-16} ![Digital receipts returned for test case 16](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/receipts/tc16-combined.png) [Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-digital-receipts/index.md#test-cases) ## Next Steps {#next-steps} * [Testing](https://developer.mastercard.com/consumer-clarity/documentation/testing/index.md) shows you where to find other types of test cases that you can run. * [API Reference](https://developer.mastercard.com/consumer-clarity/documentation/api-reference/index.md#apis) provides details about all of the fields and values in the Consumer Clarity API. * See [Code and Formats](https://developer.mastercard.com/consumer-clarity/documentation/code-and-formats/index.md) for detailed information about error response handling.