##### Retrieves terminated merchant information based on the criteria defined in the API request.
POST {{baseUrl}}/termination-inquiry?PageOffset=0&PageLength=10&Format=JSON&ExtraFields=occaecat mollit dolor consectetur
Returns information on merchants that have been terminated and merchants which have been inquired upon. MATCH can provide the acquiring bank with information if a Merchant has been terminated by another acquirer already, the reason for termination, the history of fraudulent or risky business practices that led to that termination and the inquiry that was made already on the Merchant or individual by own or another acquiring bank. The response also includes an inquiry reference number to be used for future reference in Termination Inquiry History Request API. For further details refer the documentation on Use Cases.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
PageOffset | number | (Required) The zero-based offset to start at. The actual start position is this value +1. An offset of 10 starts at item 11. Combined with the PageLength option this allows pagination to be supported through the service requests. | |
PageLength | number | (Required) The maximum number of items to retrieve within the current "page" of results. | |
Format | string | (Required) Describes format of the response you wants to serverd, response can be delevired either as XML or JSON. | |
ExtraFields | string | Describes Extra fields of the response you wants to serverd, Fields like comments can be in response if this param is passed as true. |
Request Body
{"TerminationInquiryRequest"=>{"AcquirerId"=>"1996", "Merchant"=>{"Name"=>"THE BAIT SHOP", "DoingBusinessAsName"=>"BAIT R US", "Address"=>{"Line1"=>"42 ELM AVENUE", "City"=>"DALLAS", "Country"=>"USA", "PostalCode"=>"66579", "Line2"=>"SUITE 201", "CountrySubdivision"=>"IL", "Province"=>"US"}, "PhoneNumber"=>"3165557625", "AltPhoneNumber"=>"3165557625", "NationalTaxId"=>"888596927", "CountrySubdivisionTaxId"=>"492321030", "ServiceProvLegal"=>"XYZ FINANCIAL SERVICE INCORPORATED", "ServiceProvDBA"=>"XYZ FINANCIAL SERVICE", "Url"=>["www.testmerchant.com", "www.testmerchant.com"], "Principal"=>[{"FirstName"=>"DAVID", "LastName"=>"SMITH", "MiddleInitial"=>"P", "Address"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "PhoneNumber"=>"3165557625", "AltPhoneNumber"=>"3165557625", "NationalId"=>"541022104", "DriversLicense"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}, {"FirstName"=>"DAVID", "LastName"=>"SMITH", "MiddleInitial"=>"P", "Address"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "PhoneNumber"=>"3165557625", "AltPhoneNumber"=>"3165557625", "NationalId"=>"541022104", "DriversLicense"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}], "SearchCriteria"=>{"SearchAll"=>"N", "Region"=>["A", "A"], "Country"=>["USA", "USA"], "MinPossibleMatchCount"=>"3"}, "AddedOnDate"=>"10/13/2015", "TerminationReasonCode"=>"13", "AddedByAcquirerID"=>"1234", "UrlGroup"=>[{"ExactMatchUrls"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "CloseMatchUrls"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "NoMatchUrls"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}, {"ExactMatchUrls"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "CloseMatchUrls"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "NoMatchUrls"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}], "Comments"=>"Added for reasons of fraud"}}}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"TerminationInquiry":{"PageOffset":0,"Ref":"https://api.mastercard.com/fraud/merchant/v3/termination-inquiry/1234567890","TransactionReferenceNumber":"12345","PossibleMerchantMatches":[{"TotalLength":2,"TerminatedMerchant":[{"Merchant":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"MerchantMatch":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"Merchant":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"MerchantMatch":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}]},{"TotalLength":2,"TerminatedMerchant":[{"Merchant":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"MerchantMatch":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"Merchant":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"MerchantMatch":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}]}],"PossibleInquiryMatches":[{"TotalLength":2,"InquiredMerchant":[{"Merchant":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"Merchant":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}]},{"TotalLength":2,"InquiredMerchant":[{"Merchant":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"Merchant":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}]}]}}