Cicilan

Setelah Anda melakukan konfigurasi fitur cicilan, Anda dapat melihat langkah berikut untuk melakukan integrasi fitur cicilan:

Permintaan Opsi Charge

Pastikan pelanggan Anda dapat melakukan cicilan dengan melihat respon Get Charge Option. Contoh respon Get Charge Options yang menunjukan kartu kredit pelanggan Anda didukung fitur cicilan dapat dilihat sebagai berikut:

{
  "business_id": "5ea2a0cdb62b6a00108ed248",
  "bin": "552002",
  "installments": [
    {
      "count": "3",
      "interval": "month",
      "acquirer": "BRI",
      "currency": "IDR",
      "minimum_amount": 500000
    },
    {
      "count": "6",
      "interval": "month",
      "acquirer": "BRI",
      "currency": "IDR",
      "minimum_amount": 500000
    },
    {
      "count": "12",
      "interval": "month",
      "acquirer": "BRI",
      "currency": "IDR",
      "minimum_amount": 500000
    }
  ]
}

Respon di atas menjelaskan bahwa:

Kartu diterbitkan oleh BRI
Tenor cicilan yang tersedia yaitu 3, 6 and 12 bulan
Fitur ini hanya berlaku untuk pembayaran dalam mata uang Rupiah Indonesia (IDR)
Minimum jumlah yang dibutuhkan untuk pembayaran menggunakan fitur cicilan ini adalah 500,000 IDR

Sebagai Merchant, Anda tentunya menginginkan pelanggan Anda memilih skema cicilan mana yang ingin mereka gunakan, sehingga Anda harus menerima respon dari Get Charge Options API, untuk kemudian menampilkan pilihan cicilan yang tersedia pada tampilan antarmuka aplikasi Anda.

Buat Charge API dengan parameter cicilan (installments)

Setelah Anda mengetahui bahwa pelanggan Anda dapat melakukan pembayaran dengan fitur cicilan, Anda dapat membuat permintaan Charge dengan menambahkan parameter yang memberitahukan kepada Xendit bahwa pemilik kartu ingin melakukan pembayaran menggunakan fitur cicilan.

Ketika pelanggan Anda memilih skema cicilan pada antarmuka aplikasi Anda dan melakukan konfirmasi pembayaran, Anda dapat melakukan Create Charge API dengan parameter sesuai skema cicilan yang dipilih pelanggan Anda. Parameter tambahan yang dibutuhkan adalah tenor cicilan (contoh: 3 bulan)

Sebagai catatan, terdapat minimum nilai transaksi pada beberapa bank untuk menggunakan fitur cicilan:

BRI: 500,000 IDR
BNI: 500,000 IDR

Saat kartu pelanggan Anda didukung fitur cicilan, informasi cicilan diberikan pada respon Get Charge Option dan pelanggan Anda dapat memilih cicilan untuk transaksinya. Setelah melakukan Tokenisasi dan Otentikasi, Anda dapat menambahkan objek installment pada request bodyCreate Charge API. Lihat contoh dari permintaan transaksi pada Charge API menggunakan parameter cicilan (installment) sebagai parameter tambahan:

{
  "token_id": "598d5d0e51e0870d44c61534",
  "external_id": "installment-charge-12309050",
  "amount": 1500000,
  "authentication_id": "598d5d0f51e0870d44c61535",
  "card_cvn": "666",
  "descriptor": "installment",
  "currency": "IDR",
  "installment": {
    "count": 3,
    "interval": "month"
  }
}

Jika permintaan pada Charge API sukses dan pembayaran diterima, maka transaksi cicilan Anda berhasil!

Xendit akan mendaftarkan transaksi charge tersebut sebagai pembayaran cicilan dan mengirimkan rincian transaksi ke bank penerima, sehingga mereka dapat mengidentifikasi dan mengubah transaksi tersebut menjadi transaksi cicilan.

Pada bagian CSV exports di dasbor Anda, Anda akan dapat mengidentifikasi transaksi mana saja yang menggunakan fitur cicilan untuk membantu rekonsiliasi.

Simulasi Cicilan

Anda dapat melakukan simulasi transaksi cicilan kartu kredit pada mode tes dengan menggunakan nomor kartu tes cicilan pada halaman berikut.

Last Updated on 2023-05-20

Permintaan Opsi Charge
Buat Charge API dengan parameter cicilan (installments)
Simulasi Cicilan