LogoLogo
Log In DashboardAPI ReferenceDOKU Website
  • Introduction
  • Get Started
    • Create Account
    • Activate Business
    • Manage Business
      • Manage Team Members
      • Activate Services
      • Manage Payment Methods
      • Set Up Integration
        • Accept Payments
      • Manage Finances
        • Custom Settlement
          • Split Settlement
          • Hold and Release
          • Custom Report
        • Refund
        • Dispute
      • Manage Reports
        • Analytics
        • Transaction Report
        • Settlement Report
      • Manage Operations
      • Manage Customers
      • Set Up a Promo
      • Manage Multiple Brands
        • Company Dashboard
      • Update Business Data
    • Manage User Account
      • Change Password
      • Enable 2-Step Verification
  • Accept Payments
    • No-Integration Products
      • Payment Link
        • Create Payment Link
        • Manage Payment Link
        • Customize Checkout Page
      • e-Katalog
        • Manage Catalog
        • Manage Items
        • Place an Order
        • Manage Orders
      • QRIS
      • PayChat
        • My WhatsApp Business
        • Accept Order
      • Virtual Terminal
    • Integration Tools
      • DOKU Checkout
        • Customize Checkout Page
        • Configure Notifications
        • Manage Checkout Orders
      • Direct API
      • e-Commerce and Plugins
        • Shopify
        • WooCommerce (WordPress)
        • Adobe Commerce (Magento)
      • SDKs and Libraries
    • Payment Methods
      • Requirements and Limitations
    • Finance & Settlement
      • Settlement Time
      • Pricing and Fees
      • Business Loan
      • Refund & Chargeback
    • Promo Engine
  • Payouts
    • Domestic Payouts
      • List of Banks
      • List of e-Wallet
      • List of Virtual Accounts
    • Cash Out
  • Wallet as a Service
    • Consumer Wallet
      • Embedded Wallet
    • Business Wallet
      • Balance Management System
  • Mobile Apps
    • Juragan DOKU
    • DOKU e-Wallet
      • Account Settings
      • Account Verification
      • Top-Up and Withdrawal
      • Online Transactions and Purchases
  • Use Cases
    • 🎓Education
    • 🎮Digital & Gaming
    • 💸Insurance
    • ✏️Freelance
    • 🍽️Food & Beverages
    • 🛒Retail
    • ✈️Travel & Hospitality
    • 🚚Logistics
  • Partner
    • Become a Partner
  • Security
    • Licenses
  • Miscellaneous
    • Glossary
    • SNAP Migration
    • Contact Support
  • Terms & Conditions
  • Privacy Policy
Powered by GitBook
On this page
  • Create a Promo
  • Promo Details
  • General Information
  • Promo Specification
  • Payment Details

Was this helpful?

Export as PDF
  1. Get Started
  2. Manage Business

Set Up a Promo

PreviousManage CustomersNextManage Multiple Brands

Last updated 24 days ago

Was this helpful?

Create a Promo

You can create a promo by following the steps below:

  1. Log in to , 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)

  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.

  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

DOKU Dashboard
You can set up a promo by importing a file using the provided template
Note: Only Cards and DOKU e-Wallet are currently available