For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
  • Overview
    • Quick Start
    • Sandboxes
    • Tools & SDKs
    • Support
  • Docs
      • Getting Started
        • Products overview
        • Contextual filters
          • Overview
          • Currency-Specific Promotions
          • Multi-Currency
          • API vs UI Features
    • Archive
    • Closed Beta Programs
Dev Portal
LogoLogo
DocsAdminCatalog and InventoryPromotions

Currency-Specific Promotions

Was this page helpful?
Previous

Overview

Next

Multi-Currency

Built with

You can configure the promotion to target a single currency when creating a promotion. The promotion will only run when the shopper selects the same transactional currency within the cart and checkout.

Here is an example promotion that offers 20 USD off garden material. This promotion will only run if the shopper uses USD as a transactional currency.

Example request: Create a currency-specific promotion
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/v3/promotions
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
{
  "name": "20 USD dollar off all Garden material",
  "currency_code": "USD",
  "redemption_type": "AUTOMATIC",
  "rules": [
    {
      "action": {
        "cart_items": {
          "discount": {
            "fixed_amount": "20"
          },
          "items": {
            "categories": [
              19
            ]
          }
        }
      }
    }
  ]
}