BigCommerce
Store Operations
Promotions
Examples
Customer Promotions

Customer Promotion Code Samples

10% off for VIP customers

Example request
{
  "name": "10% off for VIP customers",
  "redemption_type": "AUTOMATIC",
  "customer": {
    "group_ids": [
      1
    ]
  },
  "rules": [
    {
      "action": {
        "cart_value": {
          "discount": {
            "percentage_amount": "10"
          }
        }
      }
    }
  ]
}

5% off for non-VIP customers (including guest customers, and registered customers who are not assigned to any groups, and registered customers who are assigned to a non-VIP group)

Example request
{
  "name": "5% off for non-VIP customers",
  "redemption_type": "AUTOMATIC",
  "customer": {
    "excluded_group_ids": [
      1
    ]
  },
  "rules": [
    {
      "action": {
        "cart_value": {
          "discount": {
            "percentage_amount": "5"
          }
        }
      }
    }
  ]
}

3% off for guest customers or customers not assigned to any group

Example request
{
  "name": "3% off for guest customers or customers not assigned to any group",
  "redemption_type": "AUTOMATIC",
  "customer": {
    "group_ids": [
      0
    ]
  },
  "rules": [
    {
      "action": {
        "cart_value": {
          "discount": {
            "percentage_amount": "3"
          }
        }
      }
    }
  ]
}

10% off for customers with total order count of 10 or more

Example request
{
  "name": "10% off for customers with total order count of 10 or more",
  "redemption_type": "AUTOMATIC",
  "customer": {
    "minimum_order_count": 10
  },
  "rules": [
    {
      "action": {
        "cart_value": {
          "discount": {
            "percentage_amount": "10"
          }
        }
      }
    }
  ]
}

10% off for customers who belong to segment 1 or segment 2 (Closed Beta)

Example request
{
  "name": "10% off for customers who belong to segment 1 or segment 2",
  "redemption_type": "AUTOMATIC",
  "customer": {
    "segments": {
      "isd": [
        "61fd72bc-7400-4a7b-ac64-96c0d315c464",
        "d52fb39d-6715-430e-a0bf-21a192d790f0"
      ]
    }
  },
  "rules": [
    {
      "action": {
        "cart_value": {
          "discount": {
            "percentage_amount": "10"
          }
        }
      }
    }
  ]
}

10% off for customers who do NOT belong to segment 1, including those who do not belong to any segments(Closed Beta)

Example request
{
  "name": "10% off for customers who do not belong to segment 1",
  "redemption_type": "AUTOMATIC",
  "customer": {
    "segments": {
      "not": {
        "id": [
          "61fd72bc-7400-4a7b-ac64-96c0d315c464"
        ]
      }
    }
  },
  "rules": [
    {
      "action": {
        "cart_value": {
          "discount": {
            "percentage_amount": "10"
          }
        }
      }
    }
  ]
}

10% off for customers who belong to segment 1 and segment 2 (Closed Beta)

Example request
{
  "name": "10% off for customers who belong to segment 1 and segment 2",
  "redemption_type": "AUTOMATIC",
  "customer": {
    "segments": {
      "and": [
        {
          "id": ["61fd72bc-7400-4a7b-ac64-96c0d315c464"]
        },
        {
          "id": ["d52fb39d-6715-430e-a0bf-21a192d790f0"]
        }
      ]
    }
  },
  "rules": [
    {
      "action": {
        "cart_value": {
          "discount": {
            "percentage_amount": "10"
          }
        }
      }
    }
  ]
}

10% off for customers who belong to segment 3 or customers who belong to segment 1 and segment 2 (Closed Beta)

Example request
{
  "name": "10% off for customers who belong to segment 3 or customers who belong to segment 1 and segment 2",
  "redemption_type": "AUTOMATIC",
  "customer": {
    "segments": {
      "or": [
        {
          "id": ["4d843892-d90c-4f01-a36e-ce810172c094"]
        },
        {
          "and": [
            {
              "id": ["61fd72bc-7400-4a7b-ac64-96c0d315c464"]
            },
            {
              "id": ["d52fb39d-6715-430e-a0bf-21a192d790f0"]
            }
          ]
        }
      ]
    }
  },
  "rules": [
    {
      "action": {
        "cart_value": {
          "discount": {
            "percentage_amount": "10"
          }
        }
      }
    }
  ]
}
Did you find what you were looking for?