Skip to main content
Promotion codes are the actual codes customers enter at checkout. Each promotion code is linked to a coupon and a partner, so when a customer uses the code, the sale is attributed to the correct partner.

​
Key concepts

  • Promotion code: A code customers enter (e.g., JOHN20)
  • Coupon: The parent discount rule that defines the discount amount
  • Partner link: Each promotion code is tied to a specific partner

​
Available endpoints

List codes

Retrieve all promotion codes with pagination

Get code

Get a specific promotion code’s details

Create code

Create a new promotion code linked to a partner

Update code

Modify a promotion code

Delete code

Remove a promotion code

​
Relationship with coupons

Coupon (20% off)
├── Promotion code "JOHN20" → Partner: John
├── Promotion code "SARAH20" → Partner: Sarah
└── Promotion code "MIKE20" → Partner: Mike
Each partner can have their own promotion code under the same coupon. This way, you manage the discount once at the coupon level and create individual codes per partner.