##### Adds a new terminated merchant to MATCH system.

POST {{baseUrl}}/add-merchant?Format=JSON

Used by Acquirers to add a terminated a merchant in the MATCH system. Merchant information, and up to five principal owners per merchant, can be provided by an acquiring bank as part of the listing. For adding a terminated merchant,  Acquirer Id and Merchant Id combination must be unique and Merchant Id should be less than 15 characters. For further details refer the documentation on Use Cases.

Request Params

KeyDatatypeRequiredDescription
Formatstring(Required) Describes format of the response you wants to serverd, response can be delevired either as XML or JSON.

Request Body

{"AddMerchantRequest"=>{"AcquirerId"=>"1996", "Merchant"=>{"CATFlag"=>"Y", "DateClosed"=>"10/12/2014", "DateOpened"=>"12/31/2013", "MerchantCategory"=>"0742", "MerchantId"=>"1234567890", "Name"=>"THE BAIT SHOP", "PhoneNumber"=>"6367558963", "ReasonCode"=>"13", "DoingBusinessAsName"=>"BAIT R US", "Address"=>{"Line1"=>"42 ELM AVENUE", "City"=>"DALLAS", "Country"=>"USA", "PostalCode"=>"66579", "Line2"=>"SUITE 201", "CountrySubdivision"=>"IL", "Province"=>"US"}, "AltPhoneNumber"=>"6367558968", "NationalTaxId"=>"*****", "CountrySubdivisionTaxId"=>"*****", "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>"}}], "Comments"=>"Added for reasons of fraud"}}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;AddMerchantResponse&quot;:{&quot;MerchantReferenceNumber&quot;:&quot;19962015072000000&quot;,&quot;Name&quot;:&quot;XYZTEST XYZTECHMERCHANT&quot;}}