# Promotion codes (discounts)

### **Instructions**

You can create promotion codes and let customers enter them on the Checkout Session page to get a discount on the product / service they are buying.

<figure><img src="/files/27zH4oOTAuxgYIWLT8Vy" alt=""><figcaption></figcaption></figure>

To activate promotion codes:

* Go to Product Catalogue -> [Coupons](https://dashboard.stripe.com/test/coupons) in your Stripe dashboard
* Create a new coupon by clicking on the button highlighted below

<div align="left"><figure><img src="/files/cWHuBLR7QJdg7ZR3KVBi" alt="" width="563"><figcaption></figcaption></figure></div>

* Create your coupon and add a Code

<div align="left"><figure><img src="/files/1Eu2v6z2yH5NorupiqNx" alt="" width="375"><figcaption></figcaption></figure></div>

* When creating a Checkout Session with the plugin, set the ‘Enable Coupons’ field to ‘yes’

<div align="left"><figure><img src="/files/Fn9xOcH7BvgfD651wqRQ" alt="" width="563"><figcaption></figcaption></figure></div>

The user will now have the option to add a promotion code that is linked to the coupon you created in the Stripe Checkout Session.

**Important:** the discount will NOT be split evenly (or pro-rated) between the seller and the platform. The seller will effectively lose out by giving the discount, while your marketplace will get the same amount.

For example, let’s say a seller on your platform is selling a product for $100 and your platform takes a 20% platform fee. If a coupon that provides a 10% discount is used:

* The customer will pay $90 instead of $100
* Your platform will still get 20% of $100 (so $20)
* The seller will get $70

### **Demo App**

You can view an example of the page setup and workflow actions for creating a Checkout Session that allows promotion codes in the demo app at the below link (relevant section is the 'Promotion Codes' section):

{% embed url="<https://stripeconnectmarketplace.bubbleapps.io/version-test>" %}

The editor is public and can be accessed by clicking the 'View Editor' button at the top of the page.<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cranford-tech.gitbook.io/stripe-connect-marketplace/implementing-key-features/promotion-codes-discounts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
