SMS & Phone Services

Connect a phone-verification provider, select it in a supported task, and troubleshoot credentials, missing numbers and missing codes.

Settings → SMS & Phone connects third-party providers that supply phone numbers or receive verification codes for supported tasks. A one-time password (OTP) is a temporary code a site sends to verify an action such as creating an account or logging in.

This section is optional. You do not need to configure every provider, and tasks that do not require phone verification may not need it at all.

Set up a provider

1. Check the retailer guide and the SMS Input options in the task mode you plan to use. Choose a provider offered for that workflow; appearing in Settings does not mean a provider works with every retailer or mode.
2. Create or sign in to the provider’s account. Check its supported site, country, availability and charges before adding any required balance.
3. Copy the API key or API credentials from that provider’s dashboard. An API key lets Stellar connect to the service; it is not usually your website login password.
4. Open Settings → SMS & Phone in Stellar and paste the credentials into that provider’s matching field. Use the formats below and remove accidental leading or trailing spaces.
5. If that provider has a Get Balance button, use it and review the response. Then complete the task setup described below. Entering credentials in Settings alone does not select the provider for a task.

What to enter for each provider

• TextVerified: enter email:apiKey, with one colon between your email and API key. This is not your account password.
• SMS Man, 5sim, Hero SMS, SMSPool, Wealth SMS, and Text Chest: enter the API key from that provider.
• VOIP.MS: enter your account email in VOIP.MS Email and your API password in VOIP.MS API Password. The API password is separate from your normal website password.

Use the provider links beside the fields to reach the correct service. Keep keys and credentials private, and avoid extra spaces before or after them.

What Get Balance confirms

When Get Balance returns a balance successfully, Stellar was able to contact that provider and retrieve the balance using the entered credentials at that moment. A returned balance of 0 is still a response, but you may need credit before using the service.

Get Balance is not a complete verification test. It does not confirm that a usable phone number is available, that a retailer will accept the number, that an SMS code will arrive, or that your task has the correct provider selected. It also does not guarantee checkout success.

Not every provider has a Get Balance button. If yours does not, use its dashboard to review the account and balance, then follow the retailer’s task setup instructions.

Use the connected provider in a task

1. Open Tasks and select the retailer’s task group. Create a task or edit the intended existing task.
2. Choose the mode recommended by the retailer guide. Available fields depend on the retailer and mode.
3. Find SMS Input, when offered, and select the same provider you connected in Settings. Complete any related fields shown by that mode according to the retailer guide.
4. Review the remaining task settings, then select Create for a new task or Save for an edited task. If editing multiple tasks, check the affected task count first.
5. Start only when the setup and retailer instructions are ready. Watch the task status to see whether it is requesting a number, waiting for a code, or reporting an error. Provider usage may incur charges.

Example: if the task’s SMS Input offers SMSPool and you choose it, enter your SMSPool API key in Settings → SMS & Phone, then select SMSPool in that task. A key saved under 5sim will not configure the SMSPool connection. This example applies only where the task actually offers SMSPool.

If SMS Input is absent, check the mode and retailer guide. Do not assume the task needs phone verification or will use a provider automatically just because its credentials are saved.

Phone verification is different from notifications

SMS & Phone services help supported tasks complete phone verification. They do not configure checkout alerts to your personal phone. Discord webhooks send messages to Discord channels, while the Stellar Mobile Companion App has separate phone notification switches. Pushover is another optional notification service, configured under Settings → Discord.

For Discord messages, see Discord Notifications

For phone push alerts, see the Mobile Companion App guide

If verification fails

Start with the exact task status or error. Identify whether the problem is connecting to the provider, obtaining a number, or receiving a code; each needs a different check.

Credentials are rejected or Get Balance fails

• Confirm the credentials are in the field for the correct provider. A key from one provider will not work in another provider’s field.
• For TextVerified, use email:apiKey. For VOIP.MS, use the account email and API password in their separate fields. Do not substitute a normal website password.
• Compare the complete key with the provider dashboard. Check for missing characters, extra spaces, or a key that has been replaced or revoked.
• Read the response before assuming the key is wrong. A connection error or provider outage is different from an authentication error. Check your internet connection and the provider’s service status.
• If the provider requires additional API access settings, follow its current instructions. Keep credentials private when asking for help.

The task does not receive a phone number

• Check that the task’s SMS Input uses the provider you configured. Confirm the retailer and mode support that choice.
• Check the provider account’s balance and the cost of the requested service. A successful balance check can still show insufficient credit.
• Check whether the provider has numbers available for the required retailer/service and country. A valid API key does not guarantee stock.
• Review any phone, country or service choices offered by that task and compare them with the retailer guide. Do not change them at random or assume a number for one service will work for another.

A number was received, but the code is missing

• Read the task status to confirm it is waiting for an SMS code rather than an email code, captcha or another verification step.
• Check the provider dashboard for that number or request, including its status and any received message. Delivery may be delayed, or the retailer may not have sent a usable code.
• If a code appears at the provider but the task does not receive it, record that distinction and the exact task error for support. Do not share the code publicly.
• If the request expires or the task times out, follow the retailer guide and provider instructions before retrying. Repeated requests may incur charges or create additional verification attempts.

What to send support

Include the retailer, task mode, selected SMS provider, exact status/error, and whether the problem is a missing number or missing code. Say whether Get Balance succeeds, if available, and whether the provider dashboard shows a number or message. Hide API keys, passwords, phone numbers and verification codes in screenshots.

A saved API key does not guarantee a provider will have a usable number available. Phone-number availability and delivery times are controlled by the provider and the retailer.

---