Winpay Guideline

Overview

Winpay Docs V2 disusun sebagai dokumentasi HTML dengan sidebar kiri lengkap, bertingkat, dan siap diunggah sebagai website/static documentation. Semua modul utama memiliki sub-menu agar user dapat masuk langsung ke fitur, flow, integrasi, settlement, panduan bayar, FAQ, dan operasi bisnis.

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

Rekomendasi Produk

Daftar Merchant

Kategori Bisnis Terlarang

• Perjudian, produk tembakau, alkohol, pornografi, obat terlarang.
• Bitcoin/digital gold sebagai alat pembayaran, kecuali aktivitas aset kripto yang diperbolehkan regulasi.
• 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

1. Buka halaman registrasi Dashboard Winpay.
2. Pilih jenis akun: Perusahaan atau Perorangan.
3. Isi nama bisnis, email bisnis aktif, dan password.
4. Setujui syarat dan ketentuan.
5. Cek email konfirmasi.
6. Lanjutkan registrasi lengkap.

Verifikasi Email

1. Cari email resmi Winpay.
2. Klik tombol verifikasi.
3. Setelah berhasil, sistem mengarahkan ke form lengkap.
4. Jika email tidak masuk, cek spam/junk, kirim ulang, atau hubungi support.

Melengkapi Data Bisnis

Payment Overview

Overview VA

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

Bank Acquiring

Struktur VA

Prefix VA

Fitur VA

Tipe Generate VA

Variable VA vs Installment

Limit Transaksi

• Minimum Rp7.000 untuk sebagian besar VA.
• Minimum Rp10.000 untuk beberapa direct/fasilitator tertentu.
• Maksimum Rp50 juta untuk beberapa layanan spesifik.
• Maksimum Rp5 miliar untuk layanan VA tertentu sesuai bank/channel.

Alur Pembayaran VA

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

Payment API / Direct

Merchant mengelola flow checkout sendiri. Merchant request VA ke Winpay, menerima VA/TXID, menampilkan ke customer, menerima callback, lalu melakukan inquiry status.

Checkout API / Redirect

Winpay menyediakan halaman pembayaran. Merchant mengarahkan customer ke Checkout Page, customer memilih VA dan membayar melalui bank.

Winpay Inquiry VA API

Merchant menyimpan master data VA. Saat pembayaran, Winpay melakukan inquiry ke merchant untuk validasi sebelum pembayaran diproses.

Integrasi & Testing VA

• Gunakan MID/MID Sandbox.
• Buat registration transaksi.
• Simulasikan pembayaran atau auto-paid.
• Periksa dbProcessUrl dan status inquiry.
• Review log, firewall, merchantToken, timeout, failed, negative case.

Penyelesaian VA

Model Facilitator: bank settle langsung ke merchant. Model Aggregator: dana masuk ke rekening Winpay lalu diteruskan ke merchant. Kegagalan yang perlu diperhatikan: VA expired tetapi terbayar dan reversal VA.

Panduan Bayar VA

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

BCA

Mandiri

BRI

BNI

Permata

CIMB Niaga

BSI

Maybank

Muamalat

Bank Neo Commerce

Sinarmas

Daftar Istilah VA

FAQ VA

Overview CVS

Convenience Store adalah metode pembayaran tunai melalui gerai minimarket/retail. Customer membawa payment code ke kasir dan membayar sesuai nominal.

Partner CVS

Alur Pembayaran CVS

1. Customer checkout pada merchant.
2. Merchant mengirim data checkout ke Winpay.
3. Winpay generate nomor pembayaran CVS/PayNo.
4. Merchant menyampaikan PayNo ke customer.
5. Customer datang ke gerai dan memberikan PayNo ke kasir.
6. Gerai melakukan inquiry ke Winpay.
7. Customer membayar sesuai nominal.
8. Gerai mengirim bukti pembayaran ke Winpay.
9. Winpay mengirim callback ke merchant.
10. Merchant memperbarui status transaksi.

Fitur CVS

Integrasi & Testing CVS

• Integrasi Registration API Convenience Store atau Checkout API.
• Terima callback dan push notification.
• Lakukan status inquiry.
• Opsional: cancel untuk transaksi tertentu.
• Uji pembayaran di gerai Indomaret/Alfa/Fastpay sesuai skenario.

Penyelesaian CVS

Penyelesaian CVS mengikuti jadwal partner. Pembatalan dapat terjadi sebelum PayNo kedaluwarsa atau sebelum transaksi terbayar. Jika terjadi isu, transaksi dapat diproses dengan skema flagging/manual handling.

Aturan & Limitasi CVS

Panduan Bayar CVS

Panduan pembayaran CVS dibedakan untuk Alfa Group, Indomaret, dan Fastpay Group.

Alfamart

1. Catat/cetak kode pembayaran.
2. Datang ke Alfamart/Alfamidi/DAN+DAN/Lawson.
3. Informasikan pembayaran Winpay dan nama merchant.
4. Berikan kode pembayaran ke kasir.
5. Bayar sesuai nominal.
6. Ambil tanda terima pembayaran.

Indomaret

1. Catat/cetak kode pembayaran.
2. Datang ke Indomaret.
3. Informasikan nama merchant.
4. Berikan kode pembayaran ke kasir.
5. Bayar sesuai nominal.
6. Ambil receipt.

Fastpay Group

1. Datang ke loket Fastpay terdekat.
2. Sebutkan pembayaran Winpay.
3. Berikan nomor pembayaran.
4. Bayar sesuai nominal.
5. Ambil bukti pembayaran.

FAQ CVS

Overview E-Wallet

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

Daftar E-Wallet

Alur Pembayaran E-Wallet

1. Customer checkout.
2. Merchant request registration/payment ke Winpay.
3. Winpay generate pembayaran ke issuer e-wallet.
4. OVO menggunakan push notification; e-wallet lain umumnya redirect/jump app.
5. Issuer mengirim callback ke Winpay.
6. Winpay meneruskan callback ke merchant.
7. 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

Penyelesaian E-Wallet

Aturan & Limitasi E-Wallet

Panduan Bayar E-Wallet

Panduan bayar e-wallet dibedakan berdasarkan issuer/aplikasi.

DANA

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

OVO

1. Klik bayar.
2. Buka push notification OVO.
3. Pastikan nominal sesuai.
4. Klik Bayar dan konfirmasi.

ShopeePay

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

SpeedCash

1. Pastikan login aplikasi SpeedCash.
2. Klik tombol bayar.
3. Lanjutkan di halaman checkout SpeedCash.
4. Masukkan PIN SpeedCash.
5. Kembali ke merchant setelah pembayaran.

Daftar Istilah E-Wallet

FAQ E-Wallet

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

FDS

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

Panduan Bayar Kartu Kredit

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

Daftar Istilah Kartu Kredit

FAQ Kartu Kredit

Kode ECI

Overview Paylater

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

Partner Paylater

Alur Pembayaran Paylater

1. Customer checkout.
2. Merchant mengirim registration ke Winpay.
3. Winpay menyimpan order dan mengirim response.
4. Partner menampilkan halaman checkout.
5. Customer login/OTP/PIN dan konfirmasi.
6. Partner mengirim notifikasi ke Winpay.
7. Winpay meneruskan konfirmasi ke merchant.
8. 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

Aturan & Limitasi Paylater

Panduan Bayar Paylater

Panduan bayar mengikuti aplikasi partner: Akulaku, Kredivo, Indodana, dan SPayLater.

Akulaku

1. Pilih pembayaran melalui Akulaku.
2. Dialihkan ke halaman/aplikasi partner.
3. Login dan lakukan OTP/PIN bila diminta.
4. Pastikan limit mencukupi dan nominal sesuai.
5. Konfirmasi pembayaran.
6. Customer kembali ke result page merchant.

Kredivo

1. Pilih pembayaran melalui Kredivo.
2. Dialihkan ke halaman/aplikasi partner.
3. Login dan lakukan OTP/PIN bila diminta.
4. Pastikan limit mencukupi dan nominal sesuai.
5. Konfirmasi pembayaran.
6. Customer kembali ke result page merchant.

Indodana

1. Pilih pembayaran melalui Indodana.
2. Dialihkan ke halaman/aplikasi partner.
3. Login dan lakukan OTP/PIN bila diminta.
4. Pastikan limit mencukupi dan nominal sesuai.
5. Konfirmasi pembayaran.
6. Customer kembali ke result page merchant.

SPayLater

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

Daftar Istilah Paylater

FAQ Paylater

Overview QRIS

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

Alur Pembayaran QRIS

1. Customer checkout.
2. Merchant request registration ke Winpay.
3. Winpay request ke Mitra QRIS.
4. Mitra generate QR.
5. Merchant menampilkan QR ke customer.
6. Customer scan dan bayar via aplikasi bank/e-wallet.
7. Mitra mengirim push notification ke Winpay.
8. Winpay update status dan callback ke merchant.
9. 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

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

Panduan Bayar QRIS

1. Buka aplikasi penyedia pembayaran QR.
2. Simpan/capture QR jika diperlukan.
3. Scan QR dari aplikasi.
4. Periksa nominal dan merchant.
5. Konfirmasi pembayaran.

Daftar Istilah QRIS

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

Payment Link

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

Tipe Payment Link

Kelebihan Payment Link

Metode Pembayaran Payment Link

Overview Operasi Bisnis

Produk & Biaya

Dashboard

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

Reconcile

Reconcile adalah pencocokan data transaksi antara merchant, Winpay, bank/acquirer, dan laporan settlement. Merchant wajib melakukan status inquiry dan mengunduh laporan sesuai kebutuhan.

Proses Settlement

Same Day Settlement

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

Cut Off

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.

Pajak

• PPN efektif 11% untuk jasa selain barang/jasa mewah.
• PPh 23 tarif 2%.
• Merchant dapat menerbitkan e-Bupot Unifikasi dan mengajukan reimbursement sesuai dokumen pendukung.

FAQ Operasi Bisnis

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.

Dashboard Merchant IT

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

Login

1. Akses halaman login Dashboard Merchant.
2. Masukkan email dan password.
3. Centang Remember Me bila perlu.
4. Klik Sign In.
5. Gunakan Forgot Password bila lupa password.

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.

Transaksi Gagal

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

Membatalkan Transaksi

1. Cari transaksi.
2. Klik hyperlink TXID.
3. Isi Cancelled Amount.
4. Isi Cancelled Reason.
5. 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

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

Bulk Payment Link

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

E-Invoice

1. Isi Customer Details.
2. Isi Invoice Details.
3. Pilih metode pembayaran.
4. Preview tampilan invoice.
5. Publish dan kirim invoice.

Setting & Integrasi

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

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.

Data Merchant

Section ini disiapkan sebagai anchor sidebar untuk halaman/fitur Data Merchant. Isi final dapat ditarik dari modul MMS atau dokumen teknis terkait.

User ID

Section ini disiapkan sebagai anchor sidebar untuk halaman/fitur User ID. Isi final dapat ditarik dari modul MMS atau dokumen teknis terkait.

Limit Transaksi

Section ini disiapkan sebagai anchor sidebar untuk halaman/fitur Limit Transaksi. Isi final dapat ditarik dari modul MMS atau dokumen teknis terkait.

Credential Management

Section ini disiapkan sebagai anchor sidebar untuk halaman/fitur Credential Management. Isi final dapat ditarik dari modul MMS atau dokumen teknis terkait.

File Laporan

Section ini disiapkan sebagai anchor sidebar untuk halaman/fitur File Laporan. Isi final dapat ditarik dari modul MMS atau dokumen teknis terkait.

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.