# `PolarExpress.Schemas.DiscountPercentageRepeatDurationCreate`
[🔗](https://github.com/jeffhuen/polar_express/blob/main/lib/polar_express/schemas/discount_percentage_repeat_duration_create.ex#L2)

DiscountPercentageRepeatDurationCreate

Schema to create a percentage discount that is applied on every invoice
for a certain number of months.

# `t`

```elixir
@type t() :: %PolarExpress.Schemas.DiscountPercentageRepeatDurationCreate{
  basis_points: integer() | nil,
  code: String.t() | nil,
  duration: PolarExpress.Schemas.DiscountDuration.t() | nil,
  duration_in_months: integer() | nil,
  ends_at: DateTime.t() | nil,
  max_redemptions: integer() | nil,
  metadata:
    %{
      required(String.t()) => String.t() | integer() | float() | boolean() | nil
    }
    | nil,
  name: String.t() | nil,
  organization_id: String.t() | nil,
  products: [String.t()] | nil,
  starts_at: DateTime.t() | nil,
  type: PolarExpress.Schemas.DiscountType.t() | nil
}
```

* `basis_points` - Discount percentage in basis points.

A basis point is 1/100th of a percent.
For example, to create a 25.5% discount, set this to 2550.
* `code` - Code customers can use to apply the discount during checkout. Must be between 3 and 256 characters long and contain only alphanumeric characters.If not provided, the discount can only be applied via the API. Nullable.
* `duration`
* `duration_in_months` - Number of months the discount should be applied.

For this to work on yearly pricing, you should multiply this by 12.
For example, to apply the discount for 2 years, set this to 24.
* `ends_at` - Optional timestamp after which the discount is no longer redeemable. Nullable.
* `max_redemptions` - Optional maximum number of times the discount can be redeemed. Nullable.
* `metadata` - Key-value object allowing you to store additional information.

The key must be a string with a maximum length of **40 characters**.
The value must be either:

* A string with a maximum length of **500 characters**
* An integer
* A floating-point number
* A boolean

You can store up to **50 key-value pairs**.
* `name` - Name of the discount. Will be displayed to the customer when the discount is applied.
* `organization_id` - The ID of the organization owning the discount. **Required unless you use an organization token.** Nullable.
* `products` - Nullable.
* `starts_at` - Optional timestamp after which the discount is redeemable. Nullable.
* `type` - Type of the discount.

# `schema_name`

---

*Consult [api-reference.md](api-reference.md) for complete listing*