v1

latestOpenAPI 3.1.02026-07-26261466.6 KB

Wallet funding

Start phone verification

Sends the user a one-time code. Relay it through your UI — the user reads it back to you, same pattern as the connect code. A verification stays fresh for 60 days. Provide phone_number only when the user has no phone on file (US numbers only).

post/api/v2/wallet/phone/start

Request body

user_idstring required

phone_numberstring

E.164 US number (+1XXXXXXXXXX). Used only when the user has no phone on file.

Response

sent (code on its way) or already_verified (nothing to do — proceed to fund).

object'phone_verification'

status'sent' | 'already_verified' | 'verified'

channel'sms' | 'email'

Where the code was sent (status sent only).

phonestring

The masked destination number (status sent only).

expires_in_secondsinteger

How long the code stays valid (status sent only).