DANA Recurring - E-Wallet API Advance
Tentang API DANA Recurring
API DANA Recurring digunakan oleh Merchant agar Pelanggan dapat melakukan transaksi secara berkala dengan menggunakan metode pembayaran E-Wallet khusus DANA.
Proses Pada API DANA Recurring
Alur API DANA Recurring
Deskripsi langkah:
- Pelanggan mengajukan checkout pada halaman Merchant dan Post-Form API kepada Merchant untuk memulai Recurring Issue.
- Merchant mengajukan Post-Form API kepada NICEPAY.
- NICEPAY mengarahkan Pelanggan menuju halaman OAuth DANA.
- Pelanggan melakukan konfirmasi OAuth kepada DANA.
- DANA mengirimkan perjanjian pengguna (user agreement) kepada NICEPAY.
- NICEPAY mengajukan pembayaran pertama kepada DANA.
- DANA mengirimkan response pembayaran pertama kepada NICEPAY.
- DANA mengarahkan Pelanggan ke halaman DANA untuk melakukan recurring (subscription).
- Pelanggan melakukan konfirmasi recurring (subscription) kepada DANA.
- DANA mengirimkan callback pembayaran pertama kepada NICEPAY.
- NICEPAY menerima callback pembayaran pertama.
- NICEPAY mengirimkan callback pembayaran pertama kepada Merchant.
- DANA mengirimkan push notification kepada NICEPAY.
- NICEPAY menerima push notification.
- NICEPAY mengirimkan callback push notification kepada Merchant.
- DANA mengirimkan push notification kepada NICEPAY pada fase Recurring Payment.
- NICEPAY mengirimkan push notification (dengan tXid yang berbeda dan referenceNo yang sama dari Recurring Issue) kepada Merchant.
- Apabila Merchant mengajukan Cancel/Remove Recurring kepada NICEPAY, maka:
- Pada proses Cancel Transaction, NICEPAY mengajukan pembatalan transaksi kepada DANA menggunakan value cancelType; 1 pembatalan secara penuh (Full Cancellation) atau 2 pembatalan sebagian (Partial Cancellation).
- Pada proses Remove Recurring, NICEPAY mengajukan penghapusan recurring kepada DANA menggunakan value cancelType; 3 Remove Subscription / Stop Recurring dan tXid pada saat pembayaran pertama.
- DANA mengirimkan response data kepada NICEPAY.
- NICEPAY mengirimkan response data kepada Merchant.
- Merchant mengajukan pengecekan status transaksi menggunakan Check Status API kepada NICEPAY.
- NICEPAY mengirimkan response pengecekan status transaksi kepada Merchant.
- Merchant menerima status akhir transaksi.
- Merchant mengirimkan konfirmasi status transaksi kepada Pelanggan.
Catatan untuk fase Recurring Issue:
- Mohon simpan tXidrecurring issue setelah menerima callback atau notifikasi. tXid recurring issue digunakan untuk menghapus recurring (unsubscription).
- referenceNo adalah ID transaksi recurring.
Catatan untuk fase Recurring Payment:
- NICEPAY akan mengirimkan tXid berbeda dari recurring issue.
- NICEPAY akan mengirimkan referenceNo yang sama dengan recurring issue.
Alur DANA Recurring dari Sisi Pengguna
Berikut ini merupakan alur proses yang dilalui Pengguna untuk melakukan account binding dengan menggunakan DANA Recurring.
1. Pengguna melakukan login pada akun DANA untuk memulai proses account binding.
2. Pengguna melakukan autentikasi dengan memasukkan PIN untuk menyetujui akses binding pada akun DANA.
3. Setelah Account Binding selesai. Pengguna akan diarahkan menuju halaman DANA yang akan menampilkan informasi detail subscription kepada Pengguna.
4. Pengguna diminta untuk melakukan konfirmasi pembayaran pertama dengan recurring issue.
5. DANA menampilkan hasil dari status pembayaran recurring issue kepada Pelanggan.
6. NICEPAY menampilkan status pembayaran kepada Pelanggan melalui payment page.
