Bahasa Indonesia
API ReferenceLogin

Cara Menggunakan Android SDK Xendit

Last updated 11/19/2019

Menginisiasi Object Xendit

Sebelum menggunakan SDK kami, Anda harus menginisiasi object Xendit dengan cara berikut

...
Xendit xendit = new Xendit(getApplicationContext(), YOUR_PUBLIC_API_KEY);
...

Membuat Token Kartu Kredit

Untuk membuat token, Anda harus membuat object Card, informasi yang harus di ambil dari form kartu kredit Anda di tampilan di dalam aplikasi Anda. Untuk menginisiasikan object Card, Anda membutuhkan:

  1. Nomor kartu kredit
  2. Bulan kadaluarsa kartu kredit (MM)
  3. Tahun kadaluarsa kartu kredit (YYYY)
  4. Nomor verifikasi kartu kredit (3 numbers in the back)
...
Card card = new Card("4000000000000002", "12", "2017", "123");
...

Setelah membuat object_nya, Anda harus memanggil _createSingleUseToken atau createMultipleUseToken tergantung dengan skenario yang Anda butuhkan. Jika Anda menggunakan createSingleUseToken dengan parameter shouldAuthenticate sebagai as true, Anda juga akan mendapatkan ID autentikasi sebagai respon sukses.

...
xendit.createSingleUseToken(card, 75000, true, new TokenCallback() {
    @Override
    public void onSuccess(Token token) {
        // Handle successful tokenization
        System.out.println("Token ID: " + token.getId());
    }
    @Override
    public void onError(XenditError xenditError) {
        // Handle error
    }
});
...

Membuat Autentikasi (3DS)

Untuk token multiple use, Anda harus memisahkan pemanggilan method createAuthentication menggunakan ID token yang Anda dapatkan dari method createMultipleUseToken. Selama proses autentikasi, kami akan menampilkan webview di atas aplikasi Anda agar pelanggan Anda dapat melakukan proses OTP (one time password) atau autentikasi lainnya tergantung dari bank yang mengeluarkan kartu tersebut. Berikut contoh kodenya:

String tokenId = "sample-token-id";
int amount = 50000;
xendit.createAuthentication(tokenId, amount, new AuthenticationCallback() {
    @Override
    public void onSuccess(Authentication authentication) {
        // Handle successful authentication
        System.out.println("Authentication ID: " + authentication.getId());
    }
    @Override
    public void onError(XenditError xenditError) {
        // Handle error
    }
});

Dynamic 3DS

Dynamic 3DS adalah cara untuk Anda untuk mengautentikasi sebuah kartu jika dibutuhkan. Sehingga Anda akan mendapatkan konversi lebih tinggi karena:

  • Anda menghilangkan satu langkah untuk menagih pembayaran dari pelanggan Anda (hanya untuk kartu yang memiliki kemungkinan bertransaksi yang tinggi)

Kami akan memberitahukan Anda kapan Anda perlu mengautentikasikan sebuah kartu atau tidak. Anda akan mendapatkan should_3ds sebagai salah satu respon dari method tokenisasi di Android SDK kami, yang perlu ANda ketahui adalah:

  • Ketika nilainya true, Anda harus mengautentikasi kartu tersebut.
  • Ketika nilainya false, Anda tidak perlu mengautentikasi kartu tersebut.