Finxera

Back to documentation index

updateLinkedExternalAccount

Use update linked external account API to change the details of a previously made linked external account.

Request Parameters

  Parameter Required Type Description
subscriberId Y Long ID issued by bancBox when subscriber signs up.
+ linkedExternalAccountId Y Object ID of the external account.
+ account Y Object Specify one of the following accounts { 'paypalAccount', 'cardAccount', 'bankAccount'}

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.
+ error   Object Request failed, error response.
+ linkedExternalAccountId   Object The ID of the external account being updated.
+ account   Object Describes the newly updated external account.

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

Sample Request

<soapenv:Envelopexmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:sch="schema.bancbox.com"><soapenv:Header><wsse:Securitysoapenv:mustUnderstand="1"xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><wsse:UsernameTokenwsu:Id="XWSSGID-1261544568770-474929336"xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"><wsse:Username>ORCC09</wsse:Username><wsse:PasswordType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">abcd1234</wsse:Password></wsse:UsernameToken></wsse:Security></soapenv:Header><soapenv:Body><sch:updateLinkedExternalAccount><updateLinkedExternalAccountRequest><subscriberId>200322</subscriberId><!--Optional:--><linkedExternalAccountId><bancBoxId>364940</bancBoxId><subscriberReferenceId>Ref04_WIRE_Link8</subscriberReferenceId></linkedExternalAccountId><account><!--YouhaveaCHOICEofthenext4itemsatthislevel--><wireAccount><bankAccountDetails><routingNumber>051000017</routingNumber><accountNumber>2456091872</accountNumber><holderName>Deepika</holderName><bankAccountType>SAVING</bankAccountType></bankAccountDetails><address><line1>12ST</line1><!--Optional:--><line2>ROAD</line2><city>ATLANTA</city><state>GA</state><zipcode>23890</zipcode></address></wireAccount></account></updateLinkedExternalAccountRequest></sch:updateLinkedExternalAccount></soapenv:Body></soapenv:Envelope>

Sample Response

<soap:Envelopexmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Body><ns1:updateLinkedExternalAccountResponsexmlns:ns1="schema.bancbox.com"><returnxsi:type="ns3:updateLinkedExternalAccountResponse"xmlns:ns3="schema.bancbox.com"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><requestId>1396257951277</requestId><status>1</status><linkedExternalAccountId><bancBoxId>364940</bancBoxId><subscriberReferenceId>Ref04_WIRE_Link8</subscriberReferenceId></linkedExternalAccountId><account><wireAccount><bankAccountDetails><routingNumber>051000017</routingNumber><accountNumber>2456091872</accountNumber><holderName>Deepika</holderName><bankAccountType>SAVING</bankAccountType></bankAccountDetails><address><line1>12ST</line1><line2>ROAD</line2><city>ATLANTA</city><state>GA</state><zipcode>23890</zipcode></address></wireAccount></account></return></ns1:updateLinkedExternalAccountResponse></soap:Body></soap:Envelope>

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

Sample Request

{
    "authentication": {
        "apiKey": "YOUR_API_KEY_HERE",
        "secret": "SECRET_PASSPHRASE"
    },
    "subscriberId": ? ,
    "linkedExternalAccountId" : {
        "bancBoxId": ? ,
        "subscriberReferenceId" : "?"
    },
    "account": {
        "bankAccount": {
            "routingNumber": "?",
            "accountNumber": "?",
            "holderName": "?",
            "bankAccountType": "?"
        },
        "cardAccount": {
            "creditCardAccount": {
                "number": "?",
                "expiryDate": "?",
                "type": "?",
                "name": "?",
                "cvv": "?",
                "address": {
                    "line1": "?",
                    "city": "?",
                    "state": "?",
                    "zipcode": "?"
                }
            },
            "debitCardAccount": {
                "number": "?",
                "type": "?",
                "pin": "?"
            },
            "giftCardAccount": {
                "number": "?",
                "pin": "?"
            }
        },
        "paypalAccount": {
            "id": "?"
        }
    }
}

Sample Response

{
    "requestId": ?,
    "status": ?,
    "warnings": [
        {
            "code": "?",
            "message": "?"
        }
    ],
    "errors": [
        {
            "code": "?",
            "message": "?"
        }
    ],
    "linkedExternalAccountId": {
        "bancBoxId": ?,
        "subscriberReferenceId": "?"
    },
    "account": {
        "bankAccount": {
            "routingNumber": "?",
            "accountNumber": "?",
            "holderName": "?",
            "bankAccountType": "?"
        },
        "cardAccount": {
            "creditCardAccount": {
                "number": "?",
                "expiryDate": "?",
                "type": "?",
                "name": "?",
                "cvv": "?",
                "address": {
                    "line1": "?",
                    "city": "?",
                    "state": "?",
                    "zipcode": "?"
                }
            },
            "debitCardAccount": {
                "number": "?",
                "type": "?",
                "pin": "?"
            },
            "giftCardAccount": {
                "number": "?",
                "pin": "?"
            }
        },
        "paypalAccount": {
            "id": "?"
        }
    }
}