How Tos
Checkout
Subscriptions
Track & Report

Coupons

Coupons are a great way to increase conversion and reward existing customers with special discounts. They are usually perceived as a temporary special offer rather than a price reduction, giving your customers that extra incentive to make a purchase. You can create a coupon via the API or via the Seller dashboard.

Creating coupons via Dashboard

  1. In the Dashboard, click Catalog and then Coupons.
  2. Click on “New Coupon” button.
  3. Enter the coupon code or leave the coupon code field empty, if you want us to generate a unique coupon code on form submission.
  4. Tick the “Recur” checkbox if your product is a subscription plan and you want to apply the discount not just to the initial payment but to all the recurring payments.
  5. Select the discount type, you can choose between percentage or flat amount.
  6. Enter the discount amount.
  7. Enter the number of times this coupon can be used.
  8. Enter the expiry date (UTC) of the coupon or leave it empty if you do not want it to expire. Please note that the coupon will expire at 23:59:59 on the date specified.
  9. For Coupon Type, select Checkout Coupon to apply the coupon to the entire total of the checkout, regardless of the products being purchased. Or Product Coupon to apply the Coupon to a specific product or set of products.
  10. Add coupon description (for internal use) if needed.
  11. Select or create a coupon group. Groups help you locate the coupons more easily on your dashboard.
  12. Click “Add Coupon”!

Creating coupons via API

The API Documentation outlines the neccessary paramaters to include when creating coupons via our API.

The API is particularly useful when you need to create several coupons in one go as this is not currently possible via the Dashboard.

Applying coupons to the checkout

Once the coupon is created you can share the coupon code with your customers for them to use it in your checkout or apply the coupon to the checkout straight away.

If you want to apply the coupon straight to the checkout so your customers don’t even have to type the coupon in, you can do so using Paddle.js or via the Pay Link API.

Using Paddle.js

Paddle.Checkout.open({
  product: 12345,
  coupon: "DISCOUNT123"
});

Using the Pay Link API

curl -X POST \
     -d 'vendor_id=123' \
     -d 'vendor_auth_code=456bd...' \
     -d 'product_id=123456' \
     -d 'coupon_code=DISCOUNT123' \
     https://vendors.paddle.com/api/2.0/product/generate_pay_link