Identity verification
Identity verification is used to confirm the identity of the account representative.
This step typically occurs after your platform has submitted company details, created the representative person, and provided any required onboarding information.
When to start identity verification
Start identity verification after:
- the connected account has been created
- company information has been submitted
- the representative person has been created
- required onboarding data has been provided
Identity verification is typically performed for the representative of the connected account.
Create a verification session
Create a verification session to initiate the identity verification flow.
POST /v1/identity/verification_sessions
This endpoint starts the identity verification process for the selected person.
Present the verification flow
After creating a verification session, your platform is responsible for presenting the identity verification flow to the representative.
This can be done by:
- Redirecting the user to the verification URL
- Embedding the verification flow in your application
- Sending the verification link via email or another communication channel
Paypercut does not contact the end user directly. Your platform is responsible for delivering the verification experience to the representative.
Platform responsibilities
When using identity verification, your platform must:
- Deliver the verification session to the correct user (typically the representative)
- Ensure the user understands they are completing identity verification
- Handle cases where the flow is interrupted or not completed
- Allow the user to retry or resume verification if needed
Recommended flow
Submit the connected account’s business information and create the representative person.
Create a verification session for the representative.
Redirect, embed, or send the verification link to the representative.
Track the outcome and update onboarding state accordingly.
Relationship to onboarding
Identity verification complements the broader onboarding and verification process.
It works together with:
- account updates
- persons
- document uploads
- requirements
- webhooks
Identity verification does not replace requirements. It is one mechanism used to satisfy representative verification requirements.
Best practices
- Start identity verification only after the representative person exists
- Ensure the correct person is selected before initiating verification
- Design the flow so it can be resumed if interrupted
- Re-fetch the account after verification to confirm updated state
