Promo Engine Payment Gateway adalah fitur untuk mengelola dan menerapkan promo secara otomatis dalam proses pembayaran, mulai dari penggunaan kode promo, penentuan pelanggan yang berhak mendapatkan diskon, pengaturan periode campaign, hingga pembatasan penggunaan promo. Dengan pengelolaan promo yang terintegrasi, merchant dapat menjalankan campaign untuk mendorong transaksi dan pembelian ulang dengan lebih efisien.
Dalam payment gateway seperti DOKU, implementasi promo dapat disesuaikan dengan metode integrasi yang digunakan merchant, baik melalui DOKU Checkout atau Hosted Payment Page maupun DOKU Direct API atau Self-Hosted Checkout.
Apa itu Promo Engine dan Kode Promo di Payment Gateway?

Promo Engine Payment Gateway adalah mekanisme yang digunakan untuk mengelola aturan promo dan menerapkannya pada transaksi pembayaran. Sementara itu, kode promo merupakan kode tertentu yang dimasukkan pelanggan untuk mendapatkan manfaat seperti potongan harga, cashback, atau promo khusus lainnya.
Promo Engine Payment Gateway berfungsi menentukan apakah sebuah promo dapat digunakan dalam transaksi. Sistem dapat memeriksa berbagai parameter, seperti:
- Kode promo yang dimasukkan pelanggan.
- Periode berlaku promo.
- Minimum nilai transaksi.
- Produk atau kategori yang memenuhi syarat.
- Segmentasi pelanggan.
- Jumlah penggunaan promo.
- Besaran diskon atau benefit.
- Batas maksimal potongan.
- Status transaksi.
Dengan sistem tersebut, merchant tidak perlu mengecek secara manual. aturan promo dapat diterapkan secara konsisten sebelum transaksi diproses.
Baca juga: Optimalkan Transaksi Bisnis Dengan Payment Gateway DOKU
Cara Kerja Kode Promo pada DOKU Checkout

DOKU Checkout merupakan solusi payment gateway hosted yang menyediakan halaman pembayaran siap pakai bagi bisnis. Selain memudahkan pelanggan menyelesaikan transaksi, DOKU Checkout juga dilengkapi fitur kode promo yang memungkinkan merchant memberikan diskon atau penawaran khusus secara langsung pada halaman pembayaran.
Penggunaan kode promo pada checkout umumnya berlangsung melalui beberapa tahap berikut:
- Input Kode Promo: Pelanggan memasukkan kode promo pada halaman pembayaran.
- Validasi Promo: Sistem memeriksa eligibility, periode berlaku, minimum transaksi, dan limit penggunaan.
- Perhitungan Benefit: Jika memenuhi syarat, promo engine menghitung nominal diskon atau benefit yang didapatkan.
- Update Total Pembayaran: Total transaksi diperbarui sesuai nilai promo yang berhasil diterapkan.
- Pembayaran & Reporting: Pelanggan melanjutkan pembayaran, sementara data penggunaan promo dapat dicatat untuk kebutuhan monitoring.
Dengan alur tersebut, merchant dapat memastikan promo hanya diterapkan pada transaksi yang memenuhi ketentuan.
Implementasi Promo pada DOKU Checkout
Pada DOKU Checkout atau Hosted, merchant dapat menggunakan halaman pembayaran yang disediakan payment gateway sehingga tidak perlu membangun seluruh komponen payment flow dari sisi frontend. Skema alurnya adalah:
- Customer Pilih Promo
- Customer Masuk ke DOKU Checkout
- Customer Masukkan Kode Promo
- Sistem Memvalidasi Promo
- Benefit Promo Diterapkan
- Customer Melanjutkan Pembayaran
Untuk penjelasan yang lebih detail, simak uraian berikut ini.
1. Kode Promo pada Checkout
Kode promo dapat ditampilkan pada halaman pembayaran sehingga pelanggan dapat memasukkan kode sebelum menyelesaikan pembayaran.
Fitur Promo Code saat ini hanya tersedia untuk akun bisnis Indonesia (ID), tetapi tidak tersedia untuk akun Business Malaysia (MY).
2. Validasi Aturan Promo (Rule)
Setelah kode dimasukkan, sistem memeriksa ketentuan promo, seperti eligibility pelanggan, periode berlaku, minimum transaksi, dan batas penggunaan.
3. Perhitungan Benefit
Jika kode promo memenuhi seluruh ketentuan, sistem menghitung benefit sesuai aturan yang telah ditentukan, seperti diskon persentase atau potongan nominal tertentu.
4. Update Nominal Pembayaran
Benefit promo yang berhasil diterapkan akan memperbarui total transaksi yang ditampilkan kepada pelanggan sebelum pembayaran diproses.
5. Lebih Praktis untuk Campaign
Pendekatan Hosted Checkout dapat membantu merchant meluncurkan campaign tanpa harus membangun seluruh komponen checkout secara mandiri. Merchant tetap perlu menentukan business rule promo agar penggunaannya sesuai dengan tujuan campaign.
Baca juga: Pahami peluang Bisnis Dengan DOKU Checkout
Implementasi Promo Engine pada Direct API
Secara sederhana, implementasi pada Direct API memiliki alur seperti berikut.

Pada DOKU Direct API, merchant menggunakan halaman pembayaran milik sendiri di website atau aplikasi melalui pendekatan self hosted payment gateway. Dengan demikian, merchant memiliki kontrol lebih besar terhadap tampilan dan alur checkout, termasuk penempatan serta validasi kode promo. Berikut penjelasan lebih lengkapnya.
1. Kode Promo di Checkout Merchant
Merchant dapat menempatkan kolom kode promo langsung pada website atau aplikasi. Pelanggan kemudian memasukkan kode sebelum melanjutkan pembayaran.
2. Validasi melalui Backend
Kode promo yang dimasukkan akan diproses oleh backend merchant untuk memeriksa apakah pelanggan dan transaksi memenuhi aturan promo yang berlaku.
3. Perhitungan dan Update Nominal
Jika promo valid, sistem menghitung benefit dan memperbarui total transaksi sebelum nominal pembayaran dikirim ke payment gateway.
4. Integrasi dengan Sistem Merchant
Direct API memungkinkan promo dihubungkan dengan sistem internal seperti loyalty program, membership, CRM,atau segmentasi pelanggan.
5. Konsistensi Nominal Transaksi
Merchant perlu memastikan nominal setelah promo yang dikirim ke payment gateway sesuai dengan hasil validasi agar tidak terjadi perbedaan nilai antara checkout dan transaksi pembayaran.
Aturan Promo: Eligibility, Periode, Minimum Transaksi, dan Limit
Aturan promo engine yang jelas diperlukan agar promo tidak digunakan di luar ketentuan campaign. Beberapa aturan yang umum digunakan antara lain sebagai berikut.
1. Eligibility
Eligibility menentukan siapa yang berhak menggunakan promo. Contohnya, promo hanya berlaku untuk pelanggan baru, member tertentu, atau pengguna yang menerima campaign secara khusus.
2. Periode Promo
Merchant dapat menentukan tanggal dan waktu mulai serta berakhirnya promo. Aturan ini penting untuk campaign yang memiliki durasi terbatas, seperti promo payday atau flash sale.
3. Minimum Transaksi
Promo dapat mensyaratkan nominal transaksi tertentu. Contohnya, kode HEMAT50 hanya berlaku untuk transaksi minimal Rp500.000.
4. Limit Penggunaan
Merchant dapat membatasi berapa kali promo dapat digunakan secara keseluruhan maupun oleh setiap pelanggan. Misalnya, satu kode hanya tersedia untuk 1.000 transaksi atau maksimal satu kali penggunaan per customer.
5. Benefit dan Discount Cap
Selain persentase atau nominal diskon, merchant juga dapat menetapkan batas maksimum potongan. Contohnya, diskon 20% dengan maksimum potongan Rp50.000. Ketentuan diskon yang kompleks membutuhkan pengelolaan promo engine yang terstruktur agar tidak terjadi crash.
Validasi Promo dan Error Handling
Validasi menjadi bagian penting dalam implementasi Promo Engine Payment Gateway. Selain mengetahui apakah kode promo valid, sistem juga perlu memberikan respons yang tepat ketika promo tidak dapat digunakan.
Beberapa kondisi yang umum terjadi adalah:
- Kode promo tidak ditemukan.
- Kode sudah kedaluwarsa.
- Minimum transaksi belum terpenuhi.
- Kuota promo sudah habis.
- Pelanggan tidak memenuhi eligibility.
- Promo tidak berlaku untuk produk tertentu.
- Kode sudah pernah digunakan oleh pelanggan.
- Promo tidak dapat digabungkan dengan promo lain.
Pesan error sebaiknya dibuat jelas dan mudah dipahami pelanggan. Misalnya, dibandingkan menampilkan pesan ‘PROMO_INVALID’, checkout dapat memberikan informasi seperti ‘kode promo sudah tidak berlaku, silakan gunakan kode promo lainnya’.
Di sisi backend, merchant juga perlu menyimpan error code atau alasan penolakan untuk kebutuhan troubleshooting dan analisis campaign.
Baca juga: 13+ Cara Membuat Promo yang Menarik, Siap Praktik
Reporting dan Monitoring Promo
Promo yang berhasil meningkatkan transaksi perlu dapat diukur. Karena itu, reporting menjadi bagian penting dalam implementasi promo engine.
Merchant dapat memonitor beberapa metrik, seperti:
- Jumlah kode promo yang digunakan.
- Jumlah transaksi yang menggunakan promo.
- Total nilai transaksi.
- Total diskon yang diberikan.
- Conversion rate.
- Average order value.
- Penggunaan promo berdasarkan periode.
- Penggunaan berdasarkan customer segment.
- Jumlah promo yang ditolak.
Data tersebut dapat membantu merchant mengetahui apakah campaign benar-benar menghasilkan incremental sales atau hanya memberikan diskon kepada pelanggan yang memang sudah akan melakukan pembelian.
Monitoring juga penting untuk mendeteksi penggunaan promo yang tidak normal, terutama ketika campaign memiliki kuota atau budget terbatas.
Promo Engine vs Diskon di Sistem Merchant
Promo Engine Payment Gateway dan sistem diskon internal merchant dapat digunakan untuk mengelola promo, tetapi memiliki fokus dan fungsi yang berbeda.

Keduanya juga dapat digunakan secara bersamaan. Sistem merchant dapat menentukan harga dan eligibility produk, sementara Promo Engine Payment Gateway menangani rule promo yang berkaitan dengan campaign pembayaran.
Use Case Promo untuk Campaign, Acquisition, dan Retention
Promo Engine Payment Gateway dapat digunakan untuk berbagai strategi marketing.
1. Campaign dan Seasonal Promo
Merchant dapat membuat kode khusus untuk campaign seperti Harbolnas, payday, anniversary, atau seasonal sale. Aturan seperti periode dan kuota dapat membantu campaign berjalan sesuai budget.
2. Customer Acquisition
Kode promo dapat ditujukan kepada pelanggan baru sebagai incentive untuk melakukan transaksi pertama. Merchant dapat menetapkan aturan bahwa promo hanya berlaku untuk customer yang belum pernah melakukan pembayaran sebelumnya.
3. Customer Retention
Untuk meningkatkan repeat order, merchant dapat memberikan kode promo kepada pelanggan yang sudah pernah melakukan transaksi. Misalnya, pelanggan mendapatkan voucher yang berlaku selama tujuh hari setelah pembelian pertama.
4. Segment-Specific Promotion
Promo juga dapat ditargetkan kepada segmen tertentu berdasarkan membership, campaign source, atau karakteristik pelanggan yang ditentukan merchant.
Jalankan Promo, Terima Pembayaran, dan Kelola Transaksi Bisnis Bersama DOKU

Program promo membantu bisnis menarik pelanggan, meningkatkan peluang penyelesaian pembelian, dan menjalankan campaign yang lebih terarah. Melalui DOKU Payment Gateway, bisnis dapat mengintegrasikan program promo dengan penerimaan pembayaran hingga pengelolaan transaksi dalam satu ekosistem.
Melalui payment gateway checkout dari DOKU Checkout, merchant dapat menerapkan Promo Code pada halaman pembayaran siap pakai, khusus untuk akun bisnis Indonesia. Sementara itu, DOKU Direct API merupakan solusi self hosted payment gateway yang memungkinkan merchant mengintegrasikan promo engine sendiri pada halaman pembayaran milik bisnis.
Untuk menerima pembayaran, layanan payment gateway DOKU mendukung 45+ metode pembayaran, termasuk Virtual Account, kartu, e-wallet, QRIS, PayLater, Direct Debit, dan berbagai metode pembayaran lainnya.
DOKU juga menyediakan beragam fitur pembayaran, seperti Recurring Payment, Tokenisasi, dan berbagai fitur lainnya. Tersedia pula Power Up, mulai dari Customer Static VA, Visa Network Token, QRIS Cross-Border, hingga MCP Server untuk Agentic Payments.
Untuk pengelolaan transaksi, DOKU Dashboard membantu bisnis memantau transaksi, settlement, refund, dan rekonsiliasi, dilengkapi Payment Analytics serta Multi-Brand & Team Access.
DOKU, Lebih dari Sekadar Payment Gateway
Sebagai pionir payment gateway sejak 2007, DOKU telah berkembang menjadi ayment fintech company yang mendukung lebih dari 300.000 merchant di berbagai industri dan skala bisnis.
Ekosistemnya juga mencakup DOKU Wallet as a Service melalui Embedded Wallet dan Sub Account, serta DOKU Payout melalui Local Payout dan Cross Border Payout.
DOKU menyediakan pendampingan after-sales proaktif dan customer service 24/7, serta beroperasi sebagai PJP Kategori 1 dengan kredensial keamanan PCI DSS dan ISO/IEC 27001.
Jalankan program promo, terima berbagai metode pembayaran, dan kelola transaksi bisnis melalui DOKU Registration atau hubungi tim Sales DOKU untuk menemukan solusi yang sesuai dengan kebutuhan bisnis Anda.
