Back to documentation index


If your service or application requiries transactional or service fees from your users, you can schedule fee collection directly against your client's Finxera account using the collectFees method. Any fees collected will be sent to your subscriber fee and revenue account (F&R Account) determined when you first subscribe to Finxera.

Request Parameters

  Parameter Required Type Description
subscriberId Y long Specify subscriber ID issued when Finxera account is created.
+ account Y Object If a list of transactions for a single account is desired, then specify either bancBoxId or subscriberReferenceId.
+ items Y Object Specify details about the fee, repeat to schedule more than one fee.

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) :
WSDL URL (SandBox) :

Sample Request

<soapenv:Envelope xmlns:soapenv="" xmlns:sch="">
<wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="">
<wsse:UsernameToken wsu:Id="XWSSGID-1261544568770-474929336" xmlns:wsu="">
<wsse:Password Type="">sample</wsse:Password>
            <!--1 or more repetitions:-->

Sample Response



Note:For REST, Content-type should be set to application/json
URL (Production) :
URL (SandBox) :

Sample Request

    "authentication": {
        "apiKey": "YOUR_API_KEY_HERE",
        "secret": "SECRET_PASSPHRASE"
    "subscriberId": ? ,
    "account" : {
        "bancBoxId": ? ,
        "subscriberReferenceId" : "?"
    "items": [{
        "referenceId": "?",
        "amount": ? ,
        "memo" : "?",
        "scheduleDate": "?"

Sample Response

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