Konsep
Saat menggunakan produk pembayaran berulang kami, penting untuk memahami beberapa istilah dan konsep sebelum melanjutkan integrasi. Di bagian ini, kami akan menguraikan informasi utama yang diperlukan untuk mulai menggunakan produk pembayaran berulang.
Tipe pembayaran berulang
Produk pembayaran berulang kami saat ini hanya mendukung "TERIMA PEMBAYARAN" sebagai jenis pembayaran berulang.
Pembayaran berulang - umumnya dikenal sebagai langganan, Xendit dapat membantu Anda mengumpulkan pembayaran secara terjadwal (tahunan/bulanan/mingguan) seperti yang ditentukan oleh Anda.
Penting untuk diperhatikan bahwa tindakan "PEMBAYARAN" berulang hanya berfungsi untuk saluran pembayaran dengan autodebit/transaksi yang dapat dilakukan Anda (Anda dapat memotong saldo pelanggan secara langsung tanpa PIN atau OTP). Pelanggan harus melakukan otorisasi satu kali dengan penyedia pembayaran sebelum Xendit dapat menagih pelanggan sesuai jadwal.
Penautan akun (untuk jenis PEMBAYARAN berulang)
Tokenisasi/ 3DS/ penautan akun adalah langkah pertama yang penting untuk mulai menggunakan produk pembayaran berulang Xendit. Ada 2 cara untuk menyelesaikan penautan akun bagi pelanggan -
- Menggunakan UI penautan akun yang dimiliki Xendit
- Anda membuat UI sendiri (dengan PCI DSS)
Anda harus mengarahkan pelanggan ke (1) atau (2) untuk memilih metode pembayaran dan memasukkan OTP dan/atau PIN mereka dengan penyedia pembayaran. Setelah selesai, Anda akan menerima ID yang disebut payment_method_id yang akan digunakan saat integrasi dengan Xendit untuk metode pembayaran mana yang akan digunakan dalam paket pembayaran berulang.
Konsep Pembayaran Berulang
Untuk memahami cara kerja pembayaran berulang di Xendit, ada beberapa konsep yang harus dipahami developer. Konsep ini terkait dengan data dan objek yang digunakan dalam proses kami untuk membantu Anda menyiapkan pembayaran rutin pelanggan.
| Konsep | Deskripsi |
|---|---|
| Objek Pelanggan | Objek data tentang pelanggan Anda. Xendit menggunakan ini untuk mengirimkan notifikasi, menampilkan informasi pembayaran berulang yang relevan, atau metode pembayaran yang terkait dengan pelanggan Anda. |
| Objek Jadwal | Objek data tentang logika kapan tindakan berulang harus terjadi. Objek ini berisi informasi yang ditentukan Anda tentang pengaturan waktu pembayaran berulang - yaitu interval (hari/ bulan/ tahun) antara setiap pembayaran. Misalnya, jika Anda ingin menagih pembayaran setiap triwulan, jadwalnya diatur dalam objek ini. |
| Objek Rencana | Objek data utama yang akan membantu Anda menyusun logika berulang. Objek rencana pembayaran berulang akan memasukkan objek customer, objek schedule (opsional), dan payment_method_id (opsional) untuk menyiapkan langganan bagi pelanggan tertentu. Objek rencana pembayaran berulang juga menggunakan parameter lain untuk penyesuaian yang lebih mendetail (mis. pemberitahuan, pembayaran segera). |
| Objek Siklus | Objek data yang dibuat secara otomatis berdasarkan objek rencana pembayaran berulang. Setiap objek cycle mewakili contoh penagihan individual (untuk rencana bulanan berulang yang disiapkan selama satu tahun, akan ada 12 cycle berulang yang dihasilkan). Perubahan ad hoc dapat dibuat untuk cycle tertentu tanpa memengaruhi objek plan. Objek plan memiliki hubungan satu ke banyak dengan objek cycle. |
| Percobaan | Upaya berulang mengacu pada setiap tindakan berulang individu (misalnya pembayaran) yang dilakukan untuk menyukseskan objek siklus berulang. Siklus berulang dapat memiliki beberapa percobaan tergantung pada konfigurasi percobaan ulang (mis. jika sebuah siklus memiliki 2 percobaan ulang yang dikonfigurasi, bisa ada hingga total 3 percobaan). Semua upaya berulang akan disimpan di dalam objek siklus berulang. Objek siklus berulang memiliki hubungan satu ke banyak dengan upaya berulang. |
| action_id | action_id mengacu pada ID unik dari tindakan yang terkait dengan setiap upaya (mis. payment_id). Dalam sekali percobaan, bisa ada beberapa action_id jika merchant mengonfigurasi beberapa metode pembayaran selama pembuatan paket berulang. Berdasarkan peringkat masing-masing metode pembayaran, Xendit akan menjalankan setiap metode pembayaran sampai kami menerima satu pembayaran yang berhasil atau jika semua pembayaran gagal. Upaya berulang memiliki hubungan satu ke banyak dengan action_id. |
Entities Relationship Diagram Pembayaran Berulang
Last Updated on 2023-05-23