Langsung ke konten utama
Metode Redirect mengalihkan pengguna ke halaman verifikasi yang di-hosting oleh Didit, lalu mengembalikan mereka ke aplikasi Anda melalui URL callback.

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 bernama url. Teruskan nilai tersebut ke browser.

Langkah 2: Alihkan Pengguna (Frontend)

HTML:
React:
Vue:

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:
Saat menggunakan tab baru, gabungkan dengan webhook untuk mengetahui kapan verifikasi selesai.

Praktik Keamanan Terbaik

Verifikasi callback di sisi server

Perlakukan parameter query verificationSessionId 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:
  1. Pengguna mengklik “Verify” di desktop
  2. Pengguna dialihkan ke halaman verifikasi
  3. Jika diperlukan, pengguna dapat memindai kode QR untuk melanjutkan di ponsel
  4. Setelah selesai, pengguna dialihkan ke URL callback Anda. Perangkat yang melakukan pengalihan dikendalikan oleh callback_method (initiator, completer, atau both)

Pemecahan Masalah

Callback Tidak Diterima

  1. Pastikan URL callback sudah diatur dengan benar saat membuat sesi
  2. Pastikan URL callback Anda dapat diakses dari internet
  3. Periksa bahwa URL tidak memiliki salah ketik atau masalah encoding

Status Selalu “Declined”

  1. Periksa pengaturan alur kerja Anda di Didit Console
  2. Pastikan dokumen uji yang Anda gunakan valid
  3. Tinjau detail sesi melalui API untuk melihat alasan penolakan yang spesifik

Perulangan Redirect

  1. Pastikan handler callback Anda tidak mengalihkan kembali ke verifikasi
  2. Periksa masalah cache pada halaman callback Anda
  3. Hapus cache browser lalu coba lagi

Repositori Contoh

Repositori GitHub

Lihat kode sumber dan contoh di GitHub
Terakhir diubah pada 7 November 2026