1. REST Services Manager API for Billing and Revenue Management
  2. Tasks
  3. Prepay Balance Management
  4. Transfer Balances

Create a Transfer Balance

post

/transferBalance

Creates a transfer balance.

Request

There are no request parameters for this operation.

Supported Media Types
Request Body - application/json;charset=utf-8 ()
The transfer balance to create.
Root Schema : Transfer Balance Create
Type: object
Title: Transfer Balance Create
A balance being transferred between buckets, used in TransferBalance create requests. The id, href, status, requestedDate, confirmationDate, relatedParty, and partyAccount properties are not used in create requests.
Show Source
Nested Schema : Quantity
Type: object
Title: Quantity
The quantity of an object.
Show Source
Nested Schema : Bucket Ref
Type: object
Title: Bucket Ref
A reference to a bucket.
Show Source
Nested Schema : ChannelRef
Type: object
A reference to a channel.
Show Source
Nested Schema : impactedBucket
Type: array
Buckets impacted by the request.
Show Source
Nested Schema : Logical Resource Ref
Type: object
Title: Logical Resource Ref
A reference to a logical resource.
Show Source
Nested Schema : Party Account Ref
Type: object
Title: Party Account Ref
A reference to a party account.
Show Source
Nested Schema : Product Ref
Type: object
Title: Product Ref
A reference to a product.
Show Source
Nested Schema : Related Party
Type: object
Title: Related Party
A party related to another object.
Show Source
Nested Schema : relatedParty
Type: array
Parties related to the transfer.
Show Source
Nested Schema : ImpactedBucket
Type: object
A bucket impacted by a balance top-up, adjustment, transfer, or reservation.
Show Source
Nested Schema : item
Type: array
Minimum Number of Items: 1
The impacted bucket items.
Show Source
Nested Schema : ImpactedBucketItem
Type: object
An impact item that affects an ImpactedBucket object.
Show Source
Back to Top

Response

Supported Media Types

201 Response

Created
Body ()
Root Schema : TransferBalance
Type: object
A balance being transferred between buckets.
Show Source
Nested Schema : Quantity
Type: object
Title: Quantity
The quantity of an object.
Show Source
Nested Schema : Bucket Ref
Type: object
Title: Bucket Ref
A reference to a bucket.
Show Source
Nested Schema : ChannelRef
Type: object
A reference to a channel.
Show Source
Nested Schema : impactedBucket
Type: array
Buckets impacted by the request.
Show Source
Nested Schema : Logical Resource Ref
Type: object
Title: Logical Resource Ref
A reference to a logical resource.
Show Source
Nested Schema : Party Account Ref
Type: object
Title: Party Account Ref
A reference to a party account.
Show Source
Nested Schema : Product Ref
Type: object
Title: Product Ref
A reference to a product.
Show Source
Nested Schema : Related Party
Type: object
Title: Related Party
A party related to another object.
Show Source
Nested Schema : relatedParty
Type: array
Parties related to the transfer.
Show Source
Nested Schema : ImpactedBucket
Type: object
A bucket impacted by a balance top-up, adjustment, transfer, or reservation.
Show Source
Nested Schema : item
Type: array
Minimum Number of Items: 1
The impacted bucket items.
Show Source
Nested Schema : ImpactedBucketItem
Type: object
An impact item that affects an ImpactedBucket object.
Show Source

400 Response

Bad Request
Body ()
Root Schema : Error
Type: object
Title: Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source

401 Response

Unauthorized
Body ()
Root Schema : Error
Type: object
Title: Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source

403 Response

Forbidden
Body ()
Root Schema : Error
Type: object
Title: Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source

405 Response

Method Not Allowed
Body ()
Root Schema : Error
Type: object
Title: Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source

409 Response

Conflict
Body ()
Root Schema : Error
Type: object
Title: Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source

500 Response

Internal Server Error
Body ()
Root Schema : Error
Type: object
Title: Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source
Back to Top

Examples

The following examples shows how to create transferred balances by submitting POST requests on the REST resource using cURL. For more information about cURL, see Use cURL.

The -d option specifies the file to attach as the request body.

curl -X POST 'http://host:port/brm/prepayBalanceManagement/version/transferBalance' -d @transferBalanceCreate.json

Example of Request Body for Transferring a Currency Balance

The following is an example of the contents of the transferBalanceCreate.json file sent as the request body to transfer a currency balance and include a transfer cost.

You can specify any combination of sender and receiver bucket, product, or logical resource, and BRM will locate the correct balance groups for the transfer. As in the example, with a sender bucket and a receiver product, the sender and receiver element type do not have to match.

{
    "amount":{
        "amount":"20",
        "units":"USD"
    },
    "costOwner":"receiver",
    "transferCost":{
        "amount":"5",
        "units":"USD"
    },
    "bucket":{
        "id" : "0.0.0.1+-balance_group+2186073+840+0"
    },
   "receiverProduct":{
        "id": "0.0.0.1+-service-telco-gsm-telephony+2184506"
    }
}

Example of Request Body for Transferring a Noncurrency Balance

The following is an example of the contents of the transferBalanceCreate.json file sent as the request body to transfer a noncurrency balance and include a transfer cost. 

{
    "amount":{
        "amount":"10",
        "units":"Free Minutes"
    },
    "costOwner":"originator",
    "transferCost":{
        "amount":"1",
        "units":"Free Minutes"
    },
   "logicalResource":{
        "value" : "0049100501"
    },
   "receiverProduct":{
        "id": "0.0.0.1+-service-telco-gsm-telephony+2202128"
    }
}

Example of Response Body

The following is an example of the response body in JSON format. It looks the same for currency and noncurrency transfers.

{
    "@baseType": null,
    "@schemaLocation": null,
    "@type": null,
    "amount": null,
    "bucket": null,
    "channel": null,
    "confirmationDate": null,
    "costOwner": null,
    "description": null,
    "href": "http://host:port/brm/prepayBalanceManagement/v4/transferBalance/0.0.0.1+-event-audit-transfer_balance+330134963311715969",
    "id": "0.0.0.1+-event-audit-transfer_balance+330134963311715969",
    "impactedBucket": null,
    "logicalResource": null,
    "partyAccount": null,
    "product": null,
    "reason": null,
    "receiver": null,
    "receiverBucket": null,
    "receiverBucketUsageType": null,
    "receiverLogicalResource": null,
    "receiverPartyAccount": null,
    "receiverProduct": null,
    "relatedParty": null,
    "requestedDate": null,
    "requestor": null,
    "status": "CONFIRMED",
    "transferCost": null,
    "usageType": null
}
Back to Top