Bahasa Indonesia
API ReferenceLogin

Cicilan

Last updated 12/01/2021

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:

  1. Kartu diterbitkan oleh BRI
  2. Tenor cicilan yang tersedia yaitu 3, 6 and 12 bulan
  3. Fitur ini hanya berlaku untuk pembayaran dalam mata uang Rupiah Indonesia (IDR)
  4. 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 body Create 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 menggunakan nomor kartu dibawah ini untuk melakukan simulasi transaksi cicilan kartu kredit pada mode tes

Tipe KartuNomor kartu
BRI Mastercard5104 5821 7994 9459
BRI Visa4365 0237 8115 5828
BRI JCB3563 5017 2728 3491
BNI Mastercard5426 4045 6410 9386
BNI Visa4105 0676 8505 4202
BNI JCB3565 2427 2869 5395