Jump to

• Request
• Response
• Examples

Update Dynamic Charges for a Purchased Product

patch

/bcws/webresources/v1.0/subscriptions/offer/{id}/overridecharges

Adds dynamic charges or updates existing dynamic chanrges for the purchased product with the specified ID.

Request

Path Parameters

• id(required): string
  The ID of the purchased product or discount to update dynamic charges for. For example: 0.0.0.1+-purchased_product+123123

Supported Media Types

• application/xml
• application/json

Request Body - application/xml ()

Root Schema : schema

Type: array

Show Source

• Array of: object overriddenCharges

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

Nested Schema : overriddenCharges

Type: object

Show Source

• charges(required): array charges
  The charge details.
• event(required): string
  The event associated with the overridden charges.

{
    "required":[
        "charges",
        "event"
    ],
    "type":"object",
    "properties":{
        "event":{
            "type":"string",
            "description":"The event associated with the overridden charges."
        },
        "charges":{
            "type":"array",
            "description":"The charge details.",
            "items":{
                "$ref":"#/components/schemas/Charges"
            }
        }
    },
    "xml":{
        "name":"overriddenCharges"
    }
}

Nested Schema : charges

Type: array

The charge details.

Show Source

• Array of: object Charges
  The charge details.

{
    "type":"array",
    "description":"The charge details.",
    "items":{
        "$ref":"#/components/schemas/Charges"
    }
}

Nested Schema : Charges

Type: object

The charge details.

Show Source

• charge(required): array charge
  The charges.
• endDate: string (date-time)
  The date and time the charge's validity ends.
• startDate(required): string (date-time)
  The date and time the charge's validity starts.

{
    "required":[
        "charge",
        "startDate"
    ],
    "type":"object",
    "properties":{
        "startDate":{
            "type":"string",
            "description":"The date and time the charge's validity starts.",
            "format":"date-time"
        },
        "endDate":{
            "type":"string",
            "description":"The date and time the charge's validity ends.",
            "format":"date-time"
        },
        "charge":{
            "type":"array",
            "description":"The charges.",
            "items":{
                "$ref":"#/components/schemas/Charge"
            }
        }
    },
    "description":"The charge details."
}

Nested Schema : charge

Type: array

The charges.

Show Source

• Array of: object Charge
  The charges.

{
    "type":"array",
    "description":"The charges.",
    "items":{
        "$ref":"#/components/schemas/Charge"
    }
}

Nested Schema : Charge

Type: object

The charges.

Show Source

• amount(required): number
  The charge amount.
• priceTag(required): string
  The charge's price tag.
• type(required): string
  The charge type.

{
    "required":[
        "amount",
        "priceTag",
        "type"
    ],
    "type":"object",
    "properties":{
        "amount":{
            "type":"number",
            "description":"The charge amount."
        },
        "priceTag":{
            "type":"string",
            "description":"The charge's price tag."
        },
        "type":{
            "type":"string",
            "description":"The charge type."
        }
    },
    "description":"The charges."
}

Request Body - application/json ()

Root Schema : schema

Type: array

Show Source

• Array of: object overriddenCharges

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

Nested Schema : overriddenCharges

Type: object

Show Source

• charges(required): array charges
  The charge details.
• event(required): string
  The event associated with the overridden charges.

{
    "required":[
        "charges",
        "event"
    ],
    "type":"object",
    "properties":{
        "event":{
            "type":"string",
            "description":"The event associated with the overridden charges."
        },
        "charges":{
            "type":"array",
            "description":"The charge details.",
            "items":{
                "$ref":"#/components/schemas/Charges"
            }
        }
    },
    "xml":{
        "name":"overriddenCharges"
    }
}

Nested Schema : charges

Type: array

The charge details.

Show Source

• Array of: object Charges
  The charge details.

{
    "type":"array",
    "description":"The charge details.",
    "items":{
        "$ref":"#/components/schemas/Charges"
    }
}

Nested Schema : Charges

Type: object

The charge details.

Show Source

• charge(required): array charge
  The charges.
• endDate: string (date-time)
  The date and time the charge's validity ends.
• startDate(required): string (date-time)
  The date and time the charge's validity starts.

{
    "required":[
        "charge",
        "startDate"
    ],
    "type":"object",
    "properties":{
        "startDate":{
            "type":"string",
            "description":"The date and time the charge's validity starts.",
            "format":"date-time"
        },
        "endDate":{
            "type":"string",
            "description":"The date and time the charge's validity ends.",
            "format":"date-time"
        },
        "charge":{
            "type":"array",
            "description":"The charges.",
            "items":{
                "$ref":"#/components/schemas/Charge"
            }
        }
    },
    "description":"The charge details."
}

Nested Schema : charge

Type: array

The charges.

Show Source

• Array of: object Charge
  The charges.

{
    "type":"array",
    "description":"The charges.",
    "items":{
        "$ref":"#/components/schemas/Charge"
    }
}

Nested Schema : Charge

Type: object

The charges.

Show Source

• amount(required): number
  The charge amount.
• priceTag(required): string
  The charge's price tag.
• type(required): string
  The charge type.

{
    "required":[
        "amount",
        "priceTag",
        "type"
    ],
    "type":"object",
    "properties":{
        "amount":{
            "type":"number",
            "description":"The charge amount."
        },
        "priceTag":{
            "type":"string",
            "description":"The charge's price tag."
        },
        "type":{
            "type":"string",
            "description":"The charge type."
        }
    },
    "description":"The charges."
}

Back to Top

Response

204 Response

The dynamic charges were updated successfully.

400 Response

The request isn't valid.

500 Response

An internal server error occurred.

Back to Top

Examples

This example shows how update dynamic charges for a purchased product by submitting a PATCH request on the REST resource using cURL. For more information about cURL, see "Use cURL".

cURL Command

curl -X PATCH 'http://hostname:port/bcws/webresources/version/subscriptions/offer/0.0.0.1+-purchased_product+2832219/overridecharges' -H 'content-type: application/json' -d @updateCharges.json

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.
• updateCharges.json is the JSON file that specifies the loan to create.

Example of Request Body

This example shows the contents of the updateCharges.json file sent as the request body.

[
         {
            "event":"/event/billing/product/fee/cycle/cycle_forward_arrear",
            "charges":[
               {
                  "startDate":"2021-10-19",
                  "endDate":"2021-11-19",
                  "charge":[
                     {
                        "amount":105,
                        "priceTag":"USD",
                        "type":"amount"
                     },
                     {
                        "amount":205,
                        "priceTag":"Free MInutes",
                        "type":"percentage"
                     }
                  ]
               },
               {
                  "startDate":"2021-11-20",
                  "endDate":"",
                  "charge":[
                     {
                        "amount":100,
                        "priceTag":"USD",
                        "type":"percentage"
                     },
                     {
                        "amount":200,
                        "priceTag":"Free MInutes",
                        "type":"percentage"
                     }
                  ]
               }
            ]
         },
          {
            "event":"/event/billing/product/fee/purchase",
            "charges":[
               {
                  "startDate":"2021-10-19",
                  "endDate":"2021-11-19",
                  "charge":[
                     {
                        "amount":105,
                        "priceTag":"USD",
                        "type":"amount"
                     }
                  ]
               },
               {
                  "startDate":"2021-11-20",
                  "endDate":"",
                  "charge":[
                     {
                        "amount":100,
                        "priceTag":"USD",
                        "type":"percentage"
                     }
                  ]
               }
            ]
         }  

Example of Response Body

If successful, the response code 204 is returned with no response body.

Back to Top