Set Up a Promo

Create a Promo

You can create a promo by following the steps below:

1. Log in to DOKU Dashboard, and then access the side navigation bar

2. Select Promo from the menu

3. Promo page will appear, then click Create

4. General Information tab will appear, then fill the form that includes data such as

   • Promo Name - maximum of 15 characters

   • Promo Code - unique code that consists of uppercase letters and numbers

   • Promo Description - maximum of 300 characters

   • Start & End Date - follows format of dd/MM/yyyy HH:mm.

   • Terms & Condition - may contain text or links to a social media or website.

   
5. Click Save & Next

6. Promo Specification tab will appear, then fill the form that includes data such as

   • Discount Type - can be either be flat rate or percentage

   • Budget - can only contain numbers

   • Discount Amount - can only contain numbers

   • Max Discount Amount - can only contain numbers

   • Max Transaction Limit - can only contain numbers

   • Max Transaction / Account - can only contain numbers

   • Setting Promo by SKU (optional)

   

   You can set up a promo by importing a file using the provided template
7. Click Save & Next

8. Payment Details tab will appear, then select the payment method(s) you want to include in the promo by following the steps below:

   1. Click Only Certain Payment Methods

   2. Choose the payment method(s) eligible for the promo

   3. Activate Customer Identifier if the promo is targeted to specific customers, where you can fill in the following fields:

      1. Max Transaction per Account

      2. Transaction Cycle (Daily or During Promo)

   4. Customer Identifiers vary by payment method:

      1. Cards:

         • Email

         • Phone Number

         • Customer ID

         • Card Number

      2. DOKU e-Wallet

         • Email

         • Phone Number

         • Customer ID

   5. Choose if the promo applies to All Banks or Specific Banks. If you select specific banks, you’ll need to upload a BIN list containing the eligible card numbers.

   6. Activate Custom Object Promo if the promo requires specific criteria. Define the criteria, operator, and value to set custom conditions.

Note: Only Cards and DOKU e-Wallet are currently available

1. Click Save & Next

2. Promo has been successfully created. To view the detail of your Promo, click the ellipsis button and select Promo Details

   

   

Please note that Budget and Terms of Conditions cannot be altered once they have been activated. You have the option to save the campaign as a draft and schedule the activation of the promo based on a date that you designated.

---

Promo Details

General Information

Field	Description
Promo Name	The official title of the promotion Example: "Holiday Sale 2025"
Promo Code	A unique alphanumeric code that customers can enter to redeem the promotion. It must be unique and in capital letters
Description	A brief explanation of the promotion's purpose, benefits, and how it works. This is shown to customers wherever the promo is displayed
Start Date	The date and time when the promotion becomes active. Transactions before this time are not eligible for the promo
End Date	The date and time when the promotion expires. Transactions after this time will no longer qualify for the promo
Terms & Conditions	The detailed rules and restrictions that govern the promotion. This can be shown as plain text or as a link to an external page Example: "View full terms at example.com/terms"

---

Promo Specification

Field	Description
Promo Category	The classification of the promotion for reporting or segmentation purposes Example: "Discount", "Cashback"
Budget	The total monetary allocation for the promotion. Once the budget is depleted, the promo becomes inactive
Discount Type (Flat / Percentage)	Defines how the discount is calculated. Options include: • Flat – Fixed amount off • Percentage – Percentage off the transaction value
Discount Amount	The value of the discount given, based on the selected Discount Type Example: IDR 50,000 for Flat, IDR 10,000 for 10% Percentage discount
Max Discount Amount	The maximum discount a customer can receive per transaction
Min Transaction Amount	The minimum transaction value required to apply the promo Example: Promo only applies to purchases over IDR 100,000
Max Transaction Limit	The total number of transactions across all users that can use this promo before it becomes inactive
Max Transactions per Day	The maximum number of promo redemptions allowed in a single day across all customers
Promo by SKU	Allows merchants to apply the promotion only to specific products identified by their SKU (Stock Keeping Unit). The promo will be validated only if the transaction includes one or more of the specified SKUs, matched via the line_items parameter in the DOKU Checkout API. Merchants can upload the SKU list using a provided template

---

Payment Details

Field	Description
Max Transactions per Account	The maximum number of times a single customer/account can redeem this promo
Transaction Cycle	The interval for evaluating limits per user (e.g., Daily, During Promo)
Customer Identifier	The unique field used to track customer usage of the promo Example: Email, Phone Number, Customer ID
Payment Details	Allows the merchant to choose which payment methods are eligible for the promotion. Supported methods include Cards and e-Wallet. For Cards payment method, merchants can apply the promo to all banks or restrict it to specific banks by uploading a list of BINs (Bank Identification Numbers)
Custom Object Promo	Enables merchants to define custom conditions for promo eligibility using a combination of fields, operators, and values. These conditions allow for advanced targeting (e.g., customer type, platform, etc.) When making a payment request via the DOKU Checkout API, merchants must include the parameter: additional_info.customObjectsPromo