Jump to

• Request
• Response
• Examples

Get a Customer Deposit by ID

get

/bcws/webresources/v1.0/depositManagement/customerDeposit/{id}

Gets the customer deposit with the specified ID.

Request

Path Parameters

• id(required): string
  The customer deposit ID, for example: 0.0.0.1+-purchased_deposit+1234567

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/xml
• application/json

201 Response

The customer deposit details were returned successfully.

Body ()

Root Schema : CustomerDeposit

Type: object

Show Source

• balanceAmount: object Money
• billProfileRef(required): string
  The bill profile reference.
• code(required): string
  The external identifier.
• createdAt(required): string
  The date when the customer deposit is created.
• customerRef(required): string
  The customer reference.
• depositSpecName(required): string
  The deposit specoification name.
• depositSpecRef(required): string
  The deposit specification reference.
• discountAmount: object Money
• effectiveDate(required): string
  The date from which the customer deposit is effective.
• href(required): string
  The unique resource URL, used to get the object.
• id(required): string
  The customer deposit ID.
• interestAmount: object Money
• modifiedAt(required): string
  The date when the customer deposit is modified.
• notes: string
  The notes for the customer deposit.
• receivedAmount: object Money
• releasedAmount: object Money
• releaseType: integer (int32)
  The release type. Allowed Values: 1 (Prepayment), 2 (Refund), 3 (Zeroise).
• serviceRef(required): string
  The service reference.
• status(required): string
  The deposit status. Allowed Values: WAITING, ACTIVE, EXPIRED, TRANSFERRED, RELEASED, REFUNDED, CANCELLED
• totalAmount: object Money
• transactions(required): array transactions
• validFor: object TimePeriod
• validityRule: object DepositValidityRule

{
    "required":[
        "billProfileRef",
        "code",
        "createdAt",
        "customerRef",
        "depositSpecName",
        "depositSpecRef",
        "effectiveDate",
        "href",
        "id",
        "modifiedAt",
        "serviceRef",
        "status",
        "transactions"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"The customer deposit ID."
        },
        "href":{
            "type":"string",
            "description":"The unique resource URL, used to get the object."
        },
        "createdAt":{
            "type":"string",
            "description":"The date when the customer deposit is created."
        },
        "modifiedAt":{
            "type":"string",
            "description":"The date when the customer deposit is modified."
        },
        "effectiveDate":{
            "type":"string",
            "description":"The date from which the customer deposit is effective."
        },
        "status":{
            "type":"string",
            "description":"The deposit status. Allowed Values: WAITING, ACTIVE, EXPIRED, TRANSFERRED, RELEASED, REFUNDED, CANCELLED"
        },
        "totalAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "notes":{
            "type":"string",
            "description":"The notes for the customer deposit."
        },
        "receivedAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "releasedAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "interestAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "balanceAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "discountAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "customerRef":{
            "type":"string",
            "description":"The customer reference."
        },
        "depositSpecRef":{
            "type":"string",
            "description":"The deposit specification reference."
        },
        "depositSpecName":{
            "type":"string",
            "description":"The deposit specoification name."
        },
        "serviceRef":{
            "type":"string",
            "description":"The service reference."
        },
        "billProfileRef":{
            "type":"string",
            "description":"The bill profile reference."
        },
        "releaseType":{
            "type":"integer",
            "description":"The release type. Allowed Values: <b>1</b> (Prepayment), <b>2</b> (Refund), <b>3</b> (Zeroise).",
            "format":"int32"
        },
        "code":{
            "type":"string",
            "description":"The external identifier."
        },
        "transactions":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/CustomerDepositTransactions"
            }
        },
        "validityRule":{
            "$ref":"#/components/schemas/DepositValidityRule"
        },
        "validFor":{
            "$ref":"#/components/schemas/TimePeriod"
        }
    }
}

Nested Schema : Money

Type: object

Show Source

• amount(required): number
  The amount of money.
• currency: integer (int32)
  The currency for the money.

{
    "required":[
        "amount"
    ],
    "type":"object",
    "properties":{
        "amount":{
            "type":"number",
            "description":"The amount of money."
        },
        "currency":{
            "type":"integer",
            "description":"The currency for the money.",
            "format":"int32"
        }
    }
}

Nested Schema : transactions

Type: array

Show Source

• Array of: object CustomerDepositTransactions

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/CustomerDepositTransactions"
    }
}

Nested Schema : TimePeriod

Type: object

Show Source

• endDateTime(required): string
• startDateTime(required): string

{
    "required":[
        "endDateTime",
        "startDateTime"
    ],
    "type":"object",
    "properties":{
        "startDateTime":{
            "type":"string"
        },
        "endDateTime":{
            "type":"string"
        }
    }
}

Nested Schema : DepositValidityRule

Type: object

Show Source

• endOffsetPeriodUnit: integer (int32)
  The unit of measure for the end offset.
  Allowed Values:

  • 0 (Month)
  • 1 (Day)
  • 2 (Week)
  • 3 (Year)
• endOffsetPeriodValue: integer (int32)
  The value for the end offset.

{
    "type":"object",
    "properties":{
        "endOffsetPeriodUnit":{
            "type":"integer",
            "description":"The unit of measure for the end offset.<br/>Allowed Values: <ul><li><b>0</b> (Month)</li><li><b>1</b> (Day)</li><li><b>2</b> (Week)</li><li><b>3</b> (Year)</li></ul>",
            "format":"int32"
        },
        "endOffsetPeriodValue":{
            "type":"integer",
            "description":"The value for the end offset.",
            "format":"int32"
        }
    }
}

Nested Schema : CustomerDepositTransactions

Type: object

Show Source

• transactionRef(required): string
  Reference to the transaction record.
• transactions(required): string
  The transactions.

{
    "required":[
        "transactionRef",
        "transactions"
    ],
    "type":"object",
    "properties":{
        "transactions":{
            "type":"string",
            "description":"The transactions."
        },
        "transactionRef":{
            "type":"string",
            "description":"Reference to the transaction record."
        }
    }
}

500 Response

An error occurred. An exception has been raised.

Back to Top

Examples

This example shows how to get a deposit by submitting a GET request on the REST resource using cURL. For more information about cURL, see "Use cURL".

cURL Command

curl -X GET 'http://hostname:port/bcws/webresources/version/depositManagement/customerDeposit/0.0.0.1+-purchased_deposit+2654172'

where:

• hostname is the URL for the Billing Care REST server.
• port is the port for the Billing Care REST server.
• version is the version of the API you're using, such as v1.0.

Example of Response Body

This example shows the contents of the response body in JSON format.

{
    "id": "0.0.0.1+-purchased_deposit+2654172",
    "href": "http://hostname:port/bcws/webresources/version/depositManagement/customerDeposit/0.0.0.1+-purchased_deposit+2654172",
    "createdAt": "2021-11-06T13:34:35.000Z",
    "modifiedAt": "2021-11-06T13:34:35.000Z",
    "code": "",
    "customerRef": "0.0.0.1+-account+2205426",
    "serviceRef": "0.0.0.1+-service-telco-gsm+2203914",
    "billProfileRef": "0.0.0.1+-billinfo+2206194",
    "depositSpecRef": "0.0.0.1+-deposit_specification+2207626",
    "validFor": {
        "endDateTime": "2021-11-22T00:00:00.000Z",
        "startDateTime": "2021-11-12T00:00:00.000Z"
    },	
    "totalAmount": {
        "amount": 123
    },
    "receivedAmount": {
        "amount": 0
    },
    "releasedAmount": {
        "amount": 0
    },
    "interestAmount": {
        "amount": 0
    },
    "balanceAmount": {
        "amount": 0
    },
    "releaseType": "PREPAYMENT"
}

Back to Top