Getting Started

Copy sebuah prompt pengaturan dengan langkah instalasi 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.

Install

Anda dapat menggunakan Setup Bantu Otomatis kami untuk menginstal plugin. Tambahkan Capgo kemampuan ke alat AI Anda menggunakan perintah berikut:

npx 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 Setup Manual, instal plugin dengan menjalankan perintah-perintah berikut dan ikuti instruksi spesifik platform di bawah ini:

npm install @capgo/capacitor-verisoul
npx cap sync

Konfigurasi Verisoul

Panggil configure() sekali, pada awal startup aplikasi Anda. Gunakan sandbox untuk tes dan prod untuk lalu lintas produksi.

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

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

Dapatkan ID sesi

Setelah Verisoul telah mengumpulkan cukup banyak signal native, minta ID sesi dan kirimkannya ke backend Anda. Backend Anda harus memanggil server sisi Verisoul’s API 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 pada perubahan akun

Panggil reinitialize() When konteks pengguna berubah, seperti keluar setelah login sebagai akun lain.

await Verisoul.reinitialize();

Signal sentuh Android

Pada Android, kirimkan event sentuh ke depan ketika aplikasi Anda membutuhkan pengumpulan pola sentuh Verisoul.

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

Pengaturan Platform

Pengaturan iOS Mengcover catatan hak akses App Attest.
Pengaturan Android Mengcover repositori Maven Verisoul dan izin.

Teruskan dari Getting Started

Jika Anda menggunakan Getting Started untuk mengintegrasikan Verisoul sessions, hubungkannya 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.