# Promotional credits

> For the complete machine-readable documentation index, see [llms.txt](https://apidocs.chargebee.com/llms.txt).


These credits can be provided to the customer for promoting the product. You can use Promotional Credits to offer referral bonuses, cash back offers and more. When a customer has promotional credits, it is automatically applied whenever a new invoice is created.

## Sample Promotional credit

```json
{
  "amount": 100,
  "closing_balance": 100,
  "created_at": 1517501388,
  "credit_type": "general",
  "currency_code": "USD",
  "customer_id": "__test__KyVnHhSBWStxi4s",
  "description": "add promotional credits",
  "done_by": "full_access_key_v1",
  "id": "pc___test__KyVnHhSBWStz44u",
  "object": "promotional_credit",
  "type": "increment"
}
```

## Promotional credits attributes

## Input Parameters

- `id` (required, string, max chars=150)
  Unique reference ID provided for promotional credits

- `customer_id` (required, string, max chars=50)
  Identifier of the customer.

- `type` (required, enumerated string)
  Type of promotional credits
  Possible enum values:
    - `increment`
      Increment
    - `decrement`
      Decrement

- `amount_in_decimal` (optional, string, max chars=33)
  Amount in decimal

- `amount` (required, in cents, min=0)
  Promotional credits amount

- `currency_code` (required, string, max chars=3)
  The currency code (ISO 4217 format) for promotional credit

- `description` (required, string, max chars=250)
  Detailed description of this promotional credits.

- `credit_type` (required, enumerated string, default=general)
  Type of promotional credits provided to customer
  Possible enum values:
    - `loyalty_credits`
      Loyalty Credits
    - `referral_rewards`
      Referral
    - `general`
      General

- `reference` (optional, string, max chars=500)
  Describes why promotional credits were provided

- `closing_balance` (required, in cents, min=0)
  Closing balance as on end date.

- `done_by` (optional, string, max chars=100)
  The user who added/deducted the credit. If created via API, this contains the name given for the API key used.

- `created_at` (required, timestamp(UTC) in seconds)
  Timestamp indicating when this promotional credit resource is created.

- `business_entity_id` (optional, string, max chars=50)
  The ID of the business entity created for the site. For Product Catalog 1.0, all the site data is tied to this business entity.
  
  **Note** [Multiple Business Entities](/docs/api/business_entities) is a feature available only on Product Catalog 2.0.