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
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>;
}