# Clarity Test Cases source: https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md This article provides test case data that shows the merchant detail responses you can expect to receive from some example Consumer Clarity requests sent to the Merchant Self Services API. ## Test Data {#test-data} Following are the types of test data provided in this article: * [TD1: Create a submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td1-create-a-submerchant) * [TD2: Get an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td2-get-an-existing-submerchant) * [TD3: Update the legalAddress of an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td3-update-the-legaladdress-of-an-existing-submerchant) * [TD4: Add a logo to an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td4-add-a-logo-to-an-existing-submerchant) * [TD5: Update logo of an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td5-update-logo-of-an-existing-submerchant) * [TD6: Get logo of an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td6-get-logo-of-an-existing-submerchant) * [TD7: Delete logo of an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td7-delete-logo-of-an-existing-submerchant) * [TD8: Add locations to an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td8-add-locations-to-an-existing-submerchant) * [TD9: Get all locations of an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td9-get-all-locations-of-an-existing-submerchant) * [TD10: Get a location by ID](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td10-get-a-location-by-id) * [TD11: Update location of an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td11-update-location-of-an-existing-submerchant) * [TD12: Delete location of an existing submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td12-delete-location-of-an-existing-submerchant) * [TD13: Add acquirer reference IDs to an existing submerchant default location](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td13-add-acquirer-reference-ids-to-an-existing-submerchant-default-location) * [TD14: Get accepted Acquirer Reference ID - Card Acceptor ID pairs](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td14-get-accepted-acquirer-reference-id---card-acceptor-id-pairs) * [TD15: Delete existing Acquirer Reference ID - Card Acceptor ID pair](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td15-delete-existing-acquirer-reference-id---card-acceptor-id-pair) * [TD16: Add card acceptor names to an existing submerchant default location](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td16-add-card-acceptor-names-to-an-existing-submerchant-default-location) * [TD17: Get all card acceptor names of a submerchant location](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td17-get-all-card-acceptor-names-of-a-submerchant-location) * [TD18: Get a card acceptor name by ID](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td18-get-a-card-acceptor-name-by-id) * [TD19: Update a card acceptor name](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td19-update-a-card-acceptor-name) * [TD20: Delete a card acceptor name](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td20-delete-a-card-acceptor-name) * [TD21: Add descriptors to an existing submerchant location](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td21-add-descriptors-to-an-existing-submerchant-location) * [TD22: Get all descriptors of a submerchant location](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td22-get-all-descriptors-of-a-submerchant-location) * [TD23: Delete the raw descriptor of a submerchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td23-delete-the-raw-descriptor-of-a-submerchant) * [TD24: Deactivate an existing merchant](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td24-deactivate-an-existing-merchant) * [TD25: Add only invalid card acceptor names to an existing submerchant default location](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td25-add-only-invalid-card-acceptor-names-to-an-existing-submerchant-default-location) * [TD26: Add card acceptor names to an existing submerchant default location with at least one valid card acceptor name](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td26-add-card-acceptor-names-to-an-existing-submerchant-default-location-with-at-least-one-valid-card-acceptor-name) * [TD27: Add an AcquirerMerchant object with one invalid Acquirer Reference ID - Card Acceptor ID pair](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td27-add-an-acquirermerchant-object-with-one-invalid-acquirer-reference-id---card-acceptor-id-pair) * [TD28: Add an AcquirerMerchant object with one valid and one invalid Acquirer Reference ID - Card Acceptor ID pair](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#td28-add-an-acquirermerchant-object-with-one-valid-and-one-invalid-acquirer-reference-id---card-acceptor-id-pair) ### TD1: Create a submerchant {#td1-create-a-submerchant} In this scenario, you create a `SubMerchant` object and send a request to the `createSubMerchant` endpoint of the Merchant Self Services API. The Merchant Self Services API validates and persists the `SubMerchant` and returns a `SubMerchantResource`. #### Request {#request} ```JSON { "name": "BAG STORE f302ff82-ebef-423c-a6f9-e019d6fdb0c9", "categoryCode": "1234", "orderAvailabilityDateTime": "2021-10-18T13:56:47Z", "orderHistoryMonths": 5, "orderLatencyDays": 13, "industryCode": "AAF", "primaryContact": { "jobTitle": "Manager", "firstName": "Johnf302ff82-ebef-423c-a6f9-e019d6fdb0c9", "lastName": "Doef302ff82-ebef-423c-a6f9-e019d6fdb0c9", "email": "john.doef302ff82-ebef-423c-a6f9-e019d6fdb0c9@example.com", "phone": "1-222-444-1234" }, "legalAddress": { "addressLine1": "123 Street", "addressLine2": "Suite - 456", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M3J1V6", "website": "https://merchantwebsite.example.com/contactus.html", "email": "customerservice.merchant@example.com", "phone": "1-234-567-8901" }, "merchantType": "SUB_MERCHANT", "locales": [ { "code": "EN_US", "merchantDescription": "Formal bag store in NY", "defaultLocale": true }, { "code": "ES_US", "merchantDescription": "Zapatería formal en Nueva York", "defaultLocale": false } ], "contentTypes": [ "ONLINE_DATING", "ADULT_LANGUAGE" ], "crm": { "termsConditionsConsent": { "date": "2021-10-18T13:56:47Z", "firstName": "John", "lastName": "Smith", "jobTitle": "Security Manager", "email": "john.smith@merchant.com", "countryCode": "CAN", "consentUuid": "3d94ab7b-fe1c-4f7d-ad4c-93c1eb6d29c3", "consentVersion": "10" }, "sanctionScreening": { "taxId": "123", "formerLegalNames": [ "STEP STORE" ], "doBusinessWithSanctionedGeographies": true, "sanctionedGeographies": [ "IRAN" ], "publiclyTraded": true, "tickerSymbol": "SST", "beneficialOwners": [ { "firstName": "Mill", "secondName": "Dan", "lastName": "Jack", "address": { "addressLine1": "234 st", "addressLine2": "111", "countryCode": "CAN", "regionCode": "ON", "city": "Etobicoke", "postalCode": "M2C 5M4" }, "birthCountry": "USA", "birthDate": "1991-06-29", "percentOwnership": "60" } ], "legalEntities": [ { "name": "ABC corp", "dba": "ABC corporation", "address": { "addressLine1": "123 st", "addressLine2": "102", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M1C 5M4" }, "percentOwnership": "50", "governmentOwned": false } ] }, "paymentConfirmation": true }, "businessType": "BUSINESS_CORPORATION", "subMerchantIdentifier": "f302ff82-ebef-423c-a6f9-e019d6fdb0c9", "searchFields": [ { "searchParameter": "ACQUIRER_REFERENCE_NUMBER", "required": true, "searchFieldCards": [ "MC" ] }, { "searchParameter": "TRANSACTION_AMOUNT", "required": false, "searchFieldCards": [ "VISA" ] }, { "searchParameter": "TRANSACTION_CURRENCY_CODE", "required": false, "searchFieldCards": [ "VISA" ] } ] } ``` #### Expected response {#expected-response} ```JSON { "name": "BAG STORE f302ff82-ebef-423c-a6f9-e019d6fdb0c9", "categoryCode": "1234", "orderAvailabilityDateTime": "2021-10-18T13:56:47Z", "orderHistoryMonths": 5, "orderLatencyDays": 13, "industryCode": "AAF", "primaryContact": { "jobTitle": "Manager", "firstName": "Johnf302ff82-ebef-423c-a6f9-e019d6fdb0c9", "lastName": "Doef302ff82-ebef-423c-a6f9-e019d6fdb0c9", "email": "john.doef302ff82-ebef-423c-a6f9-e019d6fdb0c9@example.com", "phone": "1-222-444-1234" }, "legalAddress": { "addressLine1": "123 Street", "addressLine2": "Suite - 456", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M3J1V6", "website": "https://merchantwebsite.example.com/contactus.html", "email": "customerservice.merchant@example.com", "phone": "1-234-567-8901" }, "merchantType": "SUB_MERCHANT", "guid": "9EUSTG3GR5GYEYWU", "status": "TESTING", "locales": [ { "code": "ES_US", "merchantDescription": "Zapatería formal en Nueva York", "defaultLocale": false }, { "code": "EN_US", "merchantDescription": "Formal bag store in NY", "defaultLocale": true } ], "contentTypes": [ "ONLINE_DATING", "ADULT_LANGUAGE" ], "validationStatus": null, "crm": { "termsConditionsConsent": { "date": "2021-10-18T13:56:47Z", "firstName": "John", "lastName": "Smith", "jobTitle": "Security Manager", "email": "john.smith@merchant.com", "countryCode": "CAN", "consentUuid": "3d94ab7b-fe1c-4f7d-ad4c-93c1eb6d29c3", "consentVersion": "10" }, "sanctionScreening": { "taxId": "123", "formerLegalNames": [ "STEP STORE" ], "doBusinessWithSanctionedGeographies": true, "sanctionedGeographies": [ "IRAN" ], "publiclyTraded": true, "tickerSymbol": "SST", "beneficialOwners": [ { "firstName": "Mill", "secondName": "Dan", "lastName": "Jack", "address": { "addressLine1": "234 st", "addressLine2": "111", "countryCode": "CAN", "regionCode": "ON", "city": "Etobicoke", "postalCode": "M2C 5M4" }, "birthCountry": "USA", "birthDate": "1991-06-29", "percentOwnership": "60" } ], "legalEntities": [ { "name": "ABC corp", "dba": "ABC corporation", "address": { "addressLine1": "123 st", "addressLine2": "102", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M1C 5M4" }, "percentOwnership": "50", "governmentOwned": false } ] }, "paymentConfirmation": true, "sanctionScreeningStatus": "IN_PROGRESS", "billingAccountCreated": false, "salesforceAccountNumber": "261713" }, "businessType": "BUSINESS_CORPORATION", "subMerchantIdentifier": "f302ff82-ebef-423c-a6f9-e019d6fdb0c9", "searchFields": [ { "searchParameter": "ACQUIRER_REFERENCE_NUMBER", "required": true, "searchFieldCards": [ "MC" ] }, { "searchParameter": "TRANSACTION_CURRENCY_CODE", "required": false, "searchFieldCards": [ "VISA" ] }, { "searchParameter": "TRANSACTION_IDENTIFIER_VALUE", "required": true, "searchFieldCards": [ "AMEX", "DISCOVER" ] }, { "searchParameter": "CARD_LAST_FOUR", "required": true, "searchFieldCards": [ "VISA" ] }, { "searchParameter": "TRANSACTION_AMOUNT", "required": false, "searchFieldCards": [ "VISA" ] } ] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD2: Get an existing submerchant {#td2-get-an-existing-submerchant} For this test case, you send a request to the `getSubMerchantByGuid` endpoint. The Merchant Self Services API validates the request and returns a merchant record. If the status of the merchant is `LOCKED_FOR_EDIT`, this indicates that the merchant record is locked for modification by the Ethoca customer success team and data modifications aren't permitted. #### Request {#request-1} ```TEXT Merchant GUID of an existing merchant, such as RMLP2MEE1ICDMW4R ``` #### Expected response {#expected-response-1} ```JSON { "name": "BAG STORE f302ff82-ebef-423c-a6f9-e019d6fdb0c9", "categoryCode": "1234", "orderAvailabilityDateTime": "2021-10-18T13:56:47Z", "orderHistoryMonths": 5, "orderLatencyDays": 13, "industryCode": "AAF", "primaryContact": { "jobTitle": "Manager", "firstName": "Johnf302ff82-ebef-423c-a6f9-e019d6fdb0c9", "lastName": "Doef302ff82-ebef-423c-a6f9-e019d6fdb0c9", "email": "john.doef302ff82-ebef-423c-a6f9-e019d6fdb0c9@example.com", "phone": "1-222-444-1234" }, "legalAddress": { "addressLine1": "123 Street", "addressLine2": "Suite - 456", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M3J1V6", "website": "https://merchantwebsite.example.com/contactus.html", "email": "customerservice.merchant@example.com", "phone": "1-234-567-8901" }, "merchantType": "SUB_MERCHANT", "guid": "9EUSTG3GR5GYEYWU", "status": "CONFIGURATION", "locales": [ { "code": "ES_US", "merchantDescription": "Zapatería formal en Nueva York", "defaultLocale": false }, { "code": "EN_US", "merchantDescription": "Formal bag store in NY", "defaultLocale": true } ], "locations": [ { "addressLine1": "234 Street", "addressLine2": "Suite - 567", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M3J1V6", "website": "https://merchantwebsite.example.com/ca/customerservice.html", "email": "customerservice.merchant.can@example.com", "phone": "1-456-789-0121", "contactWebsite": "https://merchantwebsite.example.com/ca/contactus.html", "displayAddressToCardHolder": true, "displayPhoneToCardHolder": true, "refundPolicy": "45 days from purchase", "terms": "Entire merchant Terms & Conditions", "customerServiceInstructions": "Call helpdesk on phone", "additionalInfo": "check our website for additional information", "termsWebsite": "https://merchantwebsite.example.com/ca/terms.html", "refundPolicyWebsite": "https://merchantwebsite.example.com/ca/refunds.html", "defaultLocation": false, "cardAcceptorNames": [], "cardAcceptorLocation": "STORE 2", "cardAcceptorLocationType": "CARD_PRESENT", "id": "KRvvqudtYMEAMZkHU5EFoA==", "rejectedCardAcceptorNames": [] }, { "addressLine1": "123 Street", "addressLine2": "Suite - 456", "countryCode": "USA", "regionCode": "NY", "city": "New York", "postalCode": "10001", "website": "https://merchantwebsite.example.com/us/customerservice.html", "email": "customerservice.merchant.us@example.com", "phone": "1-234-567-8901", "contactWebsite": "https://merchantwebsite.example.com/us/contactus.html", "displayAddressToCardHolder": true, "displayPhoneToCardHolder": true, "refundPolicy": "30 days from purchase", "terms": "Entire merchant Terms & Conditions, formatted for text display.", "customerServiceInstructions": "email helpdesk", "additionalInfo": "check our store's website", "termsWebsite": "https://merchantwebsite.example.com/us/terms.html", "refundPolicyWebsite": "https://merchantwebsite.example.com/us/refunds.html", "defaultLocation": true, "cardAcceptorNames": [ "BAG STORE F302FF82-EBEF-423C-A6F9-E019D6FDB0C" ], "cardAcceptorLocation": "STORE 1", "cardAcceptorLocationType": "CARD_PRESENT", "id": "zAp2BJOxZW_P-3PlqRNZ4A==", "rejectedCardAcceptorNames": [] } ], "contentTypes": [ "ONLINE_DATING", "ADULT_LANGUAGE" ], "validationStatus": null, "crm": { "termsConditionsConsent": { "date": "2021-10-18T13:56:47Z", "firstName": "John", "lastName": "Smith", "jobTitle": "Security Manager", "email": "john.smith@merchant.com", "countryCode": "CAN", "consentUuid": "3d94ab7b-fe1c-4f7d-ad4c-93c1eb6d29c3", "consentVersion": "10" }, "sanctionScreening": { "taxId": "123", "formerLegalNames": [ "STEP STORE" ], "doBusinessWithSanctionedGeographies": true, "sanctionedGeographies": [ "IRAN" ], "publiclyTraded": true, "tickerSymbol": "SST", "beneficialOwners": [ { "firstName": "Mill", "secondName": "Dan", "lastName": "Jack", "address": { "addressLine1": "234 st", "addressLine2": "111", "countryCode": "CAN", "regionCode": "ON", "city": "Etobicoke", "postalCode": "M2C 5M4" }, "birthCountry": "USA", "birthDate": "1991-06-29", "percentOwnership": "60" } ], "legalEntities": [ { "name": "ABC corp", "dba": "ABC corporation", "address": { "addressLine1": "123 st", "addressLine2": "102", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M1C 5M4" }, "percentOwnership": "50", "governmentOwned": false } ] }, "paymentConfirmation": true, "sanctionScreeningStatus": "IN_PROGRESS", "billingAccountCreated": false, "salesforceAccountNumber": "261713" }, "businessType": "BUSINESS_CORPORATION", "subMerchantIdentifier": "f302ff82-ebef-423c-a6f9-e019d6fdb0c9", "searchFields": [ { "searchParameter": "ACQUIRER_REFERENCE_NUMBER", "required": true, "searchFieldCards": [ "MC" ] }, { "searchParameter": "TRANSACTION_CURRENCY_CODE", "required": false, "searchFieldCards": [ "VISA" ] }, { "searchParameter": "TRANSACTION_IDENTIFIER_VALUE", "required": true, "searchFieldCards": [ "AMEX", "DISCOVER" ] }, { "searchParameter": "CARD_LAST_FOUR", "required": true, "searchFieldCards": [ "VISA" ] }, { "searchParameter": "TRANSACTION_AMOUNT", "required": false, "searchFieldCards": [ "VISA" ] } ] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD3: Update the legalAddress of an existing submerchant {#td3-update-the-legaladdress-of-an-existing-submerchant} Here, you create a `SubMerchant` object and send a request to the `updateSubMerchant` endpoint of the Merchant Self Services API. The API validates and persists the whole `SubMerchant` object, including the updated legal address, and returns a `SubMerchantResource`. #### Request {#request-2} ```JSON { "name": "BAG STORE f302ff82-ebef-423c-a6f9-e019d6fdb0c9", "categoryCode": "1234", "orderAvailabilityDateTime": "2021-10-18T13:56:47Z", "orderHistoryMonths": 5, "orderLatencyDays": 13, "industryCode": "AAF", "primaryContact": { "jobTitle": "Manager", "firstName": "Johnf302ff82-ebef-423c-a6f9-e019d6fdb0c9", "lastName": "Doef302ff82-ebef-423c-a6f9-e019d6fdb0c9", "email": "john.doef302ff82-ebef-423c-a6f9-e019d6fdb0c9@example.com", "phone": "1-222-444-1234" }, "legalAddress": { "addressLine1": "321 new Street", "addressLine2": "Suite - 456", "countryCode": "CAN", "regionCode": "NS", "city": "Halifax", "postalCode": "M3J1V6", "website": "https://merchantwebsite.example.com/contactus.html", "email": "customerservice.merchant@example.com", "phone": "1-234-567-8901" }, "merchantType": "SUB_MERCHANT", "locales": [ { "code": "EN_US", "merchantDescription": "Formal bag store in NY", "defaultLocale": true }, { "code": "ES_US", "merchantDescription": "Zapatería formal en Nueva York", "defaultLocale": false } ], "contentTypes": [ "ONLINE_DATING", "ADULT_LANGUAGE" ], "crm": { "termsConditionsConsent": { "date": "2021-10-18T13:56:47Z", "firstName": "John", "lastName": "Smith", "jobTitle": "Security Manager", "email": "john.smith@merchant.com", "countryCode": "CAN", "consentUuid": "3d94ab7b-fe1c-4f7d-ad4c-93c1eb6d29c3", "consentVersion": "10" }, "sanctionScreening": { "taxId": "123", "formerLegalNames": [ "STEP STORE" ], "doBusinessWithSanctionedGeographies": true, "sanctionedGeographies": [ "IRAN" ], "publiclyTraded": true, "tickerSymbol": "SST", "beneficialOwners": [ { "firstName": "Mill", "secondName": "Dan", "lastName": "Jack", "address": { "addressLine1": "234 st", "addressLine2": "111", "countryCode": "CAN", "regionCode": "ON", "city": "Etobicoke", "postalCode": "M2C 5M4" }, "birthCountry": "USA", "birthDate": "1991-06-29", "percentOwnership": "60" } ], "legalEntities": [ { "name": "ABC corp", "dba": "ABC corporation", "address": { "addressLine1": "123 st", "addressLine2": "102", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M1C 5M4" }, "percentOwnership": "50", "governmentOwned": false } ] }, "paymentConfirmation": true }, "businessType": "BUSINESS_CORPORATION", "subMerchantIdentifier": "f302ff82-ebef-423c-a6f9-e019d6fdb0c9", "searchFields": [ { "searchParameter": "ACQUIRER_REFERENCE_NUMBER", "required": true, "searchFieldCards": [ "MC" ] }, { "searchParameter": "TRANSACTION_AMOUNT", "required": false, "searchFieldCards": [ "VISA" ] }, { "searchParameter": "TRANSACTION_CURRENCY_CODE", "required": false, "searchFieldCards": [ "VISA" ] } ] } ``` #### Expected response {#expected-response-2} ```JSON { "name": "BAG STORE f302ff82-ebef-423c-a6f9-e019d6fdb0c9", "categoryCode": "1234", "orderAvailabilityDateTime": "2021-10-18T13:56:47Z", "orderHistoryMonths": 5, "orderLatencyDays": 13, "industryCode": "AAF", "primaryContact": { "jobTitle": "Manager", "firstName": "Johnf302ff82-ebef-423c-a6f9-e019d6fdb0c9", "lastName": "Doef302ff82-ebef-423c-a6f9-e019d6fdb0c9", "email": "john.doef302ff82-ebef-423c-a6f9-e019d6fdb0c9@example.com", "phone": "1-222-444-1234" }, "legalAddress": { "addressLine1": "321 new Street", "addressLine2": "Suite - 456", "countryCode": "CAN", "regionCode": "NS", "city": "Halifax", "postalCode": "M3J1V6", "website": "https://merchantwebsite.example.com/contactus.html", "email": "customerservice.merchant@example.com", "phone": "1-234-567-8901" }, "merchantType": "SUB_MERCHANT", "guid": "9EUSTG3GR5GYEYWU", "status": "TESTING", "locales": [ { "code": "ES_US", "merchantDescription": "Zapatería formal en Nueva York", "defaultLocale": false }, { "code": "EN_US", "merchantDescription": "Formal bag store in NY", "defaultLocale": true } ], "contentTypes": [ "ONLINE_DATING", "ADULT_LANGUAGE" ], "validationStatus": null, "crm": { "termsConditionsConsent": { "date": "2021-10-18T13:56:47Z", "firstName": "John", "lastName": "Smith", "jobTitle": "Security Manager", "email": "john.smith@merchant.com", "countryCode": "CAN", "consentUuid": "3d94ab7b-fe1c-4f7d-ad4c-93c1eb6d29c3", "consentVersion": "10" }, "sanctionScreening": { "taxId": "123", "formerLegalNames": [ "STEP STORE" ], "doBusinessWithSanctionedGeographies": true, "sanctionedGeographies": [ "IRAN" ], "publiclyTraded": true, "tickerSymbol": "SST", "beneficialOwners": [ { "firstName": "Mill", "secondName": "Dan", "lastName": "Jack", "address": { "addressLine1": "234 st", "addressLine2": "111", "countryCode": "CAN", "regionCode": "ON", "city": "Etobicoke", "postalCode": "M2C 5M4" }, "birthCountry": "USA", "birthDate": "1991-06-29", "percentOwnership": "60" } ], "legalEntities": [ { "name": "ABC corp", "dba": "ABC corporation", "address": { "addressLine1": "123 st", "addressLine2": "102", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M1C 5M4" }, "percentOwnership": "50", "governmentOwned": false } ] }, "paymentConfirmation": true, "sanctionScreeningStatus": "IN_PROGRESS", "billingAccountCreated": false, "salesforceAccountNumber": "261713" }, "businessType": "BUSINESS_CORPORATION", "subMerchantIdentifier": "f302ff82-ebef-423c-a6f9-e019d6fdb0c9", "searchFields": [ { "searchParameter": "ACQUIRER_REFERENCE_NUMBER", "required": true, "searchFieldCards": [ "MC" ] }, { "searchParameter": "TRANSACTION_CURRENCY_CODE", "required": false, "searchFieldCards": [ "VISA" ] }, { "searchParameter": "TRANSACTION_IDENTIFIER_VALUE", "required": true, "searchFieldCards": [ "AMEX", "DISCOVER" ] }, { "searchParameter": "CARD_LAST_FOUR", "required": true, "searchFieldCards": [ "VISA" ] }, { "searchParameter": "TRANSACTION_AMOUNT", "required": false, "searchFieldCards": [ "VISA" ] } ], "locationCount": 0 } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD4: Add a logo to an existing submerchant {#td4-add-a-logo-to-an-existing-submerchant} In this scenario, you create a `MerchantLogo` object by converting a JPG or PNG image to Base64 String and send a request to the `createMerchantLogo` endpoint. The Merchant Self Services API validates and persists the `MerchantLogo` and returns a `LogoResource`. Note that the merchant GUID of an existing merchant must be provided in the URL as a parameter. #### Request {#request-3} ```JSON { "imageBase64Encoded": "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PPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPNOeNPPPPPPPPPPPPPOMucNPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPOPRDH3Lz3fTU9PPPPPOLyQgA4EQADevPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPLHj/ffffffffbc2PPPFsQQwwwwwwwwQANvPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPMaf/AH3333333333331grgEMMMMMMMMMMMMNJDTzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzyfb3333333333333333E84MMMMMMMMMMMMMMMGBHzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz/33333333333333332H776gMMMMMMMMMMMMMMMMf3zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzhb3333333333333333t3/wD/AOiwwwwwwwwwwwwwwwwx9PPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPOEHfffffffffffffffeff/8A/wD/ADgQwwwwwwwwwwwwww04/PPPPPPPPPPPPPPPPPPPPPPPPPPPPPPK3/fffffffffffffffaPP/wD/AP8AzoQwwwwwwwwwwwwwwwwffPPPPPPPPPPPPPPPPPPPPPPPPPPPPPN/fffffffffffffffeVf8A/wD/AP8A/wDLDDDDDDDDDDDDDDDDB0888888888888888888888888888884+9999999999999999s//AP8A/wD/AP8A/qMMMMMMMMMMMMMMMMNXzzzzzzzzzzzzzzzzzzzzzzzzzzzzzx33333333333333333T/wD/AP8A/wD/AP8A+YMMMMMMMMMMMMMMMNBTzzzzzzzzzzzzzzzzzzzzzzzzzzzyr33333333333333333f/AP8A/wD/AP8A/wD/ALBDDDDDDDDDDDDDDDDW8888888888888888888888888888p99999999999999999U//wD/AP8A/wD/AP8ApBDDDDDDDDDDDDDDDDy8888888888888888888888888888m99999999999999999/8A/wD/AP8A/wD/AP8A7gQwwwwwwwwwwwwwwwyvPPPPPPPPPPPPPPPPPPPPPPPPPPPN/ffffffffffffffffd//AP8A/wD/AP8A/wD/AMEMMMMMMMMMMMMMMMOzzzzzzzzzzzzzzzzzzzzzzzzzzzzwP3333333333333333xb/AP8A/wD/AP8A/wD/ANBDDDDDDDDDDDDDDDDJ8888888888888888888888888888u99999999999999999U//wD/AP8A/wD/AP8A6BDDDDDDDDDDDDDDDDd8888888888888888888888888888999999999999999999V//AP8A/wD/AP8A/wDgDDDDDDDDDDDDDDDDD08888888888888888888888888888/V9999999999999999v/8A/wD/AP8A/wD/AOoDDDDDDDDDDDDDDDDC888888888888888888888888888888Z9999999999999999o0/8A/wD/AP8A/wC8MMMMMMMMMMMMMMMMEfzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzrT3333333333333333Hz/wD/AP8A/wDVDDDDDDDDDDDDDDDDHV888888888888888888888888888888se9999999999999999q//wD/AP8A/wCwgwwwwwwwwwwwwwwwX/PPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPGXvfffffffffffffffX9P8A/wD6wDDDDDDDDDDDDDDDDW7038888888888888888888888888888888o39999999999999999/+/wDoQQwwwwwwwwwwwwwwxnfDvvPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPIfPffffffffffffffbUOIAQwwwwwwwwwwwwwwxFvPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPP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" } ``` #### Expected response {#expected-response-3} ```JSON { "status": "APPROVED", "messages": [] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD5: Update logo of an existing submerchant {#td5-update-logo-of-an-existing-submerchant} In this test case, you create a `MerchantLogo` object by converting a JPG or PNG image to Base64 String and send a request to the `updateMerchantLogo` endpoint. The Merchant Self Services API validates and persists the `MerchantLogo` and returns a `LogoResource`. #### Request {#request-4} ```JSON { "imageBase64Encoded": "iVBORw0KGgoAAAANSUhEUgAAAGcAAAAtCAYAAACzgnXzAAAFTUlEQVR42u2Za2xURRiGh95osdrS2+6es7WIAVGbFBUjoLFqqijG6g8xWi9gRa3gvT8Eww+8/ECjUC4SdtsttqgIiRcSohijSCRpVDBK1BCJVsVWdrvVlu5ur7vHd9pvy3S3W6etBhK/N3nSM5eec+Z755uZ0wrBYrFYLBaLxWKxWCwWi8VisVj/Jx0TYqpfGGVeYVb5hLnaKxxVuF6wX4iU2L7H1zszAm5bWY/HWNldb64O1hnLQ25jobVWJHEk/0W1CiMPZtT4hHGyTZhWPMYJtK9pFiLdajBzQx5jI+iCKVYsqPdKs1pdxjSO7CT1h7CXIvi+0U0ZSacz5+fuzQXto5kSh8c8etKTdwFHeIJqE85SLFu9OsZ02PKsSMUUK/JgstXzms3SM8ho63AVns+RHn/G5CNj2nSM8ac5rPCSZMtaKgYJP5omA69pkHkE+1DKaR7uhWDRGWhDKvCBq0fUnhDGZh1jJKHLM4eNidL3YraeOaDHY1ad5iA8C46coeZYoGy4plnMSPcKo0sra5KMSPjOpDhzBrNH05yQx/x2jBd8GNwFXgK76NoGNoCdYGlM//uo30bKhueVtgfAm+B1sAJMo9//nGboKzH9bwJ1YCu4VKlfC24F9WAN1c0Am8Buas+l+otBLXgLXAteBhdRm3xeOdgBHqO6ufRM+Z7XxZmDI/Ii3azptOcOxBoTJeRyBPUMMiKh2hxnAnM+Bn2gEbxBL9tCxmwHYXAP9V0HQsBFg+sF7dRWCYLgBQrQAZAFVoJD1M9DAZa6HwRoUrhBDygZDpHckocmQAWYDbrAQfAq+AYspEB3g09ADfgNRMAtdB85lt+pTdbNp3f+iOpa4szxC/sjuuYE5mT1JzKnZ1N+q272dNXbS8cw5z2l/AXVqe0yE6aDfrBMaVunmPMcBbWC9pgp/7CsHaXsLCI+owyImrNK6SvNOxxzT6l3wH6lPGcUcyqV9g/BB0r5kjhz8D2zStuc4nMSm7Mh77iuOUGPUT6GOTVK+X0lSIIyahctH3IgxUrb7Yo50rwGWr5kv++BYwxzAoPzdGi2R9mpmKNOgn20FMXqK1q6Yu+rmrNYafuOMjuqJJpwZephoFLXnK5Z2YnN2VLg1d536p1XTNCcHWROBuhQBicH9naMOWl0XURL3HIqV4Of6Do6+5tinmMo17HmyKXvF3qGUPYbN02CTCovJkMSmSPH8jXthdHJNTJzWoVjnq45f03PD49qzjJhddcZvZrm9P7pmpk1ycyRupf2J7nm/0hBjJqzZXBoQuylpVEaOYva5tNyc5iCLIN5FegEX4JPac+5MoE5OeAH2ocOUnbcTJnZPDjfh8xuoT0ykTnnyr980Xs2jbrnyNmDj89f9QwyIgO3pcSZM1CdoX1awzfRvjFOa6W0sUYlAzRPKcuMW6CUiykT7gYz6VQllUyBeIpObbaY58h7PE2np2SqM6mvPNldpvQtp9OZqqn0zGo65UUz8GzK0CeAk7IhmoVLlKU1qmzwEHic+t0R9644Sq/QXtpmZ8eZ07s+T9+cWvs1/Nk/DiGXUnzCbNI1qO/GtFNZ88xZ4/nGaeRoT0A+kW9H4I/pmNOebrf6y1Ot8JPpyARD0xjjgLVdpHOkJ6hO4cxB8Pfq7D3+zIKtIbexR8OYcLDO3GbtHj49sSYj7EHX4/vnXRgRUE3B0ufHz0ac8IY3zB6P44ZQvbEn7n86HtMPGgJucy5H9D/QISFS20VOoVcUlLQLo9CK/yo+tW+5RGpHre28wDazJOgqcvB/QVksFovFYrFYLBaLxWKxWCwWizVCfwO7yO7964UegwAAAABJRU5ErkJggg\u003d\u003d" } ``` #### Expected response {#expected-response-4} ```JSON { "status": "APPROVED", "messages": [] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD6: Get logo of an existing submerchant {#td6-get-logo-of-an-existing-submerchant} In this test case, you send a request to the `getLogoByMerchantGuid` endpoint. The Merchant Self Services API validates the request and returns a `LogoImageResource`. * The merchant GUID of an existing merchant must be provided in the URL as a parameter. * This is a GET request and doesn't have a request body. Provide the GUID in the URL. #### Request {#request-5} ```TEXT Merchant GUID of an existing merchant, such as JkaGSDZ30yMckrtZ ``` #### Expected response {#expected-response-5} ```JSON { "status": "APPROVED", "messages": [], "imageBase64Encoded": "iVBORw0KGgoAAAANSUhEUgAAAGcAAAAtCAYAAACzgnXzAAAFTUlEQVR42u2Za2xURRiGh95osdrS2+6es7WIAVGbFBUjoLFqqijG6g8xWi9gRa3gvT8Eww+8/ECjUC4SdtsttqgIiRcSohijSCRpVDBK1BCJVsVWdrvVlu5ur7vHd9pvy3S3W6etBhK/N3nSM5eec+Z755uZ0wrBYrFYLBaLxWKxWCwWi8VisVj/Jx0TYqpfGGVeYVb5hLnaKxxVuF6wX4iU2L7H1zszAm5bWY/HWNldb64O1hnLQ25jobVWJHEk/0W1CiMPZtT4hHGyTZhWPMYJtK9pFiLdajBzQx5jI+iCKVYsqPdKs1pdxjSO7CT1h7CXIvi+0U0ZSacz5+fuzQXto5kSh8c8etKTdwFHeIJqE85SLFu9OsZ02PKsSMUUK/JgstXzms3SM8ho63AVns+RHn/G5CNj2nSM8ac5rPCSZMtaKgYJP5omA69pkHkE+1DKaR7uhWDRGWhDKvCBq0fUnhDGZh1jJKHLM4eNidL3YraeOaDHY1ad5iA8C46coeZYoGy4plnMSPcKo0sra5KMSPjOpDhzBrNH05yQx/x2jBd8GNwFXgK76NoGNoCdYGlM//uo30bKhueVtgfAm+B1sAJMo9//nGboKzH9bwJ1YCu4VKlfC24F9WAN1c0Am8Buas+l+otBLXgLXAteBhdRm3xeOdgBHqO6ufRM+Z7XxZmDI/Ii3azptOcOxBoTJeRyBPUMMiKh2hxnAnM+Bn2gEbxBL9tCxmwHYXAP9V0HQsBFg+sF7dRWCYLgBQrQAZAFVoJD1M9DAZa6HwRoUrhBDygZDpHckocmQAWYDbrAQfAq+AYspEB3g09ADfgNRMAtdB85lt+pTdbNp3f+iOpa4szxC/sjuuYE5mT1JzKnZ1N+q272dNXbS8cw5z2l/AXVqe0yE6aDfrBMaVunmPMcBbWC9pgp/7CsHaXsLCI+owyImrNK6SvNOxxzT6l3wH6lPGcUcyqV9g/BB0r5kjhz8D2zStuc4nMSm7Mh77iuOUGPUT6GOTVK+X0lSIIyahctH3IgxUrb7Yo50rwGWr5kv++BYwxzAoPzdGi2R9mpmKNOgn20FMXqK1q6Yu+rmrNYafuOMjuqJJpwZephoFLXnK5Z2YnN2VLg1d536p1XTNCcHWROBuhQBicH9naMOWl0XURL3HIqV4Of6Do6+5tinmMo17HmyKXvF3qGUPYbN02CTCovJkMSmSPH8jXthdHJNTJzWoVjnq45f03PD49qzjJhddcZvZrm9P7pmpk1ycyRupf2J7nm/0hBjJqzZXBoQuylpVEaOYva5tNyc5iCLIN5FegEX4JPac+5MoE5OeAH2ocOUnbcTJnZPDjfh8xuoT0ykTnnyr980Xs2jbrnyNmDj89f9QwyIgO3pcSZM1CdoX1awzfRvjFOa6W0sUYlAzRPKcuMW6CUiykT7gYz6VQllUyBeIpObbaY58h7PE2np2SqM6mvPNldpvQtp9OZqqn0zGo65UUz8GzK0CeAk7IhmoVLlKU1qmzwEHic+t0R9644Sq/QXtpmZ8eZ07s+T9+cWvs1/Nk/DiGXUnzCbNI1qO/GtFNZ88xZ4/nGaeRoT0A+kW9H4I/pmNOebrf6y1Ot8JPpyARD0xjjgLVdpHOkJ6hO4cxB8Pfq7D3+zIKtIbexR8OYcLDO3GbtHj49sSYj7EHX4/vnXRgRUE3B0ufHz0ac8IY3zB6P44ZQvbEn7n86HtMPGgJucy5H9D/QISFS20VOoVcUlLQLo9CK/yo+tW+5RGpHre28wDazJOgqcvB/QVksFovFYrFYLBaLxWKxWCwWizVCfwO7yO7964UegwAAAABJRU5ErkJggg==" } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD7: Delete logo of an existing submerchant {#td7-delete-logo-of-an-existing-submerchant} Here, you send a request to the `deleteLogoByMerchantGuid` endpoint to delete a merchant logo. The Merchant Self Services API validates the request and deletes the merchant logo. * The merchant GUID of an existing merchant must be provided in the URL as a parameter. * This is a DELETE request and doesn't have a request body. Provide the GUID in the URL. #### Request {#request-6} ```TEXT Merchant GUID of an existing merchant, such as JkaGSDZ30yMckrtZ ``` #### Expected response {#expected-response-6} ```TEXT HTTP 204 No Content No body returned for response ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD8: Add locations to an existing submerchant {#td8-add-locations-to-an-existing-submerchant} For this test case, you send a request to the `addLocations` endpoint. The request body contains a set of two unique locations: one default location and one non-default location. The Merchant Self Services API validates the request and returns a response containing a list of two items with the corresponding `locationId` and returns the status `PASS`. Note that the merchant GUID of an existing merchant must be provided in the URL as a parameter. #### Request {#request-7} ```JSON { "locations": [ { "addressLine1": "223 Blythwood Rd", "addressLine2": "Suite 123", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M4N1A7", "website": "https://merchantwebsite.example.com/customerservice.html", "email": "john.doe@example.com", "phone": "1-234-567-9999", "contactWebsite": "https://merchantwebsite.example.com/contactus.html", "displayAddressToCardHolder": true, "displayPhoneToCardHolder": true, "refundPolicy": "Complete merchant refund policy", "terms": "Entire merchant Terms & Conditions", "customerServiceInstructions": "Include Transaction ID in all communications.", "additionalInfo": "Customers can contact merchants for a refund 24 hours a day.", "termsWebsite": "https://merchantwebsite.example.com/terms.html", "refundPolicyWebsite": "https://merchantwebsite.example.com/refunds.html", "defaultLocation": true, "cardAcceptorLocation": "Store 123", "cardAcceptorLocationType": "CARD_PRESENT" }, { "addressLine1": "223 Blythwood Rd", "addressLine2": "Suite 123", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M4N1A7", "website": "https://merchantwebsite.example.com/customerservice1.html", "email": "john1.doe1@example.com", "phone": "1-234-567-9999", "contactWebsite": "https://merchantwebsite.example.com/contactus.html", "displayAddressToCardHolder": true, "displayPhoneToCardHolder": true, "refundPolicy": "Complete merchant refund policy", "terms": "Entire merchant Terms & Conditions", "customerServiceInstructions": "Include Transaction ID in all communications.", "additionalInfo": "Customers can contact merchants for a refund 24 hours a day.", "termsWebsite": "https://merchantwebsite.example.com/terms.html", "refundPolicyWebsite": "https://merchantwebsite.example.com/refunds.html", "defaultLocation": false, "cardAcceptorLocation": "Store 123", "cardAcceptorLocationType": "CARD_PRESENT" } ] } ``` #### Expected response {#expected-response-7} ```JSON { "locations": [ { "id": "Mxyz123", "status": "PASS" }, { "id": "Mxyz321", "status": "PASS" } ] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD9: Get all locations of an existing submerchant {#td9-get-all-locations-of-an-existing-submerchant} In this scenario, you send a request to the `getAllLocations` endpoint. The Merchant Self Services API validates the request and returns a pageable response including all locations of the submerchant. #### Request {#request-8} ```TEXT Merchant GUID of an existing merchant, such as JkaGSDZ30yMckrtZ ``` #### Expected response {#expected-response-8} ```JSON { "data": [ { "addressLine1": "223 Blythwood Rd", "addressLine2": "Suite 123", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M4N1A7", "website": "https://merchantwebsite.example.com/customerservice.html", "email": "john.doe@example.com", "phone": "1-234-567-9999", "contactWebsite": "https://merchantwebsite.example.com/contactus.html", "displayAddressToCardHolder": true, "displayPhoneToCardHolder": true, "refundPolicy": "Complete merchant refund policy", "terms": "Entire merchant Terms & Conditions", "customerServiceInstructions": "Include Transaction ID in all communications.", "additionalInfo": "Customers can contact merchants for a refund 24 hours a day.", "termsWebsite": "https://merchantwebsite.example.com/terms.html", "refundPolicyWebsite": "https://merchantwebsite.example.com/refunds.html", "defaultLocation": true, "cardAcceptorLocation": "Pan American Airlines Canada", "cardAcceptorLocationType": "ONLINE", "id": "Mxyz123" } ], "metadata": { "totalRecords": 500, "totalPages": 10, "currentPage": 2, "responseTime": "300 ms" } } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD10: Get a location by ID {#td10-get-a-location-by-id} In this test case, you send a request to the `getLocationById` endpoint. The Merchant Self Services API validates the request and returns a `LocationWithoutCardAcceptorsResource`. #### Request {#request-9} ```TEXT LocationId - Mzyz123, Merchant GUID of an existing merchant, such as JkaGSDZ30yMckrtZ ``` #### Expected response {#expected-response-9} ```JSON { "addressLine1": "223 Blythwood Rd", "addressLine2": "Suite 123", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M4N1A7", "website": "https://merchantwebsite.example.com/customerservice.html", "email": "john.doe@example.com", "phone": "1-234-567-9999", "contactWebsite": "https://merchantwebsite.example.com/contactus.html", "displayAddressToCardHolder": true, "displayPhoneToCardHolder": true, "refundPolicy": "Complete merchant refund policy", "terms": "Entire merchant Terms & Conditions", "customerServiceInstructions": "Include Transaction ID in all communications.", "additionalInfo": "Customers can contact merchants for a refund 24 hours a day.", "termsWebsite": "https://merchantwebsite.example.com/terms.html", "refundPolicyWebsite": "https://merchantwebsite.example.com/refunds.html", "defaultLocation": true, "cardAcceptorLocation": "Pan American Airlines Canada", "cardAcceptorLocationType": "ONLINE", "id": "Mxyz123" } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD11: Update location of an existing submerchant {#td11-update-location-of-an-existing-submerchant} Here, you send a request to the `updateLocation` endpoint. The Merchant Self Services API validates the request and persists the location and returns a `LocationWithoutCardAcceptorsResource`. #### Request {#request-10} ```JSON { "addressLine1": "223 Blythwood Rd", "addressLine2": "Suite 123", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M4N1A7", "website": "https://merchantwebsite.example.com/customerservice.html", "email": "john.doe@example.com", "phone": "1-234-567-9999", "contactWebsite": "https://merchantwebsite.example.com/contactus.html", "displayAddressToCardHolder": true, "displayPhoneToCardHolder": true, "refundPolicy": "Complete merchant refund policy", "terms": "Entire merchant Terms & Conditions", "customerServiceInstructions": "Include Transaction ID in all communications.", "additionalInfo": "Customers can contact merchants for a refund 24 hours a day.", "termsWebsite": "https://merchantwebsite.example.com/terms.html", "refundPolicyWebsite": "https://merchantwebsite.example.com/refunds.html", "defaultLocation": true, "cardAcceptorLocation": "Pan American Airlines Canada", "cardAcceptorLocationType": "CARD_PRESENT" } ``` #### Expected response {#expected-response-10} ```JSON { "addressLine1": "223 Blythwood Rd", "addressLine2": "Suite 123", "countryCode": "CAN", "regionCode": "ON", "city": "Toronto", "postalCode": "M4N1A7", "website": "https://merchantwebsite.example.com/customerservice.html", "email": "john.doe@example.com", "phone": "1-234-567-9999", "contactWebsite": "https://merchantwebsite.example.com/contactus.html", "displayAddressToCardHolder": true, "displayPhoneToCardHolder": true, "refundPolicy": "Complete merchant refund policy", "terms": "Entire merchant Terms & Conditions", "customerServiceInstructions": "Include Transaction ID in all communications.", "additionalInfo": "Customers can contact merchants for a refund 24 hours a day.", "termsWebsite": "https://merchantwebsite.example.com/terms.html", "refundPolicyWebsite": "https://merchantwebsite.example.com/refunds.html", "defaultLocation": true, "cardAcceptorLocation": "Pan American Airlines Canada", "cardAcceptorLocationType": "ONLINE", "id": "Mxyz123" } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD12: Delete location of an existing submerchant {#td12-delete-location-of-an-existing-submerchant} In this scenario, you send a request to the `deleteLocation` endpoint. The Merchant Self Services API validates the request and deletes the location. #### Request {#request-11} ```TEXT LocationId - Mzyz123, Merchant GUID of an existing merchant, such as JkaGSDZ30yMckrtZ ``` #### Expected response {#expected-response-11} ```TEXT HTTP 204 No Content No body returned for response ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD13: Add acquirer reference IDs to an existing submerchant default location {#td13-add-acquirer-reference-ids-to-an-existing-submerchant-default-location} Here, you send a request to the `addAcquirerMerchantIds` endpoint. The Merchant Self Services API validates the request and returns a response containing accepted and rejected Acquirer Reference ID/Card Acceptor ID pairs. Note that the merchant GUID of an existing merchant and the `LocationId` must be provided in the URL as parameters. #### Request {#request-12} ```JSON { "acquirerMerchantIds": [ { "acquirerReferenceId": "302681", "cardAcceptorId": "SAVj3du2EQRxljj" }, { "acquirerReferenceId": "538001", "cardAcceptorId": "e8LTlEG1nsTe8yj" }, { "acquirerReferenceId": "282204", "cardAcceptorId": "oVF9WevqaoNg03P" } ] } ``` #### Expected response {#expected-response-12} ```JSON { "acceptedIds": [ { "acquirerReferenceId": "282204", "cardAcceptorId": "oVF9WevqaoNg03P", "id": "qpAQoWo1TmjMwULEWvDVbw==" }, { "acquirerReferenceId": "302681", "cardAcceptorId": "SAVj3du2EQRxljj", "id": "06bJBTD3ODCoPfloxU_WpA==" }, { "acquirerReferenceId": "538001", "cardAcceptorId": "e8LTlEG1nsTe8yj", "id": "NowhRMpUjM4sLUqnWZ5ObA==" } ], "rejectedIds": [] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD14: Get accepted Acquirer Reference ID - Card Acceptor ID pairs {#td14-get-accepted-acquirer-reference-id---card-acceptor-id-pairs} For this test case, you want to retrieve only the accepted Acquirer Reference ID/Card Acceptor ID pairs by sending a request to the `getAcceptedAcquirerMerchantIds` endpoint. The Merchant Self Services API validates the request and returns a pageable response containing accepted Acquirer Reference ID/Card Acceptor ID pairs only. #### Request {#request-13} GET request sent to the `getAcceptedAcquirerMerchantIds` endpoint. #### Expected response {#expected-response-13} ```JSON { "data": [ { "acquirerReferenceId": "282204", "cardAcceptorId": "oVF9WevqaoNg03P", "id": "qpAQoWo1TmjMwULEWvDVbw==" }, { "acquirerReferenceId": "302681", "cardAcceptorId": "SAVj3du2EQRxljj", "id": "06bJBTD3ODCoPfloxU_WpA==" }, { "acquirerReferenceId": "538001", "cardAcceptorId": "e8LTlEG1nsTe8yj", "id": "NowhRMpUjM4sLUqnWZ5ObA==" } ], "metadata": { "totalRecords": 3, "totalPages": 1, "currentPage": 0, "responseTime": "14 ms" } } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD15: Delete existing Acquirer Reference ID - Card Acceptor ID pair {#td15-delete-existing-acquirer-reference-id---card-acceptor-id-pair} Here, you want to delete an accepted Acquirer Reference ID/Card Acceptor ID pair by sending a request to the `deleteAcceptedAcquirerMerchantId` endpoint. The Merchant Self Services API validates the request, deletes the accepted Acquirer Reference ID/Card Acceptor ID pair, and returns a 204 response code. #### Request {#request-14} DELETE request sent to the `deleteAcceptedAcquirerMerchantId` endpoint. #### Expected response {#expected-response-14} HTTP 204 No Content No body returned for response [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD16: Add card acceptor names to an existing submerchant default location {#td16-add-card-acceptor-names-to-an-existing-submerchant-default-location} In this scenario, you send a request to the `addCardAcceptorNames` endpoint. The request body contains an unique set of card acceptor names. The Merchant Self Services API validates the request and returns a response containing a set of accepted card acceptor names with the corresponding `cardAcceptorId` and returns a status of `PASS`. Note that the merchant GUID of an existing merchant and the `LocationId` must be provided in the URL as parameters. #### Request {#request-15} ```JSON { "cardAcceptorNames": [ { "matchType": "STARTS_WITH", "cardAcceptorName": "ETHOCA NINJA GAMES" }, { "matchType": "STARTS_WITH", "cardAcceptorName": "ETHOCA CARD ACCEPTOR" } ] } ``` #### Expected response {#expected-response-15} ```JSON { "cardAcceptorNames": [ { "id": "xyz123", "status": "PASS" }, { "id": "xyz321", "status": "PASS" } ] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD17: Get all card acceptor names of a submerchant location {#td17-get-all-card-acceptor-names-of-a-submerchant-location} In this test case, you send a request to the `getCardAcceptorNames` endpoint. The Merchant Self Services API validates the request and returns a pageable response of all card acceptor names under a location. #### Request {#request-16} ```TEXT LocationId - Mzyz123, Merchant GUID of an existing merchant, such as JkaGSDZ30yMckrtZ ``` #### Expected response {#expected-response-16} ```JSON { "data": [ { "matchType": "EXACT", "cardAcceptorName": "ETHOCA NINJA GAMES", "id": "Mxyz123", "status": "PENDING" } ], "metadata": { "totalRecords": 500, "totalPages": 10, "currentPage": 2, "responseTime": "300 ms" } } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD18: Get a card acceptor name by ID {#td18-get-a-card-acceptor-name-by-id} Here, you send a request to the `getCardAcceptorNameById` endpoint. The Merchant Self Services API validates the request and returns a `CardAcceptorDataResource`. #### Request {#request-17} ```TEXT LocationId - Mzyz123, Merchant GUID of an existing merchant, such as JkaGSDZ30yMckrtZ ``` #### Expected response {#expected-response-17} ```JSON { "matchType": "EXACT", "cardAcceptorName": "ETHOCA NINJA GAMES", "id": "Mxyz123", "status": "PENDING" } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD19: Update a card acceptor name {#td19-update-a-card-acceptor-name} In this scenario, you send a request to the `updateCardAcceptorNameById` endpoint. The Merchant Self Services API validates the request, persists the card acceptor name, and returns a `CardAcceptorDataResource`. #### Request {#request-18} ```JSON { "matchType": "EXACT", "cardAcceptorName": "ETHOCA NINJA GAMES" } ``` #### Expected response {#expected-response-18} ```JSON { "matchType": "EXACT", "cardAcceptorName": "ETHOCA NINJA GAMES", "id": "Mxyz123", "status": "PENDING" } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD20: Delete a card acceptor name {#td20-delete-a-card-acceptor-name} For this test case, you send a request to the `deleteCardAcceptorNameById` endpoint. The Merchant Self Services API validates the request and deletes the `cardAcceptorName`. #### Request {#request-19} ```TEXT LocationId - Mzyz123, Merchant GUID of an existing merchant, such as JkaGSDZ30yMckrtZ ``` #### Expected response {#expected-response-19} ```TEXT HTTP 204 No Content No body returned for response ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD21: Add descriptors to an existing submerchant location {#td21-add-descriptors-to-an-existing-submerchant-location} Here, you send a request to the `addDescriptors` endpoint that contains a list of descriptors and their type. The Merchant Self Services API validates the request and returns a response containing a list of descriptors with their corresponding IDs. Note that the merchant GUID of an existing merchant and the `LocationId` must be provided in the URL as parameters. #### Request {#request-20} ```JSON { "descriptors": [ { "descriptor": "ETHOCA HOTEL GROUP" } ], "type": "CARD_ACCEPTOR_NAME" } ``` #### Expected response {#expected-response-20} ```JSON { "descriptors": [ { "descriptor": "ETHOCA HOTEL GROUP", "id": "Mxyz123" } ] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD22: Get all descriptors of a submerchant location {#td22-get-all-descriptors-of-a-submerchant-location} In this test case, you send a request to the `getDescriptors` endpoint. The Merchant Self Services API validates the request and returns a pageable response of all descriptors under a location. #### Request {#request-21} ```TEXT LocationId - Mzyz123, Merchant GUID of an existing merchant, such as JkaGSDZ30yMckrtZ ``` #### Expected response {#expected-response-21} ```JSON { "data": [ { "descriptor": "ETHOCA HOTEL GROUP", "id": "Mxyz123" } ], "metadata": { "totalRecords": 500, "totalPages": 10, "currentPage": 2, "responseTime": "300 ms" } } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD23: Delete the raw descriptor of a submerchant {#td23-delete-the-raw-descriptor-of-a-submerchant} For this scenario, you send a request to the `deleteRawDescriptor` endpoint. The Merchant Self Services API validates the request and deletes the specified descriptor. #### Request {#request-22} ```TEXT LocationId - Mzyz123, Merchant GUID of an existing merchant, such as JkaGSDZ30yMckrtZ ``` #### Expected response {#expected-response-22} ```TEXT HTTP 204 No Content No body returned for response ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD24: Deactivate an existing merchant {#td24-deactivate-an-existing-merchant} Here, you send a request to the `changeSubMerchantState` endpoint. The Merchant Self Services API validates the request and deactivates (or activates) the merchant. #### Request {#request-23} ```JSON { "state": "INACTIVE", "inactivationReason": "My business is closing" } ``` #### Expected response {#expected-response-23} ```TEXT HTTP 204 No Content No body returned for response ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD25: Add only invalid card acceptor names to an existing submerchant default location {#td25-add-only-invalid-card-acceptor-names-to-an-existing-submerchant-default-location} In this scenario, you send a request to the `addCardAcceptorNames` endpoint that contains card acceptor names that are already associated with another merchant and are all invalid. The Merchant Self Services API validates and persists the card acceptor names and returns a response containing a set of accepted card acceptor names with the corresponding `cardAcceptorId`, and returns a status of `FAILED`. #### Request {#request-24} ```JSON { "cardAcceptorNames": [ { "matchType": "STARTS_WITH", "cardAcceptorName": "ETHOCA NINJA GAMES" }, { "matchType": "STARTS_WITH", "cardAcceptorName": "ETHOCA CARD ACCEPTOR" } ] } ``` #### Expected response {#expected-response-24} ```JSON { "cardAcceptorNames": [ { "id": "xyz125", "errors": [ { "Source": "service", "ReasonCode": "invalid data: cardAcceptorNames[].cardAcceptorName", "Description": "Card acceptor name ETHOCA NINJA GAMES is not available", "Recoverable": false, "Details": null } ], "status": "FAILED" }, { "id": "xyz325", "errors": [ { "Source": "service", "ReasonCode": "invalid data: cardAcceptorNames[].cardAcceptorName", "Description": "Card acceptor name ETHOCA CARD ACCEPTOR is not available", "Recoverable": false, "Details": null } ], "status": "FALED" } ] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD26: Add card acceptor names to an existing submerchant default location with at least one valid card acceptor name {#td26-add-card-acceptor-names-to-an-existing-submerchant-default-location-with-at-least-one-valid-card-acceptor-name} For this test case, you send a request to the `addCardAcceptorNames` endpoint that contains one valid card acceptor name. It also contains other card acceptor names that are already associated with another merchant. The Merchant Self Services API validates and persists the card acceptor names. Duplicate card acceptor names are returned with a status of `FAILED` in the response and the others with a status of `PASS`. #### Request {#request-25} ```JSON { "cardAcceptorNames": [ { "matchType": "STARTS_WITH", "cardAcceptorName": "ETHOCA NINJA GAMES" }, { "matchType": "STARTS_WITH", "cardAcceptorName": "new CARD ACCEPTOR" } ] } ``` #### Expected response {#expected-response-25} ```JSON { "cardAcceptorNames": [ { "id": "xyz125", "errors": [ { "Source": "service", "ReasonCode": "invalid data: cardAcceptorNames[].cardAcceptorName", "Description": "Card acceptor name ETHOCA NINJA GAMES is not available", "Recoverable": false, "Details": null } ], "status": "FAILED" }, { "id": "xyz555", "status": "PASS" } ] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD27: Add an AcquirerMerchant object with one invalid Acquirer Reference ID - Card Acceptor ID pair {#td27-add-an-acquirermerchant-object-with-one-invalid-acquirer-reference-id---card-acceptor-id-pair} Here, you create an `AcquirerMerchant` object with an Acquirer Reference ID/Card Acceptor ID pair that's already associated with another merchant and send a request to the `addAcquirerMerchantIds` endpoint. The Merchant Self Services API validates the request and returns a response containing an empty list of `acceptedIds`. Duplicate Acquirer Reference ID/Card Acceptor ID pairs are added to the list of `rejectedIds` in the response. #### Request {#request-26} ```JSON { "acquirerMerchantIds": [ { "acquirerReferenceId": "302681", "cardAcceptorId": "SAVj3du2EQRxljj" } ] } ``` #### Expected response {#expected-response-26} ```JSON { "acceptedIds": [], "rejectedIds": [ { "acquirerReferenceId": "282204", "cardAcceptorId": "oVF9WevqaoNg03P", "id": "qpAQoWo1TmjMwULEWvDVbw==" } ] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ### TD28: Add an AcquirerMerchant object with one valid and one invalid Acquirer Reference ID - Card Acceptor ID pair {#td28-add-an-acquirermerchant-object-with-one-valid-and-one-invalid-acquirer-reference-id---card-acceptor-id-pair} In this test case, you create an `AcquirerMerchant` object with a new Acquirer Reference ID/Card Acceptor ID pair and another one that's already associated with another merchant and you send a request to the `addAcquirerMerchantIds` endpoint. The Merchant Self Services API validates and persists the valid Acquirer Reference ID/Card Acceptor ID pair and adds it to the `acceptedIds` in the response. Any duplicate Acquirer Reference ID/Card Acceptor ID pairs are added to the list of `rejectedIds` in the response. #### Request {#request-27} ```JSON { "acquirerMerchantIds": [ { "acquirerReferenceId": "302681", "cardAcceptorId": "SAVj3du2EQRxljj" }, { "acquirerReferenceId": "538001", "cardAcceptorId": "e8LTlEG1nsTe8yj" }, { "acquirerReferenceId": "282204", "cardAcceptorId": "oVF9WevqaoNg03P" } ] } ``` #### Expected response {#expected-response-27} ```JSON { "acceptedIds": [ { "acquirerReferenceId": "302681", "cardAcceptorId": "SAVj3du2EQRxljj", "id": "06bJBTD3ODCoPfloxU_WpA==" }, { "acquirerReferenceId": "538001", "cardAcceptorId": "e8LTlEG1nsTe8yj", "id": "NowhRMpUjM4sLUqnWZ5ObA==" } ], "rejectedIds": [ { "acquirerReferenceId": "282204", "cardAcceptorId": "oVF9WevqaoNg03P", "id": "qpAQoWo1TmjMwULEWvDVbw==" } ] } ``` [Back to top](https://developer.mastercard.com/merchant-self-services/documentation/testing/clarity-test-cases/index.md#test-data) ## Next Steps {#next-steps} * [API Reference](https://developer.mastercard.com/merchant-self-services/documentation/api-reference/index.md#apis) provides details about all of the fields and values in the Merchant Self Services API. * See [Code and Formats](https://developer.mastercard.com/merchant-self-services/documentation/code-and-formats/index.md) for detailed information about error response handling.