Skip to main content

Panduan Integrasi

Pelajari cara menggunakan Direct Debit melalui Xendit dengan 5 langkah-langkah berikut

Langkah 1: Buat Akun Xendit

Pastikan Anda telah memailiki akun Xendit. Registrasi di Dasbor Xendit dan aktivasi Direct Debit.

Langkah 2: Buat Customer

Objek customer dibuat untuk memudahkan penghubungan transaksi dan metode pembayaran untuk customer tertentu. Anda hany perlu membuat objek customer satu kali untuk setiap customer. Objek lain yang akan dihubungkan dengan customer diantaranya linked account token dan payment method.

  1. Merchant mengirimkan POST request ke  Create Customer API dengan parameter yang telah disediakan. Pastikan informasi customer akurat karena customer akan menggunakan informasi ini untuk melakukan proses refund atau chargeback.
  2. Xendit akan merespon dengan JSON yang mengandung properti spesifik, jika sukses. Jika tidak, pesan error akan muncul. ID yang muncul pada respon akan menjadi ID objek customer yang akan digunakan untuk transaksi berikutnya.

Langkah 3: Inisiasi Tautan Akun

Linked token merepresentasikan otorisasi yang dilakukan oleh customer untuk mengakses penyedia layanan tertentu. Customer object dibutuhkan untuk melakukan proses account linking.

  1. Merchant mengirimkan request POST ke Initiate Account Authorization API dengan parameter wajib yang telah tersedia. Proses ini dilakukan untuk setiap penyedia layanan/bank. Pastikan yntuk menyediakan customer_id.

Penghubungan debit card di Indonesia:

  1. Setelah menerima respon suskses, hal ini berarti OTP akan dikirimkan ke nomor handphone customer yang telah terdaftar dengan sms banking/internet banking/moobile banking
  2. Untuk menyelesaikan penghubungan akun, OTP yang valid harus dikirimkan ke endpoint Validate Authorization API.

Langkah 4: Buat Metode Pembayaran

Payment method adalah langkah awal yang harus dilakukan untuk meningkatkan fleksibilita dan kegunanaan direct debit lintas proses dan regional. Payment method dibutuhkan untuk membuat direct debit; proses ini mewakili akses pada akun bank atau kartu debit.

  1. Merchant mengirimkan POST request ke endpoint Activate Payment Method API dengan parameter yang telah disediakan. Pastikan untuk menyediakan ID akun yang valid (prefix “la-xxx”) di properti. ID akun didapatkan dari GET linked accounts API
  2. Xendit akan merespon dengan JSON dengan properti spesifik, jika berhasil. Jika tidak, pesan error akan muncul. ID payment method _akan dugunakan untuk membuat transaksi pada direct debit atau _recurring payment.

Langkah 5: Buat Pembayaran Direct Debit

  1. Merchant mengirimkan POST request ke Create Direct Debit Payment API dengan parameter yang tersedia.

    1. payment_method_id.ID dari payment method yang ingin Anda tarik dari sumber dana.

    2. Basket object membantu merchant untuk mencatat barang yang dibeli tiap transaksi.

      • Metadata. Metadata memungkinkan merchant untuk memasukkan atribut tambahan pada objek produk seperti dimensi, pengidentifikasi promo, dll.
  2. Transaksi akan tetap mendapatkan status PENDING hingga penarikan dana telah dikonfirmasi SUCCESS atau GAGAL

  3. Endpoint ini akan mengembalikan format JSON. Jika parameter is_otp_required adalah TRUE , direct debit akan langsung sukses setelah OTP diverifikasi oleh penyedia layanan/bank.

    1. Merchant diwajibkan untuk dapat menampilkan halaman penerimaan OTP sendiri. Untuk melanjutkan transaksi, merchant harus mengirimkan OTP ke endpoint Validate One-Time Password. Jika sukses, transaksi akan diproses.
  4. Xendit akan mengirimkan callback ke callback_url merchant apakah pendebetan sukses atau tidak.