---
schema_version: "1"
id: 54b6248aba4543d045b57e4cd29857b1637bb05602f69ba81ed7efa83f03d33e
title: Single-Use Promotion Code
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/retail-cloud/guides/single-use-promotion-code.md
canonical_url: https://developer.salesforce.com/docs/commerce/retail-cloud/guide/single-use-promotion-code.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: bb24a5a6127c69bc7cea6c39dfcacadd2186d61623002b780dadbe3ba27bb829
products:
  - Point of Sale for Developers
  - Salesforce APIs
---
# Single-Use Promotion Code

Configure and set up single-use promotion codes (SUPC) in Point of Sale CMS.

Salesforce supports SUPC validation outside the Point of Sale Promotion Engine through an SPI. If a code is entered in the Point of Sale app, the code is first checked in the Point of Sale system. If the code isn't found, it is checked in the merchant's external system. See [Create Promotions in Point of Sale CMS](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_modules_promotions.htm&type=5) in _Salesforce Help_.

## Prerequisites

- Modern POS App Build: 10.3.1 or greater
- Platform Support: iPad & iPhone
- Offline Support: no

## Configure Point of Sale CMS for SPI SUPC

1. In CMS, go to **Integrations** | **Custom Connectors**.

2. Click **Create**.

3. For Connector Type, select **SPI**.

4. For Endpoint Name, select **SUPC_PROMOTION_CODE_VALIDATION**.

5. For API Endpoint, provide the external endpoint for validating SUPCs.

6. For Integration Type, select **HTTP_POST**.

7. Specify any JSON headers that must be passed.

8. Configure the rest of the fields for the SPI. See [Point of Sale API, SPI, and Webhook Overview](https://developer.salesforce.com/docs/commerce/retail-cloud/guide/retail-cloud-api-spi-webhook-specs.html).

9. Save your changes. ![The SUPC settings in Point of Sale CMS.](https://developer.salesforce.com/docs/media/retail-cloud/rt-cms-modules-supc-in-cms.png)