**Version: 202601**

# Create usage charge

**POST** `/openapi/2026-01/recurring_application_charges/:charge_id/usage_charge`

Create usage-based charges for a recurring application charge within Shoplazza.

## Request

**Path Parameters**

- `charge_id` string (required)

  Charge ID

**application/json**

**Body | Example**

**Body (required)**

- `usage_charge` object (required)

  Usage charge

  - `description` string (required)

    Description of the usage charge
  - `price` float (required)

    Price of the usage charge

```json
{
  "usage_charge": {
    "description": "string",
    "price": 0
  }
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `usage_charge` object

    Usage charge

    - `id` string

      Usage charge ID
    - `price` string

      Usage charge amount
    - `description` string

      Usage charge description
    - `balance_used` string

      Used balance
    - `balance_remaining` string

      Remaining balance
    - `created_at` string

      Creation time, in ISO-8601 format

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "usage_charge": {
      "id": "string",
      "price": "string",
      "description": "string",
      "balance_used": "string",
      "balance_remaining": "string",
      "created_at": "string"
    }
  }
}
```
