Winpay Guideline

Panduan produk dan operasional Winpay untuk metode pembayaran, onboarding merchant, settlement, rekonsiliasi, dashboard, dan referensi integrasi API.

Product GuidancePayment OperationsMerchant Back Office

Overview

Winpay Guideline adalah panduan produk dan operasional untuk membantu tim internal, merchant, dan partner memahami layanan Winpay, alur pembayaran, settlement, rekonsiliasi, dashboard, serta proses pendukung lainnya.

Cakupan dokumen: panduan ini mencakup metode pembayaran, onboarding merchant, operasi bisnis, Merchant Back Office, dan referensi menuju dokumentasi API resmi.

Selamat Datang di Winpay

Winpay adalah payment gateway yang memungkinkan bisnis menerima berbagai metode pembayaran online dan offline melalui satu kali integrasi. Dengan satu koneksi API, merchant dapat mengaktifkan VA, QRIS, E-Wallet, Kartu Kredit/Debit, Retail Modern, Payment Link, Checkout Page, callback real-time, dan dashboard monitoring.

Produk Winpay

Payment

Proses transaksi semua metode pembayaran.

Checkout

Hosted payment page Winpay.

Payment Link

Link pembayaran tanpa integrasi teknis kompleks.

Operasi Bisnis

Settlement, reconcile, refund.

API

SNAP API, Checkout API, callback, signature.

Dashboard

Monitoring transaksi dan konfigurasi merchant.

Rekomendasi Produk

Tipe Bisnis	Kebutuhan	Opsi Integrasi	Rekomendasi
Freelancer / Social Media	Terima pembayaran mudah tanpa integrasi teknis	Dashboard / Checkout API	Payment Link untuk no-code; Checkout untuk redirect payment page
E-commerce	Checkout di website sendiri	Integrasi API / Checkout API	Payment API untuk kontrol checkout; Checkout untuk hosted payment page
SaaS	Recurring/langganan	Integrasi API	Payment API + VA/CC/E-Wallet; recurring jika tersedia dan sesuai channel aktif
Corporation	Penerimaan pembayaran skala besar	Integrasi API	Payment API, callback real-time, dashboard monitoring, dan laporan settlement
Business Service	Pembayaran jasa profesional	Dashboard / Integrasi API	Payment Link untuk invoice sederhana; Payment API bila butuh otomasi

Daftar Merchant

Dokumen berbeda sesuai jenis badan usaha. Sales/Commercial dapat meminta dokumen tambahan bila diperlukan untuk verifikasi bisnis, legal, atau compliance.

Dokumen	Individu	PT Perorangan	PT/CV	Yayasan	BUMD	Catatan
PKS	Ya	Ya	Ya	Ya	Ya	Perjanjian Kerja Sama dari Sales/Commercial
Logo/Brand	Ya	Ya	Ya	Ya	Ya	Identitas bisnis yang tampil ke customer
Foto kantor/operasional	Ya	Ya	Ya	Ya	Ya	Bukti aktivitas dan lokasi usaha
KTP pemilik/dirut	Ya	Ya	Ya	Ya	Ya	Sesuai pemilik, direktur, atau pihak berwenang
NPWP	Ya	Ya	Ya	Ya	Ya	NPWP pribadi atau perusahaan sesuai tipe merchant
Akta & SK	Tidak	Ya	Ya	Ya	Tidak	Akta pendirian/perubahan dan SK pengesahan badan hukum
NIB	Tidak	Ya	Ya	Ya	Ya	Nomor Induk Berusaha dari OSS
Rekening settlement	Ya	Ya	Ya	Ya	Ya	Nama rekening harus sesuai hasil verifikasi pemilik/perusahaan
Bukti brand	Ya	Ya	Ya	Ya	Ya	Website, sosial media, katalog, atau kanal penjualan aktif

Kategori Bisnis Terlarang

Daftar ini adalah acuan awal. Keputusan approval merchant mengikuti review Risk/Compliance, regulasi yang berlaku, dan kebijakan internal terbaru.

Perjudian, produk tembakau, alkohol, pornografi, obat terlarang.
Aset kripto/digital gold sebagai alat pembayaran, kecuali aktivitas yang diperbolehkan regulasi dan disetujui compliance.
Senjata api/tajam, cash advance, barang pelanggar HAKI.
Barang/jasa yang melanggar hukum, ketertiban umum, norma sosial, agama, dan moral.
Dompet digital yang dapat diisi melalui kartu kredit.
MLM dengan skema money game, Ponzi, atau sejenis.

Cara Daftar Akun

Pendaftaran akun dilakukan bertahap: registrasi awal, verifikasi email, pengisian data bisnis, lalu review dan aktivasi layanan.

Buka halaman registrasi Dashboard Winpay.
Pilih jenis akun: Perusahaan atau Perorangan.
Isi nama bisnis, email bisnis aktif, nomor kontak, dan password.
Baca dan setujui syarat serta ketentuan yang berlaku.
Kirim registrasi awal.
Cek email konfirmasi untuk melanjutkan verifikasi.
Login kembali lalu lengkapi data bisnis dan dokumen onboarding.

Aktivasi metode pembayaran dilakukan setelah data bisnis, rekening settlement, dan dokumen pendukung selesai direview sesuai ketentuan internal.

Verifikasi Email

Gunakan email bisnis aktif karena alamat ini dipakai untuk akses dashboard, notifikasi, dan komunikasi operasional.

Cari email resmi Winpay pada inbox email yang didaftarkan.
Jika tidak ditemukan, cek folder Spam, Junk, Promosi, atau Updates.
Klik tombol atau tautan verifikasi pada email.
Setelah berhasil, login ulang ke Dashboard Winpay.
Lanjutkan ke form kelengkapan data bisnis.
Jika link kedaluwarsa atau email tidak masuk, gunakan kirim ulang verifikasi atau hubungi support.

Melengkapi Data Bisnis

Tahap	Data Utama	Catatan
Informasi Bisnis	Nama bisnis, kontak WA, kategori, nama perusahaan, alamat, website/sosmed, keperluan bisnis	Website, sosial media, katalog, atau kanal penjualan harus aktif dan relevan dengan aktivitas bisnis.
Informasi Pemilik	Nama, NIK, tanggal lahir, alamat KTP, foto KTP, selfie KTP, NPWP	Data identitas harus jelas, valid, dan sesuai dengan pemilik atau pihak berwenang.
Bank & Metode Pembayaran	Bank settlement, nama pemilik rekening, nomor rekening, cabang, metode aktif	Nama rekening settlement harus sesuai hasil verifikasi. Metode pembayaran aktif mengikuti review Risk/Compliance dan konfigurasi layanan.

Payment Overview

Metode	Keterangan	Cocok Untuk
Kartu Kredit/Debit	Visa, Mastercard, JCB	Checkout online dengan limit kartu dan kebutuhan autentikasi 3DS.
Virtual Account	ATM, mobile banking, internet banking	Invoice, billing, e-commerce, dan rekonsiliasi otomatis.
E-Wallet	OVO, DANA, ShopeePay, SpeedCash	Transaksi mobile dengan otorisasi aplikasi atau redirect.
QRIS	Scan QRIS nasional	Pembayaran cepat melalui aplikasi bank atau e-wallet pendukung QRIS.
Modern Retail	Indomaret, Alfamart, Fastpay	Customer yang membutuhkan pembayaran tunai di gerai retail.
Paylater	Cicilan non-bank	E-commerce atau platform digital dengan opsi bayar nanti/cicilan.

Overview VA

Virtual Account adalah nomor rekening virtual dengan notifikasi real-time. Cocok untuk e-commerce, marketplace, SaaS, billing, dan kebutuhan rekonsiliasi otomatis.

Nomor VA dapat dibuat per transaksi atau menggunakan nomor fixed sesuai kebutuhan merchant.
Merchant dapat menerima callback/notifikasi untuk memperbarui status pembayaran.
Settlement mengikuti model bank/acquirer dan konfigurasi layanan yang aktif.

Bank Acquiring

Catatan model settlement: Aggregator berarti dana diterima Winpay lalu diteruskan ke merchant. Fasilitator berarti settlement dari bank/acquirer dapat langsung ke merchant sesuai konfigurasi.

Bank	Settlement Model
BCA	Aggregator
Mandiri	Aggregator
BRI	Aggregator, Fasilitator
Permata	Aggregator
BNI	Aggregator
Maybank	Aggregator
BNC	Aggregator
CIMB Niaga	Aggregator
BSI	Aggregator

Struktur VA

Nomor VA umumnya terdiri dari prefix bank/Winpay dan deret angka transaksi atau identitas customer sesuai tipe VA yang digunakan.

Bagian	Deskripsi	Contoh
Prefix	Kode khusus Winpay dan ID bank	70070, 88898, 57889
Nomor normal	Deret angka otomatis sistem untuk transaksi tertentu	Nomor unik yang dibuat saat transaksi/registration.
Nomor fixed	Deret statik berdasarkan ID pengguna/kebutuhan merchant	Nomor berbasis customer ID, member ID, atau tagihan berulang.

Prefix VA

Prefix adalah kode awal nomor VA yang menunjukkan konfigurasi Winpay, bank/acquirer, dan produk yang digunakan merchant.

Prefix dan panjang nomor dapat berbeda berdasarkan biller, tipe VA, dan konfigurasi merchant. Gunakan tabel ini sebagai acuan awal sebelum validasi teknis.

Bank	Prefix	Panjang Nomor Tambahan	Catatan
BCA	70070, 70072	7–9 digit	Umumnya digunakan untuk VA BCA sesuai konfigurasi biller.
Mandiri	88898	5–8 digit	Nomor tambahan mengikuti tipe VA dan kebutuhan merchant.
BRI	57808, 57889	5–8 digit	Mendukung model Aggregator dan Fasilitator sesuai konfigurasi.
BNI	98878884	8 digit	Gunakan prefix sesuai produk VA BNI yang aktif.
Permata	8898, 7270	6–9 digit	Nomor tambahan dapat mengikuti nomor transaksi atau customer.
CIMB Niaga	22691, 22695	5–7 digit	Validasi kembali prefix yang digunakan pada konfigurasi merchant.
Maybank	78200, 78298	7–9 digit	Prefix dipilih sesuai biller dan skema integrasi.
BSI	9636, 9042	4–6 digit	Gunakan instruksi pembayaran BSI sesuai prefix aktif.
Muamalat	7873	6–8 digit	Perlu validasi konfigurasi sebelum publish merchant.
Sinarmas	810801, 880801	6–8 digit	Prefix mengikuti channel/biller yang digunakan.
Bank Neo Commerce	90100025	8–10 digit	Dapat menggunakan skema generate dari bank sesuai konfigurasi.

Fitur VA

Fitur VA dibedakan berdasarkan cara nominal dibayar dan apakah nomor VA digunakan sekali, berulang, atau mengikuti data customer.

Tipe VA	Cara Kerja Nominal	Suffix	Cocok Untuk
Open VA	Pembayar memasukkan nominal saat melakukan pembayaran.	Wajib	Donasi, top up, tagihan fleksibel, atau kebutuhan nominal tidak tetap.
Close VA	Nominal ditentukan saat VA dibuat dan pembayaran harus sesuai nominal tersebut.	Tidak wajib	Invoice tunggal, checkout e-commerce, atau tagihan sekali bayar.
Close Recurring VA	Nominal ditentukan dan dapat diperbarui berkala sesuai siklus tagihan.	Wajib	Subscription, iuran, billing bulanan, atau tagihan pelanggan tetap.

Tipe Generate VA

Nomor VA dapat dibuat oleh Winpay, merchant, atau bank. Pilihan generate menentukan siapa yang menyimpan master nomor, melakukan validasi, dan mengelola pola nomor.

Pihak Generate	Kapan Dipakai	Bank Mendukung	Catatan Operasional
Winpay	Merchant ingin nomor VA dibuat otomatis saat transaksi dibuat.	Mandiri, BRI, BCA, Permata, Sinarmas, Muamalat, BJB, BNC, CIMB	Winpay membuat dan menyimpan VA. Cocok untuk integrasi standar dan transaksi berbasis invoice.
Merchant	Merchant sudah memiliki pola nomor customer, member ID, atau tagihan sendiri.	BRI, Permata, Mandiri, BSI, Sinarmas, Muamalat, BCA, CIMB, BNC, Maybank, BJB, Bank Jatim	Merchant membuat VA, lalu Winpay melakukan validasi sesuai aturan bank dan konfigurasi biller.
Bank	Bank/acquirer menjadi pihak yang membuat nomor VA sesuai flow produk tertentu.	BNI, BSI, Bank Jatim, Bank DKI	Bank membuat VA, lalu Winpay melakukan validasi dan meneruskan status transaksi ke merchant.

Limit Transaksi

Limit transaksi dapat berbeda per biller, produk, channel pembayaran, dan limit kartu/rekening pembayar. Gunakan tabel berikut sebagai acuan operasional awal.

Virtual Account

Biller	Produk	Limit per Transaksi	Limit Harian	Keterangan
BCA	VA BCA	Min. Rp15.000 Maks. Rp10.000.000	Tidak ada limit harian	Maksimum sebelumnya Rp3.000.000 per transaksi.
BNI	Virtual Account	Min. Rp10.000 Maks. Rp200.000.000	Perlu konfirmasi	Limit naik berlaku 06/11/2024. Maksimum sebelumnya Rp50.000.000 per transaksi.
BRI	Virtual Account	Tidak ada limit transaksi dari sisi VA	Tidak ada limit harian dari sisi VA	Limit tetap mengikuti channel pembayar BRIVA: ATM/CRM Rp25 juta, BRImo Rp150 juta, IBBIZ Rp1 juta, QCash Rp10 juta, Kliring Rp1 juta, RTGS tidak terbatas.
BSI	Virtual Account	Min. Rp10.000 Maks. mengikuti limit kartu nasabah	Mengikuti limit harian kartu nasabah	Limit efektif ditentukan oleh kartu/channel milik pembayar.
CIMB Niaga	Virtual Account	Min. Rp10.000 Maks. tidak dibatasi dari sisi transaksi VA	Tidak ada limit harian	Tetap mengikuti kebijakan channel Bank Mega Syariah dan bank pengirim.
Mandiri	Virtual Account	Min. Rp10.000 Maks. Rp500.000.000	Perlu konfirmasi	Limit harian perlu dikonfirmasi sesuai konfigurasi/channel.
Muamalat	Virtual Account	Min. Rp10.000 Maks. Rp9.999.999.999 / 10 M	Tidak ada limit harian	Nilai mengikuti informasi pada capture dan perlu validasi saat publish.
Permata	Virtual Account	Min. Rp10.000 Maks. tidak ada batasan transaksi	Tidak ada limit harian	Tetap mengikuti kebijakan channel bank pengirim bila ada.
Sinarmas	Virtual Account	Min. Rp10.000 Maks. mengikuti channel bank pengirim	Mengikuti channel bank pengirim	Limit efektif ditentukan oleh bank/channel yang digunakan pembayar.
Maybank	Virtual Account	Min. tidak ada limit Maks. Rp9,999 M	Tidak ada limit harian	Nilai maksimum mengikuti informasi pada capture dan perlu validasi saat publish.

Alur Pembayaran VA

Virtual Account memiliki tiga alur utama: Payment API (Direct), Checkout API (Redirect), dan Winpay Inquiry VA API.

Alur Pembayaran VA dengan Checkout API (Redirect)

Alur Pembayaran dengan Inquiry Virtual Account API

Integrasi & Testing VA

Testing VA memastikan nomor berhasil dibuat, instruksi pembayaran tampil benar, callback diterima merchant, dan status akhir dapat direkonsiliasi.

Tahap	Yang Diuji	Catatan
Credential & Environment	MID/MID Sandbox, merchantToken, endpoint, IP/firewall	Pastikan credential sesuai environment dan tidak tertukar dengan production.
Registration VA	Pembuatan transaksi, nominal, expired time, nomor VA/TXID	Validasi response sukses, format nomor, dan instruksi pembayaran.
Simulasi Pembayaran	Auto-paid, simulator, atau pembayaran sesuai channel test	Uji nominal sesuai, nominal salah, expired, dan pembayaran setelah expired bila perlu.
Callback & Inquiry	dbProcessUrl/callback, status inquiry, retry, timeout	Merchant harus mengupdate status berdasarkan notifikasi dan/atau inquiry akhir.
Negative Case	Nomor tidak ditemukan, signature salah, timeout, duplicate request	Review log Winpay dan log merchant untuk memastikan handling error jelas.

Penyelesaian VA

Penyelesaian dana VA mengikuti model settlement, bank/acquirer, dan konfigurasi merchant yang aktif.

Aspek	Keterangan	Perhatian Operasional
Aggregator	Dana masuk ke rekening Winpay lalu diteruskan ke merchant.	Merchant mencocokkan laporan transaksi, fee, dan settlement dari Winpay.
Fasilitator	Bank/acquirer dapat settle langsung ke merchant sesuai konfigurasi.	Merchant perlu mencocokkan laporan bank/acquirer dengan data transaksi Winpay.
Expired Terbayar	Pembayaran masuk setelah VA kedaluwarsa.	Perlu review status, flagging manual, atau refund sesuai hasil rekonsiliasi.
Reversal	Koreksi transaksi dari bank/acquirer atas pembayaran tertentu.	Pastikan ada pencatatan adjustment dan komunikasi ke merchant/customer bila berdampak.

Panduan Bayar VA

Panduan bayar VA tersedia per bank. Gunakan prefix, nomor VA, nominal, dan channel pembayaran sesuai instruksi masing-masing bank.

Customer memilih metode pembayaran Virtual Account.
Merchant atau Checkout Page menampilkan bank, nomor VA, nominal, dan batas waktu pembayaran.
Customer membuka ATM, mobile banking, internet banking, atau channel bank lain yang tersedia.
Customer memasukkan nomor VA dan memastikan nama merchant serta nominal sudah sesuai.
Setelah pembayaran sukses, Winpay mengirim callback dan merchant melakukan inquiry bila diperlukan.

BCA

Field	Keterangan
Nomor VA	70070xxxxxxxxxx
Bank	BCA
Nominal	Rp10.000 (contoh)
Channel	ATM, Mobile Banking, Internet Banking

Mandiri

Field	Keterangan
Nomor VA	88898xxxxxxxxxx
Bank	Mandiri
Nominal	Rp10.000 (contoh)
Channel	ATM, Mobile Banking, Internet Banking

BRI

Field	Keterangan
Nomor VA	57889xxxxxxxxxx
Bank	BRI
Nominal	Rp10.000 (contoh)
Channel	ATM, BRImo, Internet Banking, Teller, EDC

BNI

Field	Keterangan
Nomor VA	98878884xxxxxxxxx
Bank	BNI
Nominal	Rp10.000 (contoh)
Channel	ATM, Mobile Banking, iBank Personal

Permata

Field	Keterangan
Nomor VA	8898xxxxxxxxxx
Bank	Permata
Nominal	Rp10.000 (contoh)
Channel	ATM, Mobile Banking

CIMB Niaga

Field	Keterangan
Nomor VA	22691xxxxxxxxxxxx
Bank	CIMB Niaga
Nominal	Rp10.000 (contoh)
Channel	ATM, ATM Bersama, CIMB Clicks, Go Mobile

BSI

Field	Keterangan
Nomor VA	9042xxxxxxxxxxxx
Bank	BSI
Nominal	Rp10.000 (contoh)
Channel	ATM, BSI Mobile/BYOND, transfer online

Maybank

Field	Keterangan
Nomor VA	78298xxxxxxxxxx
Bank	Maybank
Nominal	Rp10.000 (contoh)
Channel	ATM, Internet Banking, Mobile Banking

Muamalat

Field	Keterangan
Nomor VA	7873xxxxxxxxxxx
Bank	Muamalat
Nominal	Rp10.000 (contoh)
Channel	ATM, ATM bank lain, Mobile, Internet Banking

Bank Neo Commerce

Field	Keterangan
Nomor VA	90100025xxxxxxxxxxx
Bank	Bank Neo Commerce
Nominal	Rp10.000 (contoh)
Channel	Mobile Banking

Sinarmas

Field	Keterangan
Nomor VA	810801xxxxxxxxxxx
Bank	Sinarmas
Nominal	Rp10.000 (contoh)
Channel	ATM, Internet Banking, Simobi Plus

Daftar Istilah VA

Istilah	Penjelasan
Prefix	Nomor unik di awal VA yang menunjukkan bank/biller dan konfigurasi produk.
Single Use	VA sekali pakai untuk satu transaksi atau satu invoice.
Multiple Use	VA dapat digunakan berulang selama masih aktif dan sesuai aturan nominal.
Fixed VA	Nomor VA statik yang biasanya dikaitkan dengan customer ID, member ID, atau billing rutin.
Open Amount	Pembayar memasukkan nominal sendiri saat melakukan pembayaran.
Close Amount	Nominal sudah ditentukan saat VA dibuat dan pembayaran harus sesuai nominal tersebut.
trxId	Nomor transaksi merchant.
URL Callback	URL server milik merchant yang menerima status notifikasi pembayaran dari Winpay.
Status Inquiry	Proses pengecekan status transaksi dari merchant ke Winpay untuk memastikan status akhir.
Expired Time	Batas waktu pembayaran VA sebelum nomor tidak dapat dibayar atau perlu dibuat ulang.
Reversal	Koreksi atau pembalikan transaksi dari bank/acquirer atas pembayaran tertentu.

FAQ VA

Pertanyaan	Jawaban
Mengapa transaksi gagal?	Nomor tidak ditemukan, kode perusahaan tidak terdaftar, salah input, expired, timeout, atau channel bank sedang bermasalah.
Apakah VA bisa refund dashboard?	Tidak, refund VA diproses melalui Winpay sesuai hasil pengecekan transaksi dan ketentuan operasional.
Apakah expired date/time bisa diatur?	Bisa sesuai parameter API dan konfigurasi produk/bank yang aktif untuk merchant.
Jika sudah bayar tapi status masih unpaid?	Lakukan status inquiry, cek callback/log merchant, lalu ajukan flagging manual atau refund sesuai hasil rekonsiliasi.
Apa perbedaan Open VA dan Close VA?	Open VA memungkinkan pembayar memasukkan nominal sendiri, sedangkan Close VA mewajibkan pembayaran sesuai nominal yang dibuat.
Apakah satu nomor VA bisa dipakai berulang?	Bisa jika menggunakan Multiple Use atau Fixed VA dan konfigurasi bank/merchant mendukung penggunaan berulang.
Apa yang harus dicek jika callback tidak diterima?	Pastikan URL Callback merchant aktif dan dapat diakses, firewall/IP whitelist sudah sesuai, server merchant memberi response sukses, signature tervalidasi, serta tidak ada timeout. Jika callback tetap tidak diterima, cek log server dan lakukan status inquiry untuk memastikan status transaksi.
Apakah pembayaran setelah expired selalu gagal?	Umumnya ditolak, tetapi kondisi expired terbayar dapat terjadi pada skenario tertentu dan perlu ditangani melalui rekonsiliasi manual.
Kapan merchant perlu melakukan status inquiry?	Saat callback tidak diterima, status di dashboard belum final, customer mengaku sudah bayar, atau proses rekonsiliasi membutuhkan konfirmasi akhir.

Overview Modern Retail

Modern Retail adalah metode pembayaran melalui gerai retail seperti minimarket, loket, atau jaringan partner. Dalam konteks integrasi, metode ini juga dapat disebut CVS atau Convenience Store.

Customer membawa kode pembayaran sekali pakai ke kasir dan membayar sesuai nominal tagihan. Kode pembayaran otomatis tidak aktif setelah satu kali pembayaran sukses dilakukan.

Partner Modern Retail

Partner	Jaringan / Channel
Alfa Group	Alfamart, Alfamidi, DAN+DAN, Lawson
Indomaret	Indomaret, Ceriamart, Mitra Indogrosir, i.Saku
Fastpay Group	Loket Fastpay

Alur Pembayaran Modern Retail

Customer checkout pada merchant.
Merchant mengirim data checkout ke Winpay.
Winpay membuat kode pembayaran sekali pakai.
Merchant menyampaikan kode pembayaran ke customer.
Customer datang ke gerai dan memberikan kode pembayaran ke kasir.
Gerai melakukan inquiry ke Winpay.
Customer membayar sesuai nominal.
Kode pembayaran otomatis tidak aktif setelah pembayaran sukses.
Gerai mengirim bukti pembayaran ke Winpay.
Winpay mengirim callback ke merchant.
Merchant memperbarui status transaksi.

Fitur Modern Retail

Fitur	Deskripsi
Kode Sekali Pakai	Kode pembayaran dibuat otomatis untuk setiap transaksi dan tidak dapat digunakan kembali setelah pembayaran sukses.
Close Amount	Pembayaran hanya berhasil jika nominal sesuai tagihan.
Expired Time	Kode pembayaran memiliki masa berlaku dan tidak dapat dibayar setelah kedaluwarsa.

Integrasi & Testing Modern Retail

Tahap	Yang Diuji	Catatan
Registration / Checkout	Integrasi Registration API Modern Retail atau Checkout API.	Pastikan response berisi kode pembayaran sekali pakai, nominal, dan masa berlaku.
Generate Kode Pembayaran	Pembuatan kode pembayaran dan instruksi bayar.	Validasi kode pembayaran tampil jelas untuk customer dan kasir.
Simulasi Pembayaran	Pembayaran di gerai Indomaret, Alfa Group, atau Fastpay sesuai skenario.	Uji pembayaran sukses, kode tidak dapat digunakan ulang setelah sukses, expired, nominal tidak sesuai, dan jaringan offline bila tersedia.
Callback & Inquiry	Callback, push notification, dan status inquiry.	Merchant harus memperbarui status transaksi berdasarkan notifikasi atau inquiry akhir.
Cancel / Negative Case	Cancel opsional, transaksi expired, kode salah, kode sudah terbayar, atau ditolak gerai.	Review log dan eskalasi ke Winpay bila status tidak sinkron.

Penyelesaian Modern Retail

Aspek	Keterangan	Perhatian Operasional
Settlement	Penyelesaian dana mengikuti jadwal partner retail.	Cocokkan laporan transaksi, biaya, dan settlement sebelum closing.
Pembatalan	Pembatalan dapat dilakukan sebelum kode pembayaran kedaluwarsa atau sebelum transaksi terbayar.	Pastikan status akhir belum sukses sebelum melakukan pembatalan.
Kode Terbayar	Kode pembayaran otomatis tidak aktif setelah satu kali pembayaran sukses.	Jika customer mencoba membayar ulang, transaksi harus ditolak atau diarahkan membuat transaksi baru.
Issue Handling	Jika terjadi isu, transaksi dapat diproses dengan skema flagging/manual handling.	Gunakan bukti pembayaran, log, dan status inquiry sebagai dasar pengecekan.
Refund	Refund mengikuti aturan partner dan proses operasional Winpay.	Validasi status pembayaran dan settlement sebelum refund diproses.

Aturan & Limitasi Modern Retail

Partner	Minimum	Maksimum	Batas
Alfa Group	Rp10.000	Rp2.500.000 cash; Rp5.000.000 debit/credit	5 kali/toko/hari
Indomaret	Rp10.000	Rp1.000.000	Tidak ada batas
Fastpay Group	Perlu konfirmasi	Perlu konfirmasi	Perlu konfirmasi

Panduan Bayar Modern Retail

Panduan pembayaran Modern Retail dibedakan untuk Alfa Group, Indomaret, dan Fastpay Group.

Alfamart

Catat/cetak kode pembayaran.
Datang ke Alfamart/Alfamidi/DAN+DAN/Lawson.
Tunjukkan dan informasikan kode pembayaran dengan menyebutkan merchant ID PLASAMALL kepada kasir gerai minimarket.
Bayar sesuai nominal.
Ambil tanda terima pembayaran.

Indomaret

Catat/cetak kode pembayaran.
Datang ke Indomaret.
Tunjukkan kode pembayaran dengan menyebutkan merchant ID WIN SOLUTION kepada kasir gerai minimarket.
Bayar sesuai nominal.
Ambil receipt.

Fastpay Group

Datang ke loket Fastpay terdekat.
Sebutkan pembayaran Winpay.
Berikan kode pembayaran.
Bayar sesuai nominal.
Ambil bukti pembayaran.

FAQ Modern Retail

Pertanyaan	Jawaban
Mengapa pembayaran Modern Retail gagal?	Kode pembayaran salah, expired, sudah pernah dibayar, jaringan offline, atau transaksi ditolak gerai.
Apakah kode pembayaran bisa dipakai ulang?	Tidak. Kode pembayaran Modern Retail bersifat sekali pakai dan otomatis tidak aktif setelah satu kali pembayaran sukses.
Apakah refund tersedia dashboard?	Tidak, refund dilakukan manual melalui pihak terkait.
Masa berlaku bisa diatur?	Bisa menggunakan parameter valid date/time.
Tidak menerima notifikasi?	Cek URL, firewall, lalu resend/eskalasi ke Winpay.

Overview E-Wallet

E-Wallet memungkinkan customer membayar melalui aplikasi dompet digital tanpa kartu fisik atau uang tunai.

Daftar E-Wallet

E-Wallet	Catatan
OVO	Push notification
DANA	Redirect / OTP sesuai flow
ShopeePay	Redirect / PIN ShopeePay
SpeedCash	Checkout aplikasi SpeedCash

Alur Pembayaran E-Wallet

Customer checkout.
Merchant request registration/payment ke Winpay.
Winpay generate pembayaran ke issuer e-wallet.
OVO menggunakan push notification; e-wallet lain umumnya redirect/jump app.
Issuer mengirim callback ke Winpay.
Winpay meneruskan callback ke merchant.
Merchant melakukan status inquiry dan update status.

Model Bisnis & Biaya

E-Wallet membantu merchant menerima berbagai penyelenggara dompet digital melalui satu integrasi. Customer dapat dikenakan biaya top up atau layanan tertentu tergantung aplikasi.

Fitur Subscription

DANA Subscription mendukung pembayaran berkala otomatis, dengan notifikasi bila saldo tidak mencukupi.

Integrasi & Testing E-Wallet

E-Wallet	Cara Uji	Expired Default
OVO	Gunakan akun/nomor asli dan konfirmasi di aplikasi	55–60 detik
DANA	Login OTP dan konfirmasi transaksi	24 jam
ShopeePay	Konfirmasi di Shopee dan input PIN	5 menit
SpeedCash	Login aplikasi SpeedCash dan bayar	5 menit

Penyelesaian E-Wallet

Layanan	Void	Refund
OVO	Hari yang sama	Different day block
DANA	Sebelum 24 jam	Manual/online sesuai kondisi
ShopeePay	Hari yang sama	<365 hari refund; >365 manual
SpeedCash	Sebelum 30 hari	Perlu konfirmasi

Aturan & Limitasi E-Wallet

Aspek	ShopeePay	OVO	DANA	SpeedCash
Tampilan	Redirect URL	Push notification	Redirect URL	Redirect URL
Expired	5 menit	60 detik	24 jam	5 menit
Minimum	Rp1	Rp1	Rp100	Rp100
Maksimum	Berdasarkan status akun	Rp20 juta / limit bulanan Rp40 juta	Non-KYC Rp2 juta; KYC Rp20 juta	Non-KYC Rp2 juta; KYC Rp20 juta

Panduan Bayar E-Wallet

Panduan bayar e-wallet dibedakan berdasarkan issuer/aplikasi.

DANA

Klik link pembayaran.
Masukkan nomor telepon/akun DANA jika diminta.
Masukkan PIN DANA.
Masukkan kode verifikasi SMS.
Pilih metode pembayaran dan konfirmasi.

OVO

Klik bayar.
Buka push notification OVO.
Pastikan nominal sesuai.
Klik Bayar dan konfirmasi.

ShopeePay

Klik link pembayaran.
Dialihkan ke halaman ShopeePay.
Pastikan nominal sesuai.
Pilih metode pembayaran bila tersedia.
Klik Bayar Sekarang dan input PIN.

SpeedCash

Pastikan login aplikasi SpeedCash.
Klik tombol bayar.
Lanjutkan di halaman checkout SpeedCash.
Masukkan PIN SpeedCash.
Kembali ke merchant setelah pembayaran.

Daftar Istilah E-Wallet

Istilah	Penjelasan
Jump app	Perpindahan ke aplikasi e-wallet
Linkage	Penautan akun e-wallet
Premium/KYC	Akun terverifikasi
Non premium	Akun belum KYC
Timeout	Transaksi gagal karena waktu/teknis

FAQ E-Wallet

Pertanyaan	Jawaban
E-wallet vs QRIS?	E-wallet perlu otorisasi aplikasi; QRIS perlu scan QR.
Mengapa gagal?	Expired, issuer bermasalah, ditolak issuer, atau sinyal terputus.
Settlement berapa lama?	Umumnya H+3 hari kerja.

Overview Kartu Kredit

Kartu kredit mendukung transaksi domestik/internasional via Visa, Mastercard, dan JCB. Winpay melengkapi layanan dengan PCI DSS, 3DS 2.0, dan FDS.

Keunggulan Kartu Kredit

Dukungan jaringan Visa, Mastercard, JCB.
PCI DSS sehingga merchant tidak perlu sertifikasi sendiri untuk flow tertentu.
FDS untuk deteksi fraud.
3DS 2.0 dengan OTP/autentikasi issuer.
Monitoring melalui Dashboard Winpay.

Alur Pembayaran Kartu Kredit

Alur umum: checkout → input kartu → autentikasi 3DS/OTP → kalkulasi FDS → charge → callback → status inquiry → result page.

Direct 3DS

Customer memasukkan kartu pada tampilan merchant. Merchant mengirim registration/payment API, Winpay memproses 3DS dan FDS, lalu callback dikirim ke merchant.

Redirect 3DS

Customer diarahkan ke halaman Winpay. Winpay mengelola halaman pembayaran, 3DS, FDS, dan redirect result.

Fitur Kartu Kredit

Full Payment.
3D Secure 2.0.
FDS.
Void dan refund sesuai ketentuan acquirer.

Integrasi & Testing Kartu Kredit

Integrasi transaction registration.
Integrasi payment charge.
Terima callback dan push notification.
Lakukan status inquiry.
Uji failed, timeout, dan negative case.

Settlement & Refund Kartu Kredit

Settlement kartu kredit umumnya H+3 hari kerja. Void dilakukan sebelum settlement/cut-off. Refund diproses melalui Winpay/acquirer, bukan transfer langsung merchant ke pelanggan.

Dispute & Chargeback

Dispute adalah sanggahan pemegang kartu. Merchant harus menyiapkan bukti transaksi, data pengiriman, billing, invoice, T&C, dan bukti autentikasi. Jika chargeback valid, dana dikembalikan sesuai aturan principal/acquirer.

Aturan & Limitasi Kartu Kredit

Aturan	Keterangan
Kartu	Visa, Mastercard, JCB
Mata uang	IDR
Nominal	Rp5.000 sampai Rp999.999.999
Refund	Maksimal 90 hari / 3 bulan
CVV	Tidak boleh disimpan merchant

FDS

Fraud Detection System memberikan risk score untuk membantu merchant menerima/menolak transaksi berdasarkan risiko.

Panduan Bayar Kartu Kredit

Pilih metode Kartu Kredit.
Masukkan nomor kartu, expiry date, dan CVV.
Konfirmasi transaksi.
Masukkan OTP/3DS jika diminta issuer.
Merchant memberikan bukti pembayaran.

Daftar Istilah Kartu Kredit

Istilah	Penjelasan
PAN	Nomor kartu
CVV	Kode keamanan kartu; tidak boleh disimpan
Issuer	Penerbit kartu
Acquirer	Pemroses penerimaan dana
OTP	One-time password
Chargeback	Pengembalian dana akibat sanggahan

FAQ Kartu Kredit

Pertanyaan	Jawaban
Jenis kartu yang didukung?	Visa, Mastercard, JCB.
Apakah ada OTP?	Ada sesuai konfigurasi MID dan issuer.
Berapa lama settlement?	H+3 hari kerja.
Bisa refund dashboard?	Ya sesuai fitur dan ketentuan.

Kode ECI

VISA/Principal	Mastercard	Deskripsi
05	02	Autentikasi berhasil dan transaksi dijamin 3DS
06	01	Autentikasi dicoba namun issuer/kartu tidak mendukung 3DS
07	00	Autentikasi gagal/tidak aman

Overview Paylater

Paylater adalah BNPL/pinjaman digital dengan tenor tertentu. Customer membayar belanja sekarang dan melunasi kemudian sesuai aturan lender.

Partner Paylater

Partner	Catatan
SPayLater	Aktif setelah integrasi ShopeePay dan mengikuti konfigurasi layanan yang disetujui.

Alur Pembayaran Paylater

Customer checkout.
Merchant mengirim registration ke Winpay.
Winpay menyimpan order dan mengirim response.
Partner menampilkan halaman checkout.
Customer login/OTP/PIN dan konfirmasi.
Partner mengirim notifikasi ke Winpay.
Winpay meneruskan konfirmasi ke merchant.
Merchant melakukan check status akhir.

Model Bisnis & Biaya

Customer tidak dikenakan biaya saat daftar, tetapi dikenakan bunga/denda sesuai penggunaan. Merchant dikenakan MDR Paylater + fixed rate sesuai publish rate.

Fitur Paylater

Paylater hanya mendukung transaksi online dan cocok untuk e-commerce/platform digital.

Integrasi & Testing Paylater

Order registration.
Payment/charge.
Terima callback dan push notification.
Status inquiry.
Opsional cancel.
Credential testing tidak ditampilkan di HTML publik.

Penyelesaian Paylater

Partner	Settlement
SPayLater	Mengikuti jadwal settlement partner dan konfigurasi layanan yang aktif.

Aturan & Limitasi Paylater

Partner	Nominal / Tenor
SPayLater	30 hari/1 bulan dan cicilan sesuai opsi aplikasi.

Panduan Bayar Paylater

Panduan bayar Paylater saat ini hanya tersedia untuk SPayLater.

SPayLater

Pilih pembayaran melalui SPayLater.
Dialihkan ke halaman/aplikasi partner.
Login dan lakukan OTP/PIN bila diminta.
Pastikan limit mencukupi dan nominal sesuai.
Konfirmasi pembayaran.
Customer kembali ke result page merchant.

Daftar Istilah Paylater

Istilah	Penjelasan
RTO	Request Time Out akibat gangguan koneksi
MDR	Merchant Discount Rate
BNPL	Buy Now Pay Later
Lender	Pemberi pinjaman
Borrower	Peminjam/customer

FAQ Paylater

Pertanyaan	Jawaban
Tidak punya akun partner?	Customer harus membuat akun di aplikasi partner.
Limit tidak cukup?	Lunasi tagihan atau ajukan limit tambahan.
Mengapa gagal?	Limit tidak cukup, sinyal terputus, issuer tidak mendukung, atau transaksi ditolak.
Refund tersedia MBO?	Umumnya hubungi Winpay/partner sesuai metode.

Overview QRIS

QRIS adalah standar kode QR nasional untuk transaksi cashless. Winpay mendukung QRIS MPM dinamis.

Alur Pembayaran QRIS

Customer checkout.
Merchant request registration ke Winpay.
Winpay request ke Mitra QRIS.
Mitra generate QR.
Merchant menampilkan QR ke customer.
Customer scan dan bayar via aplikasi bank/e-wallet.
Mitra mengirim push notification ke Winpay.
Winpay update status dan callback ke merchant.
Merchant inquiry status dan konfirmasi ke customer.

Model Bisnis & Biaya

QRIS membantu merchant menerima pembayaran dari bank/e-wallet dalam satu QR. Customer umumnya tidak dikenakan biaya tambahan. Detail biaya merchant dirujuk ke Produk & Biaya.

Tipe QRIS MPM

Aspek	Dinamis	Statis
Jumlah QR	Banyak; generate per transaksi	Satu QR
Nominal	Dapat langsung terisi	Umumnya diinput customer
Cocok	Online checkout dan invoice	Outlet/kasir/manual

Integrasi & Testing QRIS

Order registration via SNAP/Checkout/Direct.
Terima callback dan push notification.
Status inquiry.
Opsional cancel.
Credential testing disanitasi dari HTML publik.

Penyelesaian QRIS

Settlement QRIS menyelesaikan dana antara merchant dan bank/acquirer. Refund QRIS dilakukan full refund sesuai ketentuan.

Aturan & Limitasi QRIS

Aturan	Nominal
Minimum	Rp1
Maksimum	Rp10.000.000
Refund	Full refund

Panduan Bayar QRIS

Buka aplikasi penyedia pembayaran QR.
Simpan/capture QR jika diperlukan.
Scan QR dari aplikasi.
Periksa nominal dan merchant.
Konfirmasi pembayaran.

Daftar Istilah QRIS

Istilah	Penjelasan
QRIS	Quick Response Code Indonesian Standard
MPM	Merchant Presented Mode
NMID	Nomor ID merchant QRIS
PJSP	Penyelenggara Jasa Sistem Pembayaran
CPAN	Consumer Primary Account Number

Checkout Page

Checkout Page adalah hosted payment page Winpay. Merchant tidak perlu membangun halaman pembayaran sendiri.

Winpay Payment Page

Payment page Winpay tersedia untuk desktop dan mobile, menampilkan pilihan metode pembayaran sesuai channel aktif merchant.

Metode Pembayaran Checkout

Metode	Referensi
Kartu Kredit	Panduan Kartu Kredit
Virtual Account	Panduan VA
Modern Retail	Panduan Modern Retail
E-Wallet	Panduan E-Wallet
Paylater	Panduan Paylater
QRIS	Panduan QRIS

Payment Link

Payment Link memudahkan merchant membuat tautan pembayaran dan membagikannya melalui e-mail, chat, atau media lain.

Tipe Payment Link

Tipe	Deskripsi
Single Payment Link	Satu tautan untuk satu transaksi
Bulk Payment Link	Banyak tautan melalui upload CSV/TXT

Kelebihan Payment Link

Kelebihan	Penjelasan
No code required	Tidak perlu integrasi teknis
Mudah diakses	Cukup melalui dashboard
Cepat dibuat	Proses kurang dari satu menit
Fleksibel dibagikan	Bisa via e-mail/chat/media lain

Metode Pembayaran Payment Link

Metode	Referensi
Kartu Kredit	Panduan Kartu Kredit
Virtual Account	Panduan VA
Modern Retail	Panduan Modern Retail
E-Wallet	Panduan E-Wallet
QRIS	Panduan QRIS

Overview Operasi Bisnis

Panduan	Deskripsi
Back Office	Manajemen merchant
Produk & Biaya	Rincian biaya layanan
Deposit Saldo	Deposit saldo
Reconcile	Pencocokan transaksi
Settlement	Penyelesaian dana
Cancel Payment	Void/refund
Invoice & Receipt	Bukti tagihan
Pajak	PPN/PPh 23
FAQ	Pertanyaan umum

Produk & Biaya

Tarif wajib divalidasi Finance/Commercial sebelum publish production.

Produk	Biaya Standar	Catatan
Kartu Kredit MDR	2,9%	Belum termasuk PPN
FDS	Rp1.500	Fraud Detection System
Virtual Account	Rp4.000	Belum termasuk PPN
Indomaret	Indomaret fee + Rp2.000	Sudah termasuk PPN
Alfa Group	Rp5.000	Sudah termasuk PPN
Fastpay	Rp2.500	Sudah termasuk PPN
OVO	1,5% / 2,73% digital content	Belum termasuk PPN
DANA	1,5%	Belum termasuk PPN
ShopeePay	2% / 4% digital content	Belum termasuk PPN
QRIS	0,7%	Sudah termasuk PPN

Dashboard

Dashboard Merchant digunakan untuk memantau transaksi, laporan, settlement, saldo, payment link, e-invoice, dan konfigurasi integrasi.

Reconcile

Reconcile adalah proses pencocokan data transaksi merchant dengan laporan Winpay, mutasi dana, dan laporan settlement untuk memastikan status transaksi, nominal, biaya, dan dana yang disettle sudah sesuai. Winpay mengirimkan laporan settlement kepada Merchant.

Proses Settlement

Metode	Durasi
Kartu Kredit	H+3 hari kerja
Virtual Account	H+1 hari kerja
Modern Retail	H+3 hari kerja
QRIS	H+1 hari kerja

Same Day Settlement

SDS/H+0 adalah fitur percepatan settlement untuk merchant tertentu sesuai ketentuan internal dan konfigurasi layanan.

Cut Off

Untuk transaksi Virtual Account, E-Wallet, dan channel pembayaran lainnya, tidak ada cut off transaksi dari sisi penerimaan pembayaran Winpay. Transaksi tetap dapat dibuat dan dibayar selama channel bank/issuer/partner tersedia dan tidak sedang mengalami maintenance. Waktu di bawah digunakan sebagai acuan operasional untuk proses batch, settlement, atau maintenance channel tertentu, bukan sebagai batas transaksi merchant.

Bank/Mitra	Waktu Operasional
Umum batch	22:00–24:00
OVO	23:59
BCA	20:50–02:00; Minggu hingga 04:00 WIB
BRI	22:00–23:20 WIB

Cancel Payment

Jenis pembatalan: Void dan Refund. Void untuk pembatalan transaksi tertentu sebelum settlement/cut-off. Refund adalah pengembalian dana setelah transaksi berhasil sesuai aturan metode pembayaran. Pengajuan cancel payment dilakukan merchant dengan menghubungi team operation

FAQ Operasi Bisnis

Pertanyaan	Jawaban
Bagaimana bekerja sama?	Daftar sebagai merchant dan hubungi sales/marketing Winpay.
Bisnis kecil tanpa PT bisa?	Bisa melalui skema aggregator setelah verifikasi.
Berapa lama onboarding?	Umumnya 3–14 hari kerja.
Siapa mengirim settlement?	Fasilitator: acquirer; Aggregator: Winpay.

Syarat & Ketentuan

Konten Winpay Docs diberikan sebagai panduan umum. Pengguna wajib menghormati HAKI dan menggunakan konten sesuai hukum. Winpay berhak memperbarui konten tanpa pemberitahuan sebelumnya.

Review Legal wajib sebelum publish publik.

Dashboard Merchant IT

Dashboard Merchant adalah panel kendali utama untuk transaksi, saldo, payment link, e-invoice, setting, integrasi, dan akun.

Fitur	Fungsi
Dashboard	Statistik transaksi
Transaksi	Riwayat transaksi
Saldo	Saldo dan penarikan
Payment Link	Link pembayaran
Setting	Konfigurasi API
Integrasi	Log callback/API
Akun	Profil dan keamanan

Halaman Utama Dashboard

Total nominal siap ditarik.
Total transaksi berlangsung.
Volume transaksi sukses.
Jumlah transaksi sukses.
Grafik volume dan breakdown produk.
Dropdown Production/Sandbox.

Transaksi

Menu transaksi untuk melihat, mencari, memfilter, dan mengunduh data transaksi.

Kolom	Keterangan
Waktu	Jam transaksi
ID Ref	Referensi unik
Produk/No VA	Metode/no pembayaran
Nominal & Biaya	Gross dan fee
Nominal Tersettled	Net settlement
Status	Pending, Sukses, Gagal, Expired

Transaksi Gagal

Menu transaksi gagal membantu merchant memeriksa transaksi yang tidak berhasil, termasuk kartu kredit, VA, e-wallet, dan QRIS.

Membatalkan Transaksi

Cari transaksi.
Klik hyperlink TXID.
Isi Cancelled Amount.
Isi Cancelled Reason.
Klik Cancel dan konfirmasi.

Saldo

Menu saldo membantu merchant memeriksa saldo siap ditarik, mutasi dana, dan list penarikan.

Tarik Dana

Minimal penarikan Rp15.000.
Biaya admin per penarikan Rp2.000.
Pelimpahan dana 1 hari kerja.

Mutasi Dana

Mutasi dana menampilkan saldo awal, pembayaran masuk, charge, settled amount, dan saldo akhir.

Payment Link & Invoice

Menu ini digunakan membuat Payment Link dan E-Invoice.

Single Payment Link

Masuk tab Buat Single Payment Link.
Isi item, qty, harga, judul transaksi, expiry.
Pilih metode pembayaran.
Klik Create Payment Link.
Salin link untuk customer.

Bulk Payment Link

Masuk tab Bulk Payment Link.
Download template CSV/TXT.
Isi item_id, item_name, qty, item_price, validity.
Upload file.
Link akan muncul di daftar Payment Link.

E-Invoice

Isi Customer Details.
Isi Invoice Details.
Pilih metode pembayaran.
Preview tampilan invoice.
Publish dan kirim invoice.

Setting & Integrasi

Mengatur koneksi teknis: API SNAP, URL callback, IP whitelist, public key, Checkout Page, dan credential.

Jangan membagikan Client ID, private/public key, atau secret ke pihak luar.

Integrasi & Log

Developer dapat memantau callback dan status API secara real-time, termasuk waktu, ID transaksi, merchant ref, produk, status, URL callback, dan response code.

Keamanan & Status

Aktifkan 2FA menggunakan authenticator.
Pantau log aktivitas.
Kelola notifikasi e-mail untuk settlement submerchant.
Kelola akun, toko, user, dan merchant ID.

API Integration

Detail teknis API dikelola oleh tim IT dan tidak ditampilkan sebagai sidebar panjang di guideline ini. Untuk endpoint, payload, signature, callback, testing, dan referensi teknis terbaru, gunakan dokumentasi resmi Winpay API.

Referensi resmi: halaman ini hanya menjadi pintu masuk menuju portal API Integration yang dikelola IT.

Buka API Integration Docs https://docs.winpay.id/