Finxera

Back to documentation index

updateAccount

Use the updateAccount API to update the details of an already created Finxera account.

Request Parameters

  Parameter Required Type Description
subscriberId Y Long Subscriber Id
+ accountId Y Object Specify either the account Id(Finxera generated Account Number or the subscriber defined account number) or the subscriberReference ID for the account being updated.
title Y String Specify the new title desired for the account (Max length:45)

Response Parameters

  Parameter   Type Description
requestId   long 13 digit ID for the API request being made.
status   int Status of completed request, either 1 for pass, or 0 for fail.
+ warnings   Object A Warning object containing a code and description.
+ errors   Object Request failed, error response.

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:updateAccount>
         <updateAccountRequest>
             <subscriberId>?</subscriberId>
            <accountId>
               <!--Optional:-->
               <bancBoxId>?</bancBoxId>
               <!--Optional:-->
               <subscriberReferenceId>?</subscriberReferenceId>
            </accountId>
            <!--Optional:-->
            <title>?</title>
         </updateAccountRequest>
      </sch:updateAccount>
   </soapenv:Body>
</soapenv:Envelope>

Sample Response

<sch:updateAccountResponse>
           <return>
            <!--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>
          </return>
</sch:updateAccountResponse>

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

Sample Request

{
    "authentication": {
        "apiKey": "YOUR_API_KEY_HERE",
        "secret": "SECRET_PASSPHRASE"
    },
    "subscriberId": ? ,
    "accountId" : {
        "bancBoxId": ? ,
        "subscriberReferenceId" : "?"
    },
    "title": "?"
}

Sample Response

{
    "requestId": ? ,
    "status" : ? ,
    "warnings" : [{
        "code": "?",
        "message": "?"
    }],
    "errors": [{
        "code": "?",
        "message": "?"
    }]
}

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