팀에 왜 아무도 개인적으로 소유하지 않는 Shopee 번호가 필요할까요?
마켓플레이스와의 연동을 만드는 팀을 떠올려 보세요. 주문 동기화, 반품 도구 또는 스토어프런트 앱입니다. QA는 결제 과정을 따라가 연동이 제대로 동작하는지 확인하기 위해 특정 Shopee 시장의 구매자 계정이 필요합니다. 누군가 자신의 휴대폰을 꺼내 들면, 테스트 계정이 한 국가에 있는 직원 한 명의 SIM에 묶이게 됩니다.
고객을 위해 상점을 설정하는 에이전시도 같은 문제를 겪고, 새로운 동남아시아 시장 출시를 준비하는 제품팀도 마찬가지입니다. Shopee용 가상 번호는 이런 확인을 개인 휴대폰에서 분리하고 테스트가 실제로 다루는 국가를 고르게 해 줍니다. 이 분야의 팀이 OTP Route를 어떻게 쓰는지는 마켓플레이스 페이지에서 설명합니다.
Shopee는 언제 전화 코드를 요구하나요?
Shopee는 계정을 전화번호와 밀접하게 연결하며, 일회용 SMS 코드는 보통 다음과 같은 시점에 나타납니다.
- 구매자 앱이나 웹사이트에서 전화번호로 가입할 때
- 코드로 로그인하거나, 계정이 사용한 적 없는 기기에서 로그인할 때
- 비밀번호를 분실했을 때의 비밀번호 재설정 및 복구
- 전화번호, 이메일, 정산 정보 수정 같은 민감한 변경
- 상점을 설정할 때 전화 인증을 거치는 판매자 계정
정확한 단계는 Shopee의 국가별 사이트마다 다르고 시간에 따라 바뀌므로, 이것을 고정된 규칙이 아니라 일반적인 패턴으로 보세요.
어느 국가에서 Shopee 코드를 받을 수 있고, 왜 중요한가요?
Shopee 경로는 197개국에 등록되어 있으며, 인도네시아, 말레이시아, 필리핀, 베트남, 태국, 싱가포르, 대만, 브라질, 멕시코, 콜롬비아, 칠레, 인도, 미국, 영국, 호주가 포함됩니다.
Shopee는 시장마다 별도의 스토어프런트를 운영하며, 각 스토어프런트는 대체로 자국의 전화번호를 기대합니다. 따라서 테스트하는 계정에 맞는 국가를 고르세요. 말레이시아 스토어프런트 테스트에는 값이 싸다고 아무 번호나 쓰지 말고 말레이시아 번호가 필요합니다. 시장을 맞추면 언어, 통화, 온보딩 단계가 스토어프런트를 따르므로 테스트도 현실적으로 유지됩니다.
Shopee 인증 코드 API는 어떻게 동작하나요?
기본 URL https://otproute.com/api/v1과 접두사 or_live_의 Bearer 키를 사용하세요. GET /api/v1/prices?country=my&service=shopee로 해당 시장의 가격을 확인한 다음, POST /api/v1/activations에 본문 {"service": "shopee", "country": "my"}를 보내 활성화를 생성합니다. 국가 ID는 GET /api/v1/countries에서 가져옵니다.
전달 방법은 두 가지입니다.
- 웹훅:
activation.sms_received와 함께activation.expired,activation.cancelled를 구독합니다. 엔드포인트 시크릿으로"<t>.<raw body>"의 HMAC-SHA256을 계산해X-OTPRoute-Signature헤더를 검증하고, 오래된 타임스탬프는 거부하며, 각 활성화 ID를 한 번만 기록해 핸들러를 멱등하게 만드세요. - 폴링: 코드가 나타나거나 활성화가 끝날 때까지 간격을 두고
GET /api/v1/activations/{id}를 호출합니다.
웹훅 기반 OTP 수집 글에 운영 환경에서 쓸 수 있는 수신기가 나와 있습니다.
판매자와 운영 담당자를 위한 대시보드 단계
모두에게 API가 필요한 것은 아닙니다. 대시보드에서는 다음과 같이 합니다.
- 이메일과 6자리 코드 또는 Google로 가입합니다.
- 카드 또는 USDT/USDC로 지갑을 충전합니다.
- OTP Gateway를 열어 Shopee와 국가를 고르고 실시간 가격을 확인합니다.
- 주문한 뒤 Shopee의 전화번호 입력란에 번호를 입력합니다.
- 번호 옆에 코드가 나타나면 읽습니다.
각 활성화에는 20분의 제한 시간이 있습니다. 코드가 도착한 경우에만 요금을 내며, 그렇지 않으면 금액이 저절로 지갑으로 돌아옵니다.
Shopee 코드가 도착하지 않을 수 있는 이유는 무엇인가요?
몇 가지가 방해가 될 수 있습니다. Shopee가 일부 시장이나 흐름에서 가상 번호를 거부할 수 있으며, 자동 환불은 그런 상황을 위한 것입니다. 전송은 서비스와 경로에 따라 달라지므로 특정 시간대에 경로가 혼잡할 수도 있습니다.
시도해 볼 것들입니다.
- 포기하기 전에 20분의 제한 시간을 끝까지 기다립니다.
- 나중에 다시 주문하거나, 테스트가 허용한다면 다른 국가의 경로를 시도합니다.
- 자동화된 테스트에서는 재시도 간격을 두세요. 짧은 반복문으로 다시 주문하는 것은 거의 도움이 되지 않습니다.
마켓플레이스 흐름을 위한 더 자세한 문제 해결 목록은 OTP 전송 실패 줄이기에서 읽을 수 있습니다.
전용 번호는 언제 더 적합하고, 기본 규칙은 무엇인가요?
일회용 번호는 한 번의 인증에 적합합니다. 다음 주에 다시 로그인해야 하는 스테이징 구매자 계정이나 복구가 필요한 공유 운영 로그인에는 갱신되는 동안 계속 보유하는 전용 번호가 더 알맞습니다. 전용 번호는 미국과 캐나다에서 즉시 이용할 수 있으며 월 $1.95부터이고, 수신 SMS는 대시보드와 웹훅으로 받습니다. 자세한 내용은 가상 번호를 참고하세요.
OTP Route는 정당한 자사 계정과 제품을 테스트하고 운영하는 데만 쓰세요. Shopee의 약관을 따르고, 실제 개인 또는 사업체당 계정 하나만 유지하며, OTP Route의 허용 가능한 사용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요. Shopee는 해당 소유자의 상표이며 OTP Route는 Shopee와 제휴 관계가 없습니다.
자주 묻는 질문
API에서 Shopee의 서비스 ID는 무엇인가요?
shopee입니다. 국가 ID와 조합해 쓰며, 예를 들어 인도네시아는 {"service": "shopee", "country": "id"}입니다.
제가 물리적으로 있지 않은 시장의 Shopee OTP도 받을 수 있나요?
네, 그 국가가 경로에 있다면 가능합니다. 테스트하는 스토어프런트의 시장에서 번호를 주문해 원격으로 코드를 읽으세요.
Shopee는 모든 가상 번호를 받아 주나요?
아니요. Shopee가 일부 가상 번호를 거부할 수 있으며, 그래서 코드를 받지 못한 활성화는 전액 환불됩니다.
오래 유지할 테스트 계정에는 어떤 Shopee 전화번호를 써야 하나요?
계정이 나중에 다시 로그인해야 한다면 일회용 활성화보다 계속 보유하는 미국 또는 캐나다 전용 번호가 더 좋은 선택입니다.
CI에서 테스트용 Shopee SMS 인증이 지원되나요?
네. API로 활성화를 생성하고, 서명된 웹훅이나 폴링으로 코드를 수집하며, 샌드박스 계정을 요청하면 자금을 쓰지 않고 예행연습을 할 수 있습니다.
Shopee 코드는 비용이 얼마인가요?
코드당 $0.20부터이며, 정확한 가격은 국가에 따라 다르고 GET /api/v1/prices가 실시간으로 반환합니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.