--- title: DANA Recurring - E-Wallet API Advance slug: nicepay-api-non-snap-dana-recurring-e-wallet-advance-api description: Informasi tentang API Non-SNAP Advance API - E-Wallet DANA Recurring yang terdapat pada sistem NICEPAY image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/oVSNSVsPsLON3d197ovL3_nicepay-docs-logo.png icon: {"faIcon":"fa-solid fa-recycle"} docTags: createdAt: 2024-04-25T09:36:44.895Z --- # 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 *** ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/ZzCCSZjUTXxf4WI8jrlsq-20260324-083727.jpg"} [Registration & First Payment - DANA Recurring API](docId\:QngCkmF9xhd6PS8sjxzED) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/B1Byy1gINnfOLhqabj2EZ-20260324-084155.jpg"} [Notification - DANA Recurring API](docId\:RqJL301xruHjLAAxYUJkc) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/7lDT1ME5tasTtqy_Be4yh-20260324-084626.jpg"} [Inquiry - DANA Recurring API](docId\:gxO4Xfjn_js-RXy0WFVBy) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/XBEBeoRRNSW11IFbchkFp-20260324-084645.jpg"} [Cancel & Remove - DANA Recurring API](docId\:f7fJvyopZY6UqIip_-jFJ) ::: :::: # Alur API DANA Recurring *** ![](https://api.archbee.com/api/optimize/ueSgidS-H3kdWkcRhVS2v-4Ugd6q0Tf6-Q0glULGQ1w-20250619-094215.jpg "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. :::hint{type="info"} Catatan untuk fase *Recurring Issue:* - Mohon simpan `tXid`*recurring 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*. ![Login DANA Account](https://api.archbee.com/api/optimize/ueSgidS-H3kdWkcRhVS2v-yyL36a_DuASGSoi31HO4I-20250626-031152.png "Login DANA Account") 2\. Pengguna melakukan autentikasi dengan memasukkan PIN untuk menyetujui akses *binding *pada akun DANA. ![](https://api.archbee.com/api/optimize/ho7Cq0xJG60lzOZLT7xI3-B6WX_Y8GtHcC2Pn0FY5G8-20250528-034738.png "DANA Recurring Access Binding Authentication") 3\. Setelah Account Binding selesai. Pengguna akan diarahkan menuju halaman DANA yang akan menampilkan informasi detail *subscription *kepada Pengguna. ![DANA Agreement Subscription](https://api.archbee.com/api/optimize/ho7Cq0xJG60lzOZLT7xI3-pldzcV7ezentowyRMGGtZ-20250528-034801.png "DANA Recurring Subscription Detail") 4\. Pengguna diminta untuk melakukan konfirmasi pembayaran pertama dengan *recurring issue.* ![](https://api.archbee.com/api/optimize/ho7Cq0xJG60lzOZLT7xI3-8LkqT-5pPlEUUBqsPmx6W-20250528-034822.png "DANA First Payment with Recurring Issue Confirmation") 5\. DANA menampilkan hasil dari status pembayaran *recurring issue* kepada Pelanggan. ::Image[]{src="https://api.archbee.com/api/optimize/ho7Cq0xJG60lzOZLT7xI3-PPiT-2fSnk0tsOOTjtYqF-20250528-034906.png" size="48" width="440" height="665" position="center" caption="Status Payment Result on DANA Page" alt="Payment Result with DANA Recurring Issue" showCaption="true"} 6\. NICEPAY menampilkan status pembayaran kepada Pelanggan melalui *payment page*. ![](https://api.archbee.com/api/optimize/ho7Cq0xJG60lzOZLT7xI3-9x17Vu7dXzgmujGRaQzfl-20250528-034922.png "Status Payment Result on NICEPAY Payment Page")