Allows registered partners to search only specific merchant participation information.

POST {{baseUrl}}/merchants/mids/searches?offset=100&limit=100

Allows registered partners to search mids for a given merchant. A combination of merchantLegalName, countryCode, and acquirerICA is required in the request. In the case of countries where merchant data is classified as PII, the data pertaining to merchantLegalName must be encrypted, and the encrypted values should be assigned to the 'encryptedMerchantLegalName' field. For countries where merchant data is not classified as PII, there is no need to populate the 'encryptedMerchantLegalName' field. Instead, populate the individual fields, namely merchantLegalName.

Please refer to request and response specification for more details. The encryption needs to be performed using JWE payload encryption. Please refer to the Securing Sensitive Data Using Payload Encryption sections for implementation details.

Request Params

KeyDatatypeRequiredDescription
offsetnumberDetermines the number of items needed in the start of the list, to retrieve the list starting from the offset.
limitnumberControls the maximum number of items in the list.

Request Body

{"merchantLegalName"=>"Example Mart", "countryCode"=>"USA", "acquirerICA"=>"00689425761"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{"merchantLegalName":"Example Mart","acquirerICA":"00689425761","countryCode":"USA","nonMerchantNegotiatedParticipation":"Y","mids":[{"mid":"987123456789124","status":"COMPLETED"},{"mid":"123123456789124","status":"COMPLETED"},{"mid":"567123456789124","status":"COMPLETED"}]}