Panduan Memulai

Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-verisoul`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/verisoul/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Instal

Anda bisa menggunakan AI-Assisted Setup kami untuk menginstal plugin ini. Tambahkan skill Capgo ke tool AI Anda dengan command berikut:

bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Lalu gunakan prompt berikut:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-verisoul` plugin in my project.

Jika Anda lebih memilih Manual Setup, instal plugin dengan menjalankan perintah berikut dan ikuti petunjuk khusus platform di bawah ini:

bun add @capgo/capacitor-verisoul
bunx cap sync

Mulai cepat

import { Verisoul } from '@capgo/capacitor-verisoul';

await Verisoul.configure({
  environment: 'dev',
  projectId: 'project-id-123',
});

Contoh: getSessionId

import { Verisoul } from '@capgo/capacitor-verisoul';

const result = await Verisoul.getSessionId();
console.log(result);

Contoh: reinitialize

import { Verisoul } from '@capgo/capacitor-verisoul';

await Verisoul.reinitialize();

Kesalahan umum

Inisialisasi sekali saja: jalankan setup saat app bootstrap.
Sinkronisasi Native: jalankan bunx cap sync setelah upgrade plugin.
Sumber kebenaran tunggal: percayai src/definitions.ts di repo GitHub.

Konfigurasi Verisoul

Panggil configure() sekali, di awal startup aplikasi Anda. Gunakan sandbox untuk pengujian dan prod untuk traffic produksi.

import { Verisoul } from '@capgo/capacitor-verisoul';

await Verisoul.configure({
  environment: 'prod',
  projectId: 'YOUR_PROJECT_ID',
});

Dapatkan session ID

Setelah Verisoul mengumpulkan cukup sinyal native, minta session ID dan kirimkan ke backend Anda. Backend Anda harus memanggil API server-side Verisoul untuk penilaian risiko.

const { sessionId } = await Verisoul.getSessionId();

await fetch('/api/risk/verisoul', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ sessionId }),
});

Reset saat akun berubah

Panggil reinitialize() ketika konteks pengguna berubah, seperti logout lalu login sebagai akun lain.

await Verisoul.reinitialize();

Sinyal sentuhan Android

Di Android, teruskan event sentuh saat aplikasi Anda memerlukan pengumpulan pola sentuh Verisoul.

await Verisoul.recordTouchEvent({
  x: 120,
  y: 240,
  action: 'down',
});

Setup platform

Setup iOS mencakup catatan entitlement App Attest.
Setup Android menjelaskan repositori Maven Verisoul dan izin akses.

Lanjutkan dari Getting Started

Jika Anda menggunakan Panduan Memulai untuk mengintegrasikan sesi Verisoul, hubungkan dengan @capgo/capacitor-verisoul untuk ringkasan API, Setup iOS untuk catatan App Attest, Setup Android untuk setup Gradle, dan Menggunakan @capgo/capacitor-verisoul untuk tutorial plugin.