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 ()
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
An amount in a given unit.
Show Source
Nested Schema : Bucket Ref
Type: object
Title: Bucket Ref
A reference to a bucket.
Show Source
Nested Schema : Channel Ref
Type: object
Title: Channel Ref
A reference to a channel.
Show Source
Nested Schema : logicalResource
Type: array
Minimum Number of Items: 1
Logical resources associated with the transfer.
Show Source
Nested Schema : product
Type: array
Products associated with the transfer.
Show Source
Nested Schema : Related Party
Type: object
Title: Related Party
A party related to another object.
Show Source
Nested Schema : Logical Resource Ref
Type: object
Title: Logical Resource Ref
A reference to a logical resource.
Show Source
Nested Schema : Product Ref
Type: object
Title: Product Ref
A reference to a product.
Show Source
Nested Schema : Money
Type: object
Title: Money
An amount of money.
Show Source
Nested Schema : Time Period
Type: object
Title: Time Period
A period of time. You can specify only endDateTime or both endDateTime and startDateTime.
Show Source
Back to Top

Response

Supported Media Types

201 Response

Created
Body ()
Root Schema : Transfer Balance
Type: object
Title: Transfer Balance
A balance being transferred between buckets.
Show Source
Nested Schema : Quantity
Type: object
An amount in a given unit.
Show Source
Nested Schema : Bucket Ref
Type: object
Title: Bucket Ref
A reference to a bucket.
Show Source
Nested Schema : Channel Ref
Type: object
Title: Channel Ref
A reference to a channel.
Show Source
Nested Schema : logicalResource
Type: array
Minimum Number of Items: 1
Logical resources associated with the transfer.
Show Source
Nested Schema : Party Account Ref
Type: object
Title: Party Account Ref
A reference to a party account.
Show Source
Nested Schema : product
Type: array
Products associated with the transfer.
Show Source
Nested Schema : Related Party
Type: object
Title: Related Party
A party related to another object.
Show Source
Nested Schema : Logical Resource Ref
Type: object
Title: Logical Resource Ref
A reference to a logical resource.
Show Source
Nested Schema : Product Ref
Type: object
Title: Product Ref
A reference to a product.
Show Source
Nested Schema : relatedParty
Type: array
A party related to the transfer.
Show Source
Nested Schema : Money
Type: object
Title: Money
An amount of money.
Show Source
Nested Schema : Time Period
Type: object
Title: Time Period
A period of time. You can specify only endDateTime or both endDateTime and startDateTime.
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