Panduan Memulai

Copy prompt setup 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 untuk menginstal plugin ini. Tambahkan skill Capgo ke tool AI Anda menggunakan perintah 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 suka Manual Setup, instal plugin dengan menjalankan perintah berikut dan ikuti instruksi 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();

Masalah umum

Inisialisasi sekali saja: jalankan setup saat bootstrap aplikasi.
Sinkronisasi native: jalankan bunx cap sync setelah upgrade plugin.
Sumber kebenaran: percaya src/definitions.ts pada repo GitHub.

Konfigurasi Verisoul

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

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

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

Dapatkan session ID

Setelah Verisoul mengumpulkan sinyal native yang cukup, minta session ID dan kirim 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 ada perubahan akun

Panggil reinitialize() saat konteks pengguna berubah, seperti logout lalu login dengan akun lain.

await Verisoul.reinitialize();

Sinyal sentuhan Android

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

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

Setup platform

Setup iOS mencakup catatan entitlement App Attest.
Setup Android mencakup repositori Maven Verisoul dan izinnya.

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 ini.