post

/2.1/product/update_coupon

Update an existing coupon in your account

Example Request

curl -X POST -d 'vendor_id=1234567' \
             -d 'vendor_auth_code=123456abc...' \
             -d 'coupon_code=20OFF' \
             -d 'expires=2021-12-31' \
https://vendors.paddle.com/api/2.1/product/update_coupon

Usage Notes

There are 2 main ways to select which coupon(s) you want to update:

To update a single coupon code, specify the coupon_code.
To update a group of coupons, specify their unique group name.

You can then apply any changes you wish, for example:

Rename the coupon name (note: if you have already distributed the coupon code to your customers, we recommend not doing so)
Extend the expiry date to keep a successful promotion going
Update the discount amount because you changed your mind
Make a new product eligible with the coupons

Request Body

Form data (application/x-www-form-urlencoded)

vendor_id

integer

The vendor ID identifies your seller account. This can be found in Developer Tools > Authentication.

required

minimum: 1

pattern: \d+

vendor_auth_code

string

The vendor auth code is a private API key for authenticating API requests. This key should never be used in client side code or shared publicly. This can be found in Developer Tools > Authentication.

required

pattern: [0-9a-f]+

coupon_code

string

Identify the coupon to update (You must specify either coupon_code or group, but not both).

maxLength: 300

minLength: 5

group

string

The name of the group of coupons you want to update.

maxLength: 50

minLength: 1

new_coupon_code

string

New code to rename the coupon to.

maxLength: 300

minLength: 5

new_group

string

New group name to move coupon to.

maxLength: 50

minLength: 1

product_ids

string

Comma-separated list of products e.g. 499531,1234,123546. If blank then remove associated products.

expires

string

The date (in format YYYY-MM-DD) the coupon is valid until. The coupon will expire on the date at 00:00:00 UTC.

format: date

pattern: \d{4}-\d{2}-\d{2}

allowed_uses

integer

Number of times each coupon can be used.

pattern: \d+

currency

string

Currency of the discount_amount (required if the coupon’s discount_type is flat). The currency must match the balance currency specified in your account here.

Allowed Values: USD, GBP, EUR

pattern: [A-Z]{3}

discount_amount

number

A currency amount (eg. 10.00) if discount_type is flat, or a percentage amount (eg. 10 for 10%) if discount_type is percentage.

pattern: ^\d+(\.\d{2})?$

recurring

integer

If the coupon is used on subscription products, this indicates whether the discount should apply to recurring payments after the initial purchase.

Allowed Values: 0, 1

Responses

1 Example

Schema

object

An unsuccessful call to the Dashboard API will return a 200 response containing a field success set to false and an error object.

Send a Test Request

Send requests directly from the browser (CORS must be enabled)

$$.env

No $$.env variables are being used in this request.