[lightMode]

Update Coupon

PUT/coupons/{coupon_id}

[updatedIn] 2 months ago

This endpoint allows you to update details regarding a coupon by passing the coupon_id as a path parameter.

`marketing.read_write`- Marketing Read & Write

Request

Authorization: OAuth 2.0

Add the parameter

Authorization

to [header]，whose value is to concatenate the Token after the Bearer.

[api.label.example]

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

[message.pathParameter]

coupon_id

string

required

Coupon ID. List Coupon IDs can be found here.

code

string

optional

Coupon Code.

Example:

TestCoupon001

type

enum<string>

optional

Coupon Type.

Allowed values:

PercentagepercentageFixedfixedFfPp

Example:

percentage

amount

number

optional

Coupon Amount. Required if the variable type is updated.

Example:

400

status

string

optional

Coupon Status.

Example:

inactive

start_date

string

optional

Coupon Start Date. Supports two formats, either YYYY-MM-DD or YYYY-MM-DD HH:MM:SS

Example:

2022-12-29

expiry_date

string

optional

Coupon Expiry Date. The value of this variable cannot be any date before the start_date variable . Supports two formats, either YYYY-MM-DD or YYYY-MM-DD HH:MM:SS

Example:

2022-12-29

applied_in

enum<string>

optional

Coupon to be applied at. Value can either all or web or app

Allowed values:

allwebapp

Example:

all

usage_limit

number

optional

Coupon Usage Limit.

Example:

usage_limit_per_user

number

optional

Coupon Usage Limit Per User.

Example:

minimum_amount

number

optional

Coupon Minimum Amount.

Example:

maximum_amount

number

optional

Coupon Maximum Amount

Example:

400

free_shipping

boolean

optional

Whether or not the coupon include free shipping

Default:

true

exclude_sale_products

boolean

optional

Whether or not the coupon exclude on-sale products

Default:

true

show_maximum_amount

boolean

optional

Whether or not to show the maximum amount of the coupon

Default:

true

marketing_show_maximum_amount

boolean

optional

Whether or not to show the marketing maximum amount of the coupon to the marketer

Default:

true

marketing_active

boolean

optional

Whether or not the coupon include a marketer

Default:

true

marketing_name

string

optional

Marketer Name. required-if marketing_active = true

Example:

User Test Marketing

marketing_type

enum<string>

optional

Marketer Type. required-if marketing_active = true

Allowed values:

PercentagepercentageFixedfixedFfPp

Example:

Percentage

marketing_amount

number

optional

Marketing Amount. required-if marketing_active = true

Example:

marketing_hide_total_sales

boolean

optional

Whether or not hide total sales

Default:

true

marketing_maximum_amount

number

optional

Marketing Maximum Amount Value. required-if marketing_active = true

Example:

marketing_info

string

optional

Marketing Additional Info

Example:

Additional Info

beneficiary_domain

string

optional

Beneficiary Email Domain

Example:

test.test

products_include

array[string]

optional

List of Included Products in the Coupon. List of products can be found here.

products_exclude

array[string]

optional

List of Excluded Products in the Coupon. List of products can be found here.

list_include_categories

array[string]

optional

List of Included Categories in the Coupon. List of categories can be found here.

list_exclude_categories

array[string]

optional

List of Excluded Categories. List of categories can be found here.

list_exclude_brands

array[string]

optional

List of Excluded Brands. List of brands can be found here.

list_include_groups

array[string]

optional

List of Included Customer Groups. List of customers can be found here.

list_exclude_groups

array[string]

optional

List of Excluded Customer Groups. List of customers can be found here.

list_exclude_shipping

array[string]

optional

List of Excluded Shipping Companies. List of Shipping companies can be found here.

payment_methods

array[string]

optional

List of Included Payment Methods. Available payment methods can be found here.

Allowed values:

allapple_paybankcodcredit_cardknetmadapaypalspotii_paystc_paytabby_installmenttamara_installment

{
  "code": "TestCoupon001",
  "type": "percentage",
  "amount": 400,
  "status": "inactive",
  "start_date": "2022-12-28",
  "expiry_date": "2022-12-29",
  "applied_in": "all",
  "usage_limit": 10,
  "usage_limit_per_user": 10,
  "minimum_amount": 10,
  "maximum_amount": 400,
  "free_shipping": true,
  "exclude_sale_products": true,
  "show_maximum_amount": true,
  "marketing_show_maximum_amount": true,
  "marketing_active": true,
  "marketing_name": "User Test Marketing",
  "marketing_type": "Percentage",
  "marketing_amount": 10,
  "marketing_hide_total_sales": true,
  "marketing_maximum_amount": 20,
  "marketing_info": "Additional Info",
  "beneficiary_domain": "test.test",
  "products_include": [
    "1626467363"
  ],
  "products_exclude": [
    "213592621"
  ],
  "list_include_categories": [
    "676928739"
  ],
  "list_exclude_categories": [
    "1585249762"
  ],
  "list_exclude_brands": [
    "1939592358"
  ],
  "list_include_groups": [
    "322729604"
  ],
  "list_exclude_groups": [
    "1830458757"
  ],
  "list_exclude_shipping": [
    "1345871747"
  ],
  "payment_methods": [
    "bank",
    "cod",
    "credit_card",
    "knet",
    "mada",
    "paypal",
    "spotii_pay",
    "stc_pay",
    "tabby_installment",
    "tamara_installment",
    "apple_pay"
  ]
}

Request samples

[api.label.responses]

Success(200)

Not Found(404)

Error Validation(422)

HTTP Code: 200

Content Type : JSONapplication/json

status

number

optional

Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.

success

boolean

optional

Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.

data

object (Coupon)

optional

number

required

Coupon ID. List Coupon ID can be found here.

Example:

815296212

code

string

required

Coupon Code

Example:

AAVVC

type

enum<string>

required

Coupon Type.

Allowed values:

PercentagepercentageFixedfixedFfPp

Example:

percentage

status

enum<string>

required

Coupon Status.

Allowed values:

activeinactivedeleted

Example:

active

amount

object

required

Coupon amount.

minimum_amount

object

required

The minimum coupon amount.

maximum_amount

object

required

The maximum coupon amount.

show_maximum_amount

boolean

required

Whether or not to show the Coupon's Maximum Amount

Default:

false

expiry_date

string

required

Coupon Expiry Date. Value MUST be at least one day later than today. Supports two formats, either YYYY-MM-DD or YYYY-MM-DD HH:MM:SS

Example:

2022-12-31 12:59:59

start_date

string

required

Coupon Start Date. Supports two formats, either YYYY-MM-DD or YYYY-MM-DD HH:MM:SS

Example:

2022-12-28 12:59:59

free_shipping

boolean

required

Whether or not to the Coupon includes Free Shipping

Default:

true

usage_limit

number

required

Coupon's Usage Limit

Example:

usage_limit_per_user

number

required

Coupon's Usage Limit Per User

Example:

include_product_ids

array[string]

required

List of included Product IDs. List of products ca be found [here]https://docs.salla.dev/api-5394168).

exclude_product_ids

array[string]

required

List of excluded Product IDs. List of products ca be found [here]https://docs.salla.dev/api-5394168).

is_sale_products_exclude

boolean

required

Whether or not to exclude On-Sale Products

Default:

true

include_category_ids

array[string]

required

List of included product Category IDs. List of categories can be found [here] (https://docs.salla.dev/api-5394207)

exclude_category_ids

array[string]

required

List of included Category IDs. List of categories can be found [here] (https://docs.salla.dev/api-5394207)

include_customer_group_ids

array[string]

required

List of included Customer Group IDs. List of customer groups can be found [here] (https://docs.salla.dev/api-5394129)

exclude_customer_group_ids

array[string]

required

List of excluded Customer Group IDs. List of customer groups can be found [here] (https://docs.salla.dev/api-5394129)

exclude_brands_ids

array[string]

required

List of excluded Brand IDs. List of brands can be found [here] (https://docs.salla.dev/api-5394213)

exclude_shipping_ids

array[string]

required

List of excluded Shipment Company IDs. Shipping companies list can be found here

include_customer_ids

array[string]

required

List of excluded Customer IDs. List of customers can be found [here] (https://docs.salla.dev/api-5394121)

include_payment_methods

array[string]

required

List of included Payment Methods. List of Available Payment Methods can be found here.

Allowed values:

allapple_paybankcodcredit_cardknetmadapaypalspotii_paystc_paytabby_installmenttamara_installment

applied_in

enum<string>

required

Coupon to be applied at. Value can either all or web or app

Allowed values:

allwebapp

Example:

all

is_group

boolean

required

Whether or not the Coupon is part of a group of Coupons

Default:

true

group_name

string | null

required

Coupon Group Name. requiredif is_group = true; otherwise returns null value

Example:

Grouping1

group_coupons_count

number | null

required

Coupon Group Count.requiredif is_group = true; otherwise returns null value

Example:

group_coupon_suffix

string | null

required

Coupon Group Suffix. requiredif is_group = true; otherwise returns null value

Example:

xyz

group_coupons

array [object {1}]

required

Group Coupons. requiredif is_group = true; otherwise returns null value

beneficiary_domain

string | null

required

Beneficiary’s Email Domain Name

Example:

domain.test

statistics

object

required

Coupon statistics.

Example:

domain.test

created_at

object

required

Date and time of creating the coupon.

updated_at

object

required

Date and time of updating the coupon.

marketing_active

boolean

required

Whether or not the Marketing is active for a certain Coupon

Default:

true

marketing_name

string | null

required

Marketer name assoicated to the Coupon. requiredif marketing_active = true; otherwise returns null value

Example:

User Name

marketing_email

string | null

required

Marketer email assoicated to the Coupon. Value may appear if marketing_acive: true; otherwise returns null value.

Example:

[email protected]

marketing_type

enum<string> | enum<null>

required

Marketing Type. requiredif marketing_active = true; otherwise returns null value

Allowed values:

PercentagepercentageFixedfixedFfPp

Example:

fixed

marketing_amount

object | null

required

The amount due to the marketer. requiredif marketing_active = true; otherwise returns null value

marketing_hide_total_sales

boolean | null

required

Whether or not to hide the total sales from the marketer's stastics page. Value may appear if marketing_acive: true; otherwise returns null value.

Default:

false

marketing_show_maximum_amount

boolean | null

required

Whether or not to show the maximum amount of marketing amount to the marketers. Value may appear if marketing_acive: true; otherwise returns null value.

Default:

true

marketing_maximum_amount

number | null

required

Marketing maximum amount. Value may appear if marketing_acive: true; otherwise returns null value.

Default:

Example:

4000

marketing_info

string | null

required

Additional Notes to the Marketer. Value may appear if marketing_acive: true; otherwise returns null value.

Example:

Additional Notes

marketing_visits_count

number | null

required

Marketing Visit Counts. Value may appear if marketing_acive: true; otherwise returns null value.

Example:

marketing_url

string | null

required

Marketing URL. Value may appear if marketing_acive: true; otherwise returns null value.

Example:

https://salla.sa/teststore?utm_source=ref&utm_campaign=QAZCVS

marketing_statistics_url

string | null

required

Marketing Statistics URL. Value may appear if marketing_acive: true; otherwise returns null value.

Example:

https://mtjr.coupons/VvVMP

{
  "status": 200,
  "success": true,
  "data": {
    "id": 1279613668,
    "code": "TestCoupon001",
    "type": "percentage",
    "status": "inactive",
    "amount": {
      "amount": 400,
      "currency": "SAR"
    },
    "minimum_amount": {
      "amount": 10,
      "currency": "SAR"
    },
    "maximum_amount": {
      "amount": 20,
      "currency": "SAR"
    },
    "show_maximum_amount": true,
    "expiry_date": "2022-12-29 00:00:00",
    "free_shipping": true,
    "usage_limit": 10,
    "usage_limit_per_user": 10,
    "include_product_ids": [
      "1626467363"
    ],
    "exclude_product_ids": [
      "213592621"
    ],
    "is_sale_products_exclude": true,
    "include_category_ids": [
      "676928739"
    ],
    "exclude_category_ids": [
      "1585249762"
    ],
    "include_customer_group_ids": [
      "322729604"
    ],
    "exclude_customer_group_ids": [
      "1830458757"
    ],
    "exclude_brands_ids": [
      "1939592358"
    ],
    "exclude_shipping_ids": [
      "1345871747"
    ],
    "include_customer_ids": [],
    "include_payment_methods": [
      "bank",
      "cod",
      "credit_card",
      "knet",
      "mada",
      "paypal",
      "spotii_pay",
      "stc_pay",
      "tabby_installment",
      "tamara_installment",
      "apple_pay"
    ],
    "applied_in": "all",
    "is_group": true,
    "group_name": "Grouping",
    "group_coupons_count": 90,
    "group_coupon_suffix": null,
    "beneficiary_domain": "test.test",
    "created_at": {
      "date": "2022-01-23 09:36:30.000000",
      "timezone_type": 3,
      "timezone": "Asia/Riyadh"
    },
    "updated_at": {
      "date": "2022-01-23 10:17:34.000000",
      "timezone_type": 3,
      "timezone": "Asia/Riyadh"
    },
    "marketing_active": true,
    "marketing_name": "Mohammed Test",
    "marketing_type": "percentage",
    "marketing_amount": {
      "amount": 10,
      "currency": "SAR"
    },
    "marketing_hide_total_sales": true,
    "marketing_show_maximum_amount": true,
    "marketing_maximum_amount": 4000,
    "marketing_info": "Additional Info",
    "marketing_visits_count": 0,
    "marketing_url": "https://mtjr.coupons/jXvoE"
  }
}

[updatedIn] 2 months ago