Kapan Menggunakan Redirect
- Verifikasi lintas perangkat: Mulai di desktop, selesaikan di ponsel
- Kompatibilitas maksimal: Berfungsi di semua browser, termasuk browser yang lebih lama
- Integrasi sederhana: Tidak perlu konfigurasi iframe
- Masalah kamera: Saat akses kamera iframe bermasalah
Implementasi
Langkah 1: Buat sesi (backend)
Respons pembuatan sesi menggunakan kolom bernamaurl. Teruskan nilai tersebut ke browser.
Langkah 2: Alihkan Pengguna (Frontend)
HTML:Menangani Callback
Ketika verifikasi selesai, Didit mengalihkan pengguna ke URL callback Anda dengan parameter query:Contoh Next.js
Contoh Express.js
Contoh Vue Router
Buka di Tab Baru
Jika Anda ingin aplikasi tetap terbuka selama pengguna melakukan verifikasi:Praktik Keamanan Terbaik
Verifikasi callback di sisi server
Perlakukan parameter queryverificationSessionId dan status sebagai petunjuk UI yang tidak tepercaya. Selalu konfirmasi keputusan akhir di backend Anda, baik dengan menangani webhook (direkomendasikan) maupun dengan mengambil ulang keputusan melalui API:
Gunakan Webhook
Untuk integrasi yang paling andal, gunakan webhook agar hasil verifikasi langsung diterima oleh backend Anda, apa pun perilaku browser pengguna.Alur Lintas Perangkat
Metode redirect secara alami mendukung verifikasi lintas perangkat:- Pengguna mengklik “Verify” di desktop
- Pengguna dialihkan ke halaman verifikasi
- Jika diperlukan, pengguna dapat memindai kode QR untuk melanjutkan di ponsel
- Setelah selesai, pengguna dialihkan ke URL callback Anda. Perangkat yang melakukan pengalihan dikendalikan oleh
callback_method(initiator,completer, atauboth)
Pemecahan Masalah
Callback Tidak Diterima
- Pastikan URL callback sudah diatur dengan benar saat membuat sesi
- Pastikan URL callback Anda dapat diakses dari internet
- Periksa bahwa URL tidak memiliki salah ketik atau masalah encoding
Status Selalu “Declined”
- Periksa pengaturan alur kerja Anda di Didit Console
- Pastikan dokumen uji yang Anda gunakan valid
- Tinjau detail sesi melalui API untuk melihat alasan penolakan yang spesifik
Perulangan Redirect
- Pastikan handler callback Anda tidak mengalihkan kembali ke verifikasi
- Periksa masalah cache pada halaman callback Anda
- Hapus cache browser lalu coba lagi
Repositori Contoh
Repositori GitHub
Lihat kode sumber dan contoh di GitHub