handleAddPhoneNumber()

Package: react-wallet-kit

Defined in: react-wallet-kit/src/providers/client/Types.tsx:543

Handles the add phone number flow.

This function opens a modal with the UpdatePhoneNumber component for adding and verifying the user’s phone number.
If a phone number is provided, it will immediately send an OTP request to the user and display the OTP verification modal.
Supports both manual entry and pre-filled phone numbers, as well as custom modal titles and subtitles.
Uses the addPhoneNumberContinue helper to manage the OTP flow, verification, and update logic.
After successful verification and update, the user details state is refreshed and an optional success page can be shown.
Supports customizing the duration of the success page after update.
Handles all error cases and throws a TurnkeyError with appropriate error codes.

params

object

Show params details

params.formattedPhone

string

parameter to specify the formatted phone number.

params.phoneNumber

string

parameter to specify the new phone number.

params.subTitle

string

subtitle for the modal.

params.successPageDuration

number

duration (in ms) for the success page after update (default: 0, no success page).

params.title

string

title for the modal.

A successful response returns the following fields:

returns

string

required

A promise that resolves to the userId of the user that was changed.