Use the IllyVoIP app’s phone-number order wizard to choose an available number, review its requirements and submit the order. Then follow that order’s saved status. An accepted order can still be awaiting provisioning or verification; it is not automatically an active incoming line.
These steps cover the Android app controls in version 1.0.46, build 272. Use your own account and the permissions assigned to it. Other platforms or releases can have different controls.
1. Choose the destination and available number
- Open Phone Numbers and the order action available to your account.
- Choose the destination and number type, then the offered group or region where required. Availability depends on the current catalogue and your account.
- Review the available numbers or quantity choices shown for that selection. Choose only the number or numbers you intend to order.
- Continue through the wizard. If the selected inventory is no longer orderable, refresh the available choices instead of repeatedly submitting a stale selection.
A free-number offer, when explicitly available, is a separate offer with its own selection and renewal conditions. Do not assume that a standard order is free or that an offer removes recurring charges after its stated period.
2. Complete the requirements shown for this selection
- Read Destination requirements and the requested regulatory details.
- Provide the address, identity details and documents actually required for this number. If an accepted ZIP and city pair is offered, choose an accepted pair rather than typing an unrelated combination.
- Use the requested document type and check the selected files before continuing. Upload identity information only through the authorized order workflow.
- If the wizard requires account verification or requests a correction, follow that step and return to review the order again.
Requirements vary by destination and number product. Do not copy a document checklist from another country or an earlier order. Some verification is collected during review and some follows the order; the current wizard tells you which applies.
3. Review the current quote and submit
- Wait for the confirmation step to load its current quote. Do not submit while pricing or eligibility is unavailable.
- Check the selected numbers, quantity, setup and recurring charges, and any renewal consent required by an offer.
- If a quote changes, read the replacement quote before confirming. An older displayed price is not authority to place a new order on different terms.
- Submit once and wait for the result. Keep the order reference returned by the app.
The app saves an operation identity for an order attempt so an identical retry can be reconciled. This is not a promise that every wizard field or uploaded file will be restored after reinstalling the app. Avoid clearing app data or changing the order selection while an earlier submission has an uncertain result.
4. Follow the saved order
- Open the phone-number orders view and find the original order. Check pending, active, cancelled or rejected state as applicable.
- Read any regulatory status or requested action separately from the order’s overall state.
- For required corrections, use the existing order’s offered document or regulation workflow. Do not purchase another number to fix the first order’s paperwork.
- Once active, configure or confirm its incoming destination and test the intended receiving path separately.
Recover after a timeout or interruption
First inspect the existing orders for the original selection and time. If an order exists, continue with it. If the app reports a changed quote or operation conflict, reread the current quote and error before any retry. Do not assume that a missing response means no order was placed or no account charge occurred.
When the result remains unclear, retain the selected destination, approximate submission time and any order reference for Support. Do not start another purchase or erase the local app state simply to clear an error. The number-order API, regulatory correction and cancellation guides below explain the corresponding account workflows; cancellation is a separate deliberate action.
Related guides
- How to order a DID Number and start making calls
- Find, quote and order a phone number by API
- Submit and correct phone-number order documents through the API
- Cancel a phone-number order or stop renewal through the IllyVoIP API
- Set up the IllyVoIP mobile and Windows apps
Reviewed 12 October 2026 against the current IllyVoIP controls, implementation and applicable references. Available options depend on account permissions and service state.