NICEPAY API
...
E-Wallet - Advance API

DANA Recurring - E-Wallet API Advance

8 min

Tentang API DANA Recurring



 DANA Recurring digunakan oleh  agar  dapat melakukan  secara berkala dengan menggunakan   khusus DANA.



Proses Pada API DANA Recurring





Alur API DANA Recurring


API DANA Recurring Flow
API DANA Recurring Flow


Deskripsi langkah:

  1. Pelanggan mengajukan checkout pada halaman Merchant dan Post-Form API kepada Merchant untuk memulai Recurring Issue.
  2. Merchant mengajukan Post-Form API kepada NICEPAY.
  3. NICEPAY mengarahkan Pelanggan menuju halaman OAuth DANA.
  4. Pelanggan melakukan konfirmasi OAuth kepada DANA.
  5. DANA mengirimkan perjanjian pengguna (user agreement) kepada NICEPAY.
  6. NICEPAY mengajukan pembayaran pertama kepada DANA.
  7. DANA mengirimkan response pembayaran pertama kepada NICEPAY.
  8. DANA mengarahkan Pelanggan ke halaman DANA untuk melakukan recurring (subscription).
  9. Pelanggan melakukan konfirmasi recurring (subscription) kepada DANA.
  10. DANA mengirimkan callback pembayaran pertama kepada NICEPAY.
  11. NICEPAY menerima callback pembayaran pertama.
  12. NICEPAY mengirimkan callback pembayaran pertama kepada Merchant.
  13. DANA mengirimkan push notification kepada NICEPAY.
  14. NICEPAY menerima push notification.
  15. NICEPAY mengirimkan callback push notification kepada Merchant.
  16. DANA mengirimkan push notification kepada NICEPAY pada fase Recurring Payment.
  17. NICEPAY mengirimkan push notification (dengan tXid yang berbeda dan referenceNo yang sama dari Recurring Issue) kepada Merchant.
  18. Apabila Merchant mengajukan Cancel/Remove Recurring kepada NICEPAY, maka:
    1. 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).
    2. Pada proses Remove Recurring, NICEPAY mengajukan penghapusan recurring kepada DANA menggunakan value cancelType; 3 Remove Subscription / Stop Recurring dan tXid pada saat pembayaran pertama.
  19. DANA mengirimkan response data kepada NICEPAY.
  20. NICEPAY mengirimkan response data kepada Merchant.
  21. Merchant mengajukan pengecekan status transaksi menggunakan Check Status API kepada NICEPAY.
  22. NICEPAY mengirimkan response pengecekan status transaksi kepada Merchant.
  23. Merchant menerima status akhir transaksi.
  24. Merchant mengirimkan konfirmasi status transaksi kepada Pelanggan.

Catatan untuk fase Recurring Issue:

  • Mohon simpan tXidrecurring issue setelah menerima callback atau . tXid recurring issue digunakan untuk menghapus recurring (unsubscription).
  • referenceNo adalah ID  recurring.

Catatan untuk fase Recurring :

  •  akan mengirimkan tXid berbeda dari recurring issue.
  •  akan mengirimkan referenceNo  sama dengan recurring issue.



Alur DANA Recurring dari Sisi Pengguna



Berikut ini merupakan alur   dilalui Pengguna untuk melakukan account binding dengan menggunakan DANA Recurring.

1. Pengguna melakukan login pada akun DANA untuk memulai  account binding.

Login DANA Account
Login DANA Account


2. Pengguna melakukan autentikasi dengan memasukkan PIN untuk menyetujui akses binding pada akun DANA.

DANA Recurring Access Binding Authentication
DANA Recurring Access Binding Authentication


3. Setelah Account Binding selesai. Pengguna akan diarahkan menuju  DANA yang akan menampilkan  detail subscription kepada Pengguna.

DANA Agreement Subscription
DANA Recurring Subscription Detail


4. Pengguna diminta untuk melakukan konfirmasi  pertama dengan recurring issue.

DANA First Payment with Recurring Issue Confirmation
DANA First Payment with Recurring Issue Confirmation


5. DANA menampilkan hasil dari   recurring issue kepada .

Payment Result with DANA Recurring Issue
Status Payment Result on DANA Page


6.  menampilkan   kepada  melalui payment page.

Status Payment Result on NICEPAY Payment Page
Status Payment Result on NICEPAY Payment Page