Finxera

Back to documentation index

transferFunds

Use to transfer funds from one Finxera account to another Finxera account.

Request Parameters

  Parameter Required Type Description
subscriberId Y long Specify subscriber ID issued when Finxera account is created.
+ sourceAccount Y Object The source account is the Finxera account where the funds move from.
+ destinationAccount Y Object The source account is the Finxera account where the funds move to.
memo N String Memo (Max length:128)
+ items Y Object Items

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.
+ itemStatuses   Object Item Statuses

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

Sample Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="schema.bancbox.com">
<soapenv:Header>
<wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<wsse:UsernameToken wsu:Id="XWSSGID-1261544568770-474929336" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsse:Username>sample@email.com</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">sample</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soapenv:Header>
   <soapenv:Body>
      <sch:transferFunds>
         <transferFundsRequest>
            <subscriberId>?</subscriberId>
            <sourceAccount>
               <!--Optional:-->
               <bancBoxId>?</bancBoxId>
               <!--Optional:-->
               <subscriberReferenceId>?</subscriberReferenceId>
            </sourceAccount>
            <destinationAccount>
               <!--Optional:-->
               <bancBoxId>?</bancBoxId>
               <!--Optional:-->
               <subscriberReferenceId>?</subscriberReferenceId>
            </destinationAccount>
            <!--Optional:-->
            <memo>?</memo>
            <!--Zero or more repetitions:-->
            <items>
               <!--Optional:-->
               <referenceId>?</referenceId>
               <!--Optional:-->
               <memo>?</memo>
               <amount>?</amount>
               <!--Optional:-->
               <scheduled>
                  <scheduleDate>?</scheduleDate>
               </scheduled>
            </items>
         </transferFundsRequest>
      </sch:transferFunds>
   </soapenv:Body>
</soapenv:Envelope>

Sample Response

<requestId></requestId> 
<status></status> 
<itemStatuses> 
	<id> 
		<bancBoxId></bancBoxId> 
		<subscriberReferenceId></subscriberReferenceId> 
	</id> 
	<status></status> 
	<messageCode></messageCode> 
	<messageDesc></messageDesc> 
	<code></code> 
	<message></message>
	<itemStatus></itemStatus> 
</itemStatuses> 

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

Sample Request

{
    "authentication": {
        "apiKey": "api@readyforzero.com",
        "secret": "Hythtl76"
    },
    "sourceAccount": {
        "bancBoxId": "?",
        "subscriberReferenceId": "?"
    },
    "destinationAccount": {
        "bancBoxId": "?",
        "subscriberReferenceId": "?"
    },
    "subscriberId": "?",
    "memo": "?",
    "items": [{
        "amount": ? ,
        "scheduleDate" : "?",
        "referenceId": "?",
        "memo": "?"
    }]
}

Sample Response

{ 
  "itemStatuses" : [ { 
    "id" : { 
      "bancBoxId" : ?, 
      "subscriberReferenceId" : "?", 
    }, 
    "status" : "?", 
    "messageCode" : "?", 
    "messageDesc" :"?", 
    "code" : "?", 
    "message" : "?", 
    "itemStatus" : ? 
  } ], 
  "requestId" : ?, 
  "status" : ? 
 }