Bahasa Indonesia
API ReferenceLogin

3DS Dinamis

Last updated 03/20/2021

Pengenalan

3DS meningkatkan keamanan pembelian online karena ini sangat membantu untuk verifikasi identitas seseorang. Proses ini umumnya memerlukan langkah tambahan. Seperti _One-Time-Password _atau login aplikasi. Secara umum, ini akan menambahkan gesekan bagi pelanggan anda ketika proses pembayaran.

Memiliki 3DS uang aktif bisa juga menyebabkan pembayaran untuk gagal. Alasannya bisa termasuk:

  • Tidak semua bank memiliki 3DS karena ini tidak digunakan di seluruh dunia. Contohnya, 3DS mungkin tidak umum untuk bank di Amerka Utara (AS, Canada)
  • Sebuah issuing bank mungkin mengurangi kemungkinan untuk penolakan pembayaran jika 3DS tidak diaktifkan
  • Sebuah kartu bisa bisa tidak terdaftar untuk 3DS, contohnya karena tidak diaktifkan untuk e-Commerce.

Bagaimana 3DS Dinamis bisa membantu?

3DS Dinamis Xendit meninjau transaksi kartu online yang dilakukan oleh pelanggan anda, dan melihat apakah transaksinya lebih besar kemungkinan untuk di prosesnya jika 3DS di skip.

Setiap kartu memiliki Bank Identification Number (BIN), yang terdiri dari 6 digit pertama dari kartu.

Setiap kali pelanggan anda melakukan pembelian online melalui Xendit dengan akun yang memiliki 3DS Dinamis diaktifkan, kami sistem akan melakukan penilaian penerimaan kartu yang memiliki BIN yang sama ketika transaksi 3DS aktif atau di skip. Penilaian ini akan memeriksa apakah BIN dari kartu ini memiliki tingkat kegagalan yang tinggi jika 3DS di aktifkan. Penilaian ini menggunakan data dari seluruh transaksi yang kami proses untuk semua merchant kami.

Hasil dari penilaiannya mudah:

  • Jika sebuah kartu dinilai untuk memiliki tingkat kesuksesan yang lebih tinggi dengan 3DS diaktifkan, maka kami akan merekomendasikan 3DS untuk diaktifkan. Jika anda menggunakan Xeninvoice, 3DS akan dimulai secara otomatis dalam kasus ini. Rekomendasinya akan terlihat seperti ini:
{
    "should_3ds": true,
    "bin_number": "466160"
}
  • Jika kartunya memiliki penilaian bahwa tingkat penerimaan kartunya akan lebih tinggi tanpa memiliki 3DS, maka 3DS tidak akan dilakukan untuk transaksinya.
{
    "should_3ds": false,
    "bin_number": "420080"
}

Catatan:

Mengaktifkan 3DS Dinamis tidak akan menonaktifkan 3DS pada seluruh transaksi. Untuk transaksi dimana 3DS Dinamis menilai untuk tidak skip 3DS, maka 3DS akan dilakukan.

Keuntungan 3DS Dinamis.

Anda bisa anda bisa mengharapkan penerimaan lebih tinggi untuk transaksi kartu anda, artinya volume, untung, dan transaksi yang lebih tinggi, dan pengalaman pembayaran yang lebih baik untuk pelanggan anda.

Hubungi account manager anda jika anda ingin melakukan penilaian dampak yang akan terjadi bagi pembayaran anda jika ini diberlakukan. Secara ideal ini akan perlu beberapa bulan agar ada data yang cukup untuk melakukan analisis perbandingan.

Yang anda harus perhatikan

Pada transaksi yang 3DS nya tidak dilakukan, maka tidak ada kewajiban penanggungjawaban untuk chargeback akibat penipuan. Maka, jika transaksinya didapatkan sebagai penipuan, dan pemilik kartu bisa melaporkan chargeback, ada kemungkinan bahwa anda bisa kalah chargeback dan mengembalikan dana yang diterima pada transaksinya.

Karena 3DS adalah sebuah alat untuk menghindari penipuan, melangkahi 3DS bisa meningkatkan resiko penipuan. Fraud Guard Xendit bisa membantu anda untuk menurunkan resiko penipuan semacamnya dalam kendali anda.

Bagaimana anda bisa mengaktifkan 3DS Dinamis

Silahkan hubungi account manager anda atau kirimkan pesan ke help@xendit.co jika anda ingin mengaktifkan 3DS Dinamis.Kami akan membalas dan proses bersama dari titik tersebut.

Harap diketahui bahwa tidak semua merchant berhak untuk mendapatkan 3DS Dinamis karena melangkahi 3DS akan membawa resiko yang diukur oleh Xendit untuk masing-masing merchant, berdasarkan industri anda dan kondisi bisnis.

Pengaturan Dynamic 3DS untuk digunakan

Dari ini kami anda bisa menemukan bagaimana menggunakan 3DS Dinamis sesuai dengan integrasi anda bersama Xendit.

Integrasi Langsung Dengan Xendit.js

Xendit.JS secara otomatis diupdate ketika kami menambahkan fitur padanya. Jika anda integrasikan langsung dengan Javascript (contohnya pada halaman HTML), selagi anda menggunakan langsung Xendit.JS pada CDN, maka dalamnya akan ada fungsi 3DS Dinamis

Kode yang relevan pada Xendit.JS yang melakukan 3DS Dinamis adalah:

Xendit.card.threeDSRecommendation = function (requestData, callback)

Untuk transaksi yang menggunakan single use token, karena Xendit.JS menggabungkan Tokenization dan 3DS bersama, 3DS Dinamis dan proses autentikasi akan dilakukan otomatis. Tidak ada langkah selanjutnya yang diperlukan bagi anda ketika 3DS Dinamis diaktifkan.

Untuk proses token berulang, anda bisa menggunakan fungsi yang memanggil:

Xendit.card.threeDSRecommendation = function (requestData, callback)

permintaan

// if using token ID</code>
var requestData = {
token_id: '5ddb78581341a42969aac5de'
}
// "token_id" is the Xendit-generated ID of the multiple-use token you created during tokenisation</code>

// if using BIN
var requestData = {
bin_number: '123456'
}
// "bin_number" is the BIN of the card that is transacting

Anda akan perlu menulis fungsi untuk menghandle fungsi callback

callback = function (err, recommendation)

Fungsi callback ini menerima dua argument:

  • err adalah objek error yang memiliki informasi tentang kegagalan
  • recommendation memiliki rekomendasi 3DS untuk melakukan 3DS atau melangkahi 3DS

Informasi recommendation akan dilalui ke fungsi callback dan akan terlihat seperti berikut ini:

{
  "should_3ds": true,
  "token_id": "5ddb78581341a42969aac5de",
  "bin_number": "123456"
}
// if Dynamic 3DS recommends that 3DS should be skipped, "should_3ds" will return "false"
// if you used "bin_number" to send the request, you will not see "token_id" in the recommendation

Invoices

Pada Invoice Xendit yang melalui UI invoice, ketika 3DS Dinamis telah diaktifkan maka akan bekerja secara otomatis. Rekomendasi 3DS akan di hasilkan pada backend dan pembayaran akan langsung menentukan untuk melangkahi, atau melakukan 3DS berdasarkan rekomendasinya. Anda tidak perlu melakukan hal apapun untuk melakukan ini.

SDK

Jika anda menggunakan SDK Xendit untuk integrasi, silahkan gunakan referensi 3DS Dinamis - SDK untuk implementasinya.

Testing Dynamic 3DS

Kami memiliki halaman test yang bisa anda kirimkan permintaan 3DS Dinamis dan melihat contoh resposne. Dibawah "API Configuration", anda bisa memasukkan Public Key yang bisa didapatkan dari dasbor Xendit anda di bagian Settings (Settings > Developer > API keys).

Anda bisa mencoba menggunakan halaman ini meskipin 3DS Dinamis anda belum diaktifkan.

Panduan Testing

Dibawah ini adah BIN kartu yang bisa anda gunakan untuk simulasi mendapatkan true atau false pada halaman test.

SkenarioBIN
3DS dinamis memberikan rekomendasi true520000
3DS dinamis memberikan rekomendasi false411111

Seperti disebutkan diatas, anda perlu membuat response 3DS Autentikasi jika anda mendapatkan rekomendasi true. Jika rekomendasi false maka autentikasi akan dilangkahi dan anda bisa melanjutkan proses pembayaran langsung.

Catatan: Anda dapat menggunakan default public API key (yang sudah terisi pada form) pada halaman testing Dynamic 3DS kami. Jika Anda ingin menggunakan akun Anda, Anda harus melakukan aktivasi terlebih dahulu pada dashboard [Settings > Payment Method > Cards > Cards Settings] (https://dashboard.xendit.co/settings/payment-methods/cards-configuration).