> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Currency-Specific Promotions

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`**

```http title="Example request: Create a currency-specific promotion" showLineNumbers={false}
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
            ]
          }
        }
      }
    }
  ]
}
```