Account Verification - Method API Docs

Mode: account_verification

Opal Account Verification is a pre-built flow for verifying a specific account. It provides a secure, compliant way to verify a single, known account (for example, a specific credit card).

What this mode does

Account Verification drives a focused verification flow for a single, known account (for example, a specific credit card). You must pass the target account_id. Account Verification will automatically be invoked when needed (for example, during card_connect), or can be used as a standalone module.

Parameters

Create a token

You can create an account verification session token using one of the supported patterns:

Existing entity: provide entity_id + mode + account_verification
Create new entity: provide entity + mode + account_verification
Resume session: provide session_id only (omit mode and account_verification)

Existing Entity

{
  "entity_id": "ent_...",
  "mode": "account_verification",
  "account_verification": { "account_id": "acc_..." }
}

Create New Entity

{
  "entity": {
    "type": "individual",
    "individual": {
      "first_name": "Kevin",
      "last_name": "Doyle",
      "phone": "+15125551234"
    }
  },
  "mode": "account_verification",
  "account_verification": { "account_id": "acc_..." }
}

Response

{
  "token": "otkn_...",
  "valid_until": "2025-06-10T22:50:53.024Z",
  "session_id": "osess_..."
}

Launch Opal

React (Web)
React Native

import { OpalProvider, useOpal } from "@methodfi/opal-react";

function Screen() {
  const { open } = useOpal({ env: "dev", onEvent: (e) => {} });
  const start = async () => {
    const { token } = await getTokenFromBackend();
    open({ token });
  };
  return <button onClick={start}>Verify account</button>;
}

import { OpalProvider, useOpal } from "@methodfi/opal-react-native";

function Screen() {
  const { open } = useOpal({ env: "dev", onEvent: (e) => {} });
  const start = async () => {
    const { token } = await getTokenFromBackend();
    open({ token });
  };
  return <Button title="Verify account" onPress={start} />;
}

​What this mode does

​Parameters

​Create a token

​Existing Entity

​Create New Entity

​Response

​Launch Opal

What this mode does

Parameters

Create a token

Existing Entity

Create New Entity

Response

Launch Opal