자사 테스트·운영 계정을 위해 라우팅된 번호로 Tokopedia OTP 받기

Tokopedia는 어디에서 전화번호를 요구하나요?

Tokopedia는 인도네시아 최대 규모의 온라인 마켓플레이스 중 하나이며, 대부분의 인도네시아 커머스 앱처럼 전화번호를 계정의 핵심 요소로 다룹니다. Tokopedia 전화번호는 보통 가입할 때 요청되고, 새 기기에서 로그인할 때의 일회용 코드에 쓰이며, 정산 정보 수정이나 번호 자체를 바꾸는 것 같은 민감한 변경 전에 다시 확인됩니다. 판매자 계정도 비슷한 확인 단계를 거칩니다.

앱은 코드를 보낼 채널을 둘 이상 제공할 수 있습니다. OTP Route가 수신하는 것은 SMS 경로이므로 앱이 물으면 SMS를 고르세요. 메시지는 대개 인도네시아어로 도착합니다.

라우팅된 번호로 Tokopedia OTP를 받는 정당한 이유로는 직접 만드는 판매자 도구나 스토어프런트 연동의 QA, 고객을 대신해 판매자 계정을 운영하는 에이전시, 공유 상점 로그인을 직원의 개인 SIM에서 분리하려는 운영팀이 있습니다. 이런 구성은 마켓플레이스 솔루션 페이지에서 다룹니다.

Tokopedia 번호는 어느 국가의 것이어야 하나요?

실시간 현황에서 Tokopedia는 197개국에 등록되어 있습니다. 번호를 계정의 실제 시장과 맞추세요. 인도네시아(+62) 번호는 일반적인 인도네시아 판매자 또는 구매자 계정에 맞고, 다른 나라의 번호는 자사 제품이 국제 전화번호 입력을 어떻게 처리하는지 확인하는 데 유용합니다.

목록에 있는 다른 국가로는 말레이시아, 싱가포르, 브루나이, 필리핀, 태국, 베트남, 인도, 호주, 일본, 대한민국, 홍콩, 대만, 영국, 네덜란드, 미국이 있습니다. 테스트 케이스는 기대하는 국가를 명시해야, 실패가 맞지 않는 경로가 아니라 흐름을 가리키게 됩니다.

Tokopedia 인증 코드 API 흐름은 어떻게 진행되나요?

접두사 or_live_의 Bearer 키로 https://otproute.com/api/v1에 인증하세요. 서비스 ID는 tokopedia이고, 인도네시아의 국가 ID는 id입니다.

1. GET /api/v1/prices?country=id&service=tokopedia로 실시간 가격과 가용 여부를 확인합니다.
2. POST /api/v1/activations에 본문 {"service": "tokopedia", "country": "id"}를 보내 주문합니다.
3. 테스트 중인 가입 또는 로그인 화면에 반환된 번호를 입력하고 SMS로 코드를 요청합니다.
4. 웹훅에서 결과를 읽거나, 코드가 나타날 때까지 GET /api/v1/activations/{id}를 폴링합니다.
5. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel을 호출해 자금이 즉시 돌아오게 합니다.

계정당 분당 300건이라는 한도는 폴링에 충분합니다. 전체 요청 및 응답 형식은 API 문서에 있습니다.

Tokopedia 웹훅 핸들러는 어떻게 작성해야 하나요?

5개의 웹훅 엔드포인트 중 하나를 Tokopedia 주문의 activation.sms_received, activation.expired, activation.cancelled를 수신하는 경로에 연결하세요. 각 전달에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프는 거부하세요.

재시도된 전달이 같은 테스트를 두 번 완료하지 않도록 활성화 ID를 기준으로 핸들러를 멱등하게 만드세요. 엔드포인트를 공개하고 싶지 않다면 스크립트 하나에는 폴링도 똑같이 잘 동작합니다. 웹훅 캡처 가이드에 실제 설계 예가 있습니다.

대시보드로 코드 없이 Tokopedia 코드를 처리할 수 있나요?

네. OTP Gateway를 열어 Tokopedia를 고르고 국가를 선택한 다음 화면의 가격을 확인하세요. 번호를 Tokopedia 앱에 복사하고 채널로 SMS를 선택하면, 코드가 수신되었을 때 활성화 옆에 나타납니다. 판매자 운영 리더가 이렇게 하는 동안 개발자는 같은 지갑으로 API를 쓸 수 있습니다.

Tokopedia OTP가 도착하지 않을 수 있는 이유는 무엇인가요?

코드를 막는 요인은 여러 가지입니다. 앱이 일부 흐름에서 가상 번호를 거부하거나, 같은 번호로의 반복 요청을 제한하거나, 코드가 SMS가 아닌 다른 채널로 갔을 수 있습니다. 경로도 하루 중에 달라집니다.

각 활성화는 20분 동안 유지되며, 코드가 도착했을 때만 요금을 냅니다. 아무것도 오지 않으면 금액이 자동으로 지갑에 돌아옵니다. 제한 시간이 끝나기를 기다리고, 나중에 다시 시도하거나 계정에 맞는 다른 국가 경로로 시도하며, 짧은 반복문으로 다시 주문하지 마세요. 전송 실패 가이드에 더 많은 점검 항목이 있습니다.

Tokopedia 상점 계정은 대신 전용 번호에 두어야 할까요?

일회용 활성화는 새 가입 테스트에 알맞습니다. 다음 달에 다시 로그인해야 하는 상점 계정에는 직접 관리하는 번호가 필요하며, 그렇지 않으면 이후 로그인 코드가 갈 곳이 없을 수 있습니다. 전용 번호는 미국과 캐나다에서 그런 경우를 다루며 월 $1.95부터이고, 수신 SMS는 대시보드에 표시되고 number.sms_received 웹훅으로 전달됩니다. 미국 또는 캐나다 번호가 Tokopedia 계정에 맞는지는 계정 자체에 달려 있으므로, 의존하기 전에 확인하세요.

책임 있는 Tokopedia 테스트의 규칙은 무엇인가요?

Tokopedia의 약관을 따르고, 실제 개인 또는 사업체당 계정 하나만 유지하며, OTP Route는 정당한 자사 제품과 계정을 테스트하고 운영하는 데만 쓰세요. 서비스 이름은 해당 소유자의 상표이며 OTP Route는 Tokopedia와 제휴 관계가 없습니다. 모든 주문에 OTP Route의 허용 가능한 사용 정책(Acceptable Use Policy)이 적용됩니다.

결제는 카드, USDT 또는 USDC로 충전하는 선불 USD 지갑으로 이루어지며, 충전할 때마다 PDF 인보이스가 제공되고 월 요금은 없습니다. 개발자 계정은 시뮬레이션된 종단 간 테스트를 위해 샌드박스 모드를 요청할 수 있습니다.

자주 묻는 질문

팀원의 휴대폰 없이 판매자 도구의 Tokopedia 로그인을 테스트할 수 있나요?

네. OTP Gateway에서 Tokopedia 활성화를 주문하고 대시보드나 API에서 코드를 읽으세요.

API에서 Tokopedia의 서비스 ID는 무엇인가요?

tokopedia입니다. 인도네시아는 id처럼 국가 ID와 함께 쓰세요.

Tokopedia는 모든 가상 번호를 받아 주나요?

아니요. 일부 흐름은 가상 번호를 거부할 수 있으며, 그래서 코드가 오지 않은 활성화는 전액 환불됩니다.

Tokopedia 전화번호에는 어느 국가가 가장 좋은가요?

대부분의 계정이 운영되는 곳이므로 보통은 인도네시아이지만, 계정과 테스트 케이스에 맞는 국가를 고르세요.

Tokopedia가 OTP를 다른 채널로 보내면 요금을 내나요?

번호로 SMS가 도착하지 않았다면 내지 않습니다. 20분의 제한 시간이 빈 채로 끝나면 전액이 지갑으로 돌아옵니다.

중복된 웹훅 전달이 테스트를 깨뜨리지 않게 하려면 어떻게 하나요?

요청마다 서명 헤더를 검증한 다음, 처리한 활성화 ID를 저장해 두고 반복은 무시하세요.

Tokopedia 상점 계정을 위해 번호를 장기간 보유할 수 있나요?

전용 번호는 대시보드에서 미국과 캐나다용으로 제공되며, 다른 국가에는 셀프서비스 장기 회선이 없습니다.

서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.