Panduan Integrasi

Pembayaran Sekali Waktu

Pembayaran sekali waktu atau one-time payments mengacu pada pembayaran di mana pengguna akhir diharuskan mengotorisasi pembayaran (melalui OTP atau PIN) di setiap transaksi. Alur ini sering digunakan ketika pengguna akhir ingin menyelesaikan pembayaran dengan cepat tanpa mendaftar atau menyimpan informasi pribadi.

Ada 2 jenis aliran one-time payment yang disediakan oleh partner eWallet:

• Pembayaran melalui pengalihan dan
• Pembayaran tanpa pengalihan

Silakan merujuk pada halaman charge endpoint dan notifikasi pembayaran pada API Reference untuk membuat metode checkout ONE_TIME_PAYMENT.

• Dengan pengalihan - DANA, LINKAJA, SHOPEEPAY (ID), ASTRAPAY, GCASH, MAYA (PAYMAYA), GRABPAY, SHOPEEPAY (PH)
• Tanpa pengalihan - OVO,Jenius Pay

Pembayaran Tokenisasi

Pembayaran tokenisasi dirancang untuk memaksimalkan tingkat keberhasilan pembayaran dengan mengurangi jumlah otentikasi yang diperlukan pada setiap transaksi.

• Pengguna yang pertama kali bertransaksi atau pengguna dengan token kedaluwarsa akan diarahkan untuk melakukan otorisasi penautan akun satu kali dengan PIN dan OTP
• Setelah otorisasi selesai, Anda akan menerima token pembayaran sebagai konfirmasi penautan akun pelanggan. Anda dapat menggunakan token pembayaran untuk melakukan pembayaran melalui auto debit atau pengalihan PIN (tanpa SMS OTP) untuk menyelesaikan transaksi
• Anda dapat menggunakan kembali token pembayaran tersebut untuk pembayaran selanjutnya untuk mempermudah proses pembayaran pelanggan Anda; dengan kata lain, alur ini mengurangi otentikasi menjadi hanya PIN saja atau bahkan tanpa otentikasi sama sekali

Lihat dokumentasi Account Linking untuk melakukan penautan akun.

Alur Account Linking

Alur account linking - OVO, DANA, LINKAJA, SHOPEEPAY (ID), MAYA (PAYMAYA), GRABPAY, SHOPEEPAY (PH)

Terdapat 2 langkah untuk melakukan account linking menggunakan alur tokenisasi kami - dimulai dengan pembuatan customer objek dan diakhiri dengan pembuatan metode pembayaran.

Langkah 1 - Pembuatan customer objek melalui /customers endpoint adalah langkah pertama yang diperlukan sebelum memulai account linking untuk tokenisasi eWallet.

• customer_id yang dibuat akan digunakan dalam panggilan API berikutnya untuk mengidentifikasi pengguna akhir yang melakukan account linking.
• Tergantung persyaratan setiap kanal pembayaran, mungkin ada isian wajib untuk customer objek (mis. OVO memerlukan nama dan nomor telepon).
• Dalam skenario tersebut, disarankan bagi merchant untuk membuat UI bagi pengguna akhir untuk memasukkan informasi ini sendiri.

Silakan merujuk ke Buat API Customer Objek untuk rincian.

Langkah 2 - Account Linking di eWallet yang diberi token mengacu pada pengguna akhir yang memberi otorisasi kepada merchant untuk melakukan transaksi melalui token (penautan) untuk (akun) eWallet pengguna akhir.

• Endpoint ini memulai proses otorisasi, dan sebagai hasilnya, metode pembayaran akan dibuat. Pengguna akhir perlu diarahkan ke halaman host penyedia eWallet untuk mengotorisasi account linking.
• Setelah account linking diselesaikan oleh pengguna akhir, pemberitahuan account linking akan dikirim ke URL callback yang ditentukan di Dasbor Xendit bagian metode pembayaran.

Silakan merujuk ke API Account Linking dan Callback Status Account Linking untuk rincian.

Alur Pembayaran

Ada 2 jenis aliran pembayaran tokenisasi yang disediakan oleh Xendit berdasarkan berbagai penyedia eWallet yang kami dukung - pembayaran auto debit dan pembayaran melalui pengalihan PIN. Lihat bagian charge object, charge endpoint and notifikasi pembayaran dalam dokumentasi ini untuk membuat metode pembayaran TOKENIZED_PAYMENT.

Bila memungkinkan, disarankan bagi merchant untuk menampilkan saldo eWallet pengguna akhir di halaman checkout untuk memaksimalkan tingkat keberhasilan pembayaran. Lihat Get Saldo Akun/API Rincian Metode Pembayaran untuk menampilkan saldo pengguna akhir saat ini.

• Pengalihan untuk PIN - OVO, DANA, LINKAJA, SHOPEEPAY (ID)
• Auto debit - OVO (Persetujuan Khusus), DANA, SHOPEEPAY (ID) (Persetujuan Khusus), PAYMAYA, GRABPAY, SHOPEEPAY (PH)

Penanganan Token yang Tidak Valid / Kedaluwarsa

Ada kemungkinan token yang disimpan menjadi tidak valid, contohnya ketika pengguna akhir mengubah kredensial login mereka dengan penyedia eWallet atau mencabut akses dari platform eWallet. Ketika hal tersebut terjadi, merchant perlu memulai otorisasi kembali. Ada dua cara untuk merchant mengetahui bahwa token tidak lagi valid:

• Ketika debit langsung. Jika respons menampilkan error code: INVALID_PAYMENT_METHOD_ERROR
• Melalui webhook, Xendit akan mengirimkan notifikasi kedaluwarsa ke URL callback yang digunakan untuk account linking untuk memberi tahu merchant bahwa akun ini invalid atau telah dibuat atau menjadi tidak valid.

Last Updated on 2023-05-17