Skip to main content
Sends the user a one-time verification code, required once before funds can be added (the onramp verifies the phone on the user’s Agentcard identity, and the verification stays fresh for 60 days). Call this when add_funds returns phone_verification_required.

Parameters

None.

Returns

The masked destination the code was sent to (text or email) and how long it is valid, so you can tell the user where to look. If the phone is already verified and still fresh, it says so and you can go straight to add_funds. After the user reads the code back, call verify_phone. Resend only if the code never arrives, since a resend invalidates the previous code. If no phone number is on file yet, the response explains that identity verification collects it first. If delivery fails, it tells you to retry.

Example