start_identity_verification
Start or restart identity verification (KYC). If a previous session exists that was incomplete, denied, or expired, this creates a new one. Returns a URL the user must open in their browser.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force_new | No | Force a new verification session even if one is pending (use after denial or expiry) | |
| id_number_required | No | Whether to require an ID number on the document (default: true) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | One of: already_verified, processing, redirect_required | |
| message | No | ||
| instructions | No | ||
| verified_name | No | Set when status=already_verified | |
| previous_status | No | The prior session status if this call is restarting a stale session | |
| verification_url | No | Stripe Identity URL the user opens in their browser. Present when status=redirect_required. |