Bahasa Indonesia
API ReferenceLogin

Autentikasi (3DS)

Last updated 01/12/2022

Xendit mendukung 2 metode integrasi untuk melakukan otentikasi pada 3DS dan 3DS 2.0 (EMV 3DS) :

  • Melalui xendit.js atau SDK (Android SDK atau iOS SDK). Kami menyarankan untuk menggunakan xendit.js atau SDK agar mempermudah Anda dalam berintegrasi.
  • Melalui API. Integrasi ini khusus untuk bisnis yang memliki sertifikat PCI-DSS Level 1 yang mana dapat berintegrasi dengan kami menggunakan PAN (Primary Account Number) untuk dapat membuat charge langsung menggunakan nomor kartu kredit atau token Xendit tergantung pada kebutuhan bisnis Anda. Untuk integrasi PAN, Anda dapat melakukan otentikasi menggunakan API kami dengan 2 proses: cek enrollment dan verifikasi 3DS. Dokumentasi API dan panduannya dapat Anda terima dari AM Anda.

EMV 3DS - Frictionless

Untuk otentikasi frictionless disarankan untuk menggunakan xendit.js atau SDK karena SDK kami sudah dapat melakukan dengan EMV 3DS. Perbedaan antara 3DS dan 3DS 2.0 (EMV 3DS) adalah untuk EMV 3DS, Anda dapat memilih untuk memberikan data tambahan (seperti objek billing_details atau customer) pada permintaan otentikasi 3DS untuk mendapatkan otentikasi frictionless. Hal ini tidak wajib. Apabila Anda tidak memberikan data tambahan, Xendit akan tetap memproses 3DS sebagai EMV 3DS walaupun frictionless tidak dapat dilakukan.


Apabila Anda menggunakan token Xendit dan melakukan tokenisasi + 3DS menggunakan xendit.js atau SDK, data tambahan harus diberikan pada tokenisasi. Untuk data tambahan Xendit menyarankan menambahkan setidaknya objek billing_details dan customer agar otentikasi frictionless dapat terjadi pada kartu yang mendukung.

  1. objek billing_details berisi:
    1. given_names
    2. surname
    3. email
    4. mobile_number
    5. phone_number
    6. address
      1. country
      2. street_line1
      3. street_line2
      4. city province_state
      5. postal_code
  2. objek customer berisi:
    1. reference_id
    2. mobile_number
    3. phone_number
    4. email
    5. given_names
    6. surname
    7. nationality (tidak digunakan untuk 3DS)
    8. date_of_birth (tidak digunakan untuk 3DS)
    9. description (tidak digunakan untuk 3DS)
    10. metadata (tidak digunakan untuk 3DS)
    11. addresses
      1. country
      2. street_line1
      3. street_line2
      4. city
      5. province_state
      6. postal_code category (tidak digunakan untuk 3DS)

Parameter khusus (lihat disini untuk deskripsi)

Contoh Demo

Anda dapat menggunakan contoh halaman demo menggunakan xendit,.js [referensi] untuk melakukan otentikasi:

Apabila Anda berhasil melakukan EMV 3DS, maka Anda dapat melihat halaman demo 3DS seperti ini:





Anda dapat melihat daftar nomor kartu tes untuk EMV 3DS yang dapat digunakan di halaman demo.