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
9. Click **Save & Next**
10. Promo has been successfully created. To view the detail of your Promo, click the ellipsis button **( â‹® )** and select **Promo Details**
{% hint style="info" %}
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.
{% endhint %}
***
## 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
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
