Getting Shopee verification codes off personal phones

Why would a team need Shopee numbers that nobody personally owns?

Picture a team building an integration with a marketplace: order sync, a returns tool, or a storefront app. QA needs a buyer account in a specific Shopee market to walk through checkout and confirm the integration behaves. Someone reaches for their own phone, and now a test account is tied to one employee's SIM in one country.

Agencies that set up shops for clients meet the same problem, as do product teams preparing a launch in a new Southeast Asian market. A virtual number for Shopee keeps those checks off private phones and lets you pick the country the test actually concerns. The marketplaces page describes how teams in this space use OTP Route.

When does Shopee ask for a phone code?

Shopee ties accounts closely to a phone number, and a one-time SMS code typically shows up at these points:

• Registration with a phone number on the buyer app or website.
• Login by code, or signing in on a device the account has not used before.
• Password reset and recovery when the password is lost.
• Sensitive changes, such as editing the phone number, email or payout details.
• Seller accounts, which go through phone verification when a shop is set up.

The exact steps differ between Shopee's country sites and change over time, so treat this as the general pattern rather than a fixed rulebook.

Which countries can receive a Shopee code, and why does it matter?

The Shopee route is listed in 197 countries, including Indonesia, Malaysia, the Philippines, Vietnam, Thailand, Singapore, Taiwan, Brazil, Mexico, Colombia, Chile, India, the United States, the United Kingdom and Australia.

Shopee operates separate storefronts per market, and each one generally expects a phone number from its own country. So choose the country that matches the account you are testing: a Malaysian storefront test wants a Malaysian number, not just any number that happens to be cheap. Matching the market also keeps your test realistic, because language, currency and onboarding steps follow the storefront.

How does the Shopee verification code API work?

Use the base URL https://otproute.com/api/v1 with a Bearer key prefixed or_live_. Look up the price for your market with GET /api/v1/prices?country=my&service=shopee, then create the activation with POST /api/v1/activations and the body {"service": "shopee", "country": "my"}. Country ids come from GET /api/v1/countries.

For delivery you have two options:

• Webhook: subscribe to activation.sms_received, plus activation.expired and activation.cancelled. Verify the X-OTPRoute-Signature header by computing HMAC-SHA256 of "<t>.<raw body>" with your endpoint secret, reject stale timestamps, and make the handler idempotent by recording each activation id once.
• Polling: call GET /api/v1/activations/{id} on an interval until the code appears or the activation ends.

The webhook-based OTP capture article shows a production-ready receiver.

Dashboard steps for sellers and operations staff

Not everyone needs the API. In the dashboard:

1. Sign up with email and a six-digit code, or with Google.
2. Top up the wallet by card or with USDT/USDC.
3. Open the OTP Gateway, choose Shopee and the country, and check the live price.
4. Order, then type the number into Shopee's phone field.
5. Read the code when it appears beside the number.

Each activation has a 20-minute window. You only pay if the code arrives; otherwise the amount returns to the wallet on its own.

Why might a Shopee code not arrive?

A few things can get in the way. Shopee may refuse virtual numbers in some markets or flows, and the automatic refund is there for that situation. Routes can also be busy at certain hours, since delivery depends on the service and the route.

What to try:

• Let the window run its full 20 minutes before giving up.
• Order again later, or try the route for another country if your test allows.
• Space out retries in automated tests; re-ordering in a tight loop rarely helps.

For a fuller troubleshooting list aimed at marketplace flows, read reducing failed OTP deliveries.

When is a Dedicated Number a better fit, and what are the ground rules?

A one-time number suits a single verification. A staging buyer account that must log in again next week, or a shared operations login that needs recovery, is better served by a Dedicated Number you keep while it renews. Those are available instantly in the United States and Canada from $1.95/month, with inbound SMS in the dashboard and on your webhook. See virtual numbers for details.

Use OTP Route only to test and operate your own legitimate accounts and products. Follow Shopee's terms, keep to one account per real person or business, and remember that OTP Route's Acceptable Use Policy applies. Shopee is a trademark of its owner, and OTP Route is not affiliated with it.

Frequently asked questions

What is the service id for Shopee in the API?

It is shopee. Combine it with a country id, for example {"service": "shopee", "country": "id"} for Indonesia.

Can I receive a Shopee OTP for a market I'm not physically in?

Yes, if that country is on the route. Order a number from the market whose storefront you are testing and read the code remotely.

Does Shopee accept every virtual number?

No. Shopee may reject some virtual numbers, which is why an activation that receives no code is refunded in full.

Which Shopee phone number should I use for a long-lived test account?

If the account must log in again later, a US or Canadian Dedicated Number you keep is the better choice than a one-time activation.

Is Shopee SMS verification for testing supported in CI?

Yes. Create activations through the API, collect codes by signed webhook or polling, and ask for a sandbox account to rehearse without spending funds.

How much does a Shopee code cost?

From $0.20 per code; the exact price depends on the country and is returned live by GET /api/v1/prices.

Service names are trademarks of their respective owners. OTP Route is not affiliated with them. Use numbers lawfully, follow each service's terms and our Acceptable Use Policy.