Finxera

Back to documentation index

updateMerchant

Use the updateMerchant API to change/update the details of an already existing merchant. The updateMerchant updates the Bank related information and merchant's contact information as well.

Request Parameters

  Parameter Required Type Description
subscriberId Y Long Specify the Subscriber ID issued, when BancBox account was created
merchantId Y Int Specify Id of the Merchant whose status has to be changed
+ address N Object Address
+ primaryContact N Object Enter the details of Primary contact
+ bankBusinessAccount N Object Enter bank business account information
+ merchantDetails N Object Enter the merchant details

Response Parameters

  Parameter   Type Description
requestId   Long 13 digit ID for the API request being made
status   Int It is the Status of completed request, (1 for pass or 0 for fail)
+ warnings   Object A Warning object containing a code and description.
+ errors   Object Request failed, error response.
merchantStatus   String Updated status of the merchant

WSDL URL (Production) :  https://api.bancbox.com/v3/BBXPort?wsdl
WSDL URL (SandBox) :  https://sandbox-api.bancbox.com/v3/BBXPort?wsdl

Sample Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="schema.bancbox.com">
   <soapenv:Header/>
   <soapenv:Body>
      <sch:updateMerchant>
         <updateMerchantRequest>
            <subscriberId>?</subscriberId>
            <merchantId>?</merchantId>
            <!--Optional:-->
            <address>
               <address1>?</address1>
               <!--Optional:-->
               <address2>?</address2>
               <city>?</city>
               <state>?</state>
               <zipcode>?</zipcode>
            </address>
            <!--Optional:-->
            <primaryContact>
               <firstName>?</firstName>
               <lastName>?</lastName>
               <phone>?</phone>
               <emailAddress>?</emailAddress>
            </primaryContact>
            <!--Optional:-->
            <bankBusinessAccount>
               <routingNumber>?</routingNumber>
               <accountNumber>?</accountNumber>
            </bankBusinessAccount>
            <!--Optional:-->
            <merchantDetails>
               <!--Optional:-->
               <maxTransactionAmount>?</maxTransactionAmount>
               <!--Optional:-->
               <customerServiceNumber>?</customerServiceNumber>
               <!--Optional:-->
               <amexId>?</amexId>
               <!--Optional:-->
               <discoverId>?</discoverId>
               <!--Optional:-->
               <softDescriptor>?</softDescriptor>
            </merchantDetails>
         </updateMerchantRequest>
      </sch:updateMerchant>
   </soapenv:Body>
</soapenv:Envelope>

Sample Response

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="schema.bancbox.com">
   <soapenv:Header/>
   <soapenv:Body>
      <sch:updateMerchantResponse>
         <updateMerchantResponse>
            <!--Optional:-->
            <requestId>?</requestId>
            <status>?</status>
            <!--Zero or more repetitions:-->
            <warnings>
               <!--Optional:-->
               <code>?</code>
               <!--Optional:-->
               <message>?</message>
            </warnings>
            <!--Zero or more repetitions:-->
            <errors>
               <!--Optional:-->
               <code>?</code>
               <!--Optional:-->
               <message>?</message>
            </errors>
            <!--Optional:-->
            <merchantId>?</merchantId>
         </updateMerchantResponse>
      </sch:updateMerchantResponse>
   </soapenv:Body>
</soapenv:Envelope> 

Note:For REST, Content-type should be set to application/json
URL (Production) :  https://api.bancbox.com/v3/BBXPortRest/updateMerchant
URL (SandBox) :  https://sandbox-api.bancbox.com/v3/BBXPortRest/updateMerchant

Sample Request

{
 "authentication":
 {
  "apiKey":"",
  "secret":""
 },
    "subscriberId":,
    "merchantId":,
    "address":
    {
    		"address1":"",
    		"address2":"",
    		"city":"",
    		"state":"",
    		"zipcode":
    },
    "primaryContact":
    {
    		"firstName":"",
    		"lastName":"",
    		"phone":,
    		"emailAddress":""
    },
    "bankBusinessAccount":
    {
    		"routingNumber":"",
    		"accountNumber":
    },
    "merchantDetails":
    {
    		"maxTransactionAmount":,
    		"customerServiceNumber":,
    		"amexId":,
    		"discoverId":,
    		"softDescriptor":""
    }
}

Sample Response

{
   "merchantId": ,
   "requestId": ,
   "status":,
   "warnings": 
}

Note: This is a beta version. The api listed here are likely to change.