인도네시아 +62 OTP 코드를 프로그래밍 방식으로 수집하기

인도네시아 OTP API 연동은 어떤 엔드포인트를 호출하나요?

모든 것은 or_live_ 접두사의 Bearer 키로 https://otproute.com/api/v1에 대해 실행됩니다. 개발자 콘솔에서 키를 만드세요. 계정당 최대 10개까지 보유할 수 있어서 CI 러너와 스테이징 서버를 쉽게 분리할 수 있습니다.

1. GET /api/v1/services와 GET /api/v1/countries를 가져와 두 목록을 캐시합니다. 인도네시아는 ID id로 나타납니다.
2. 테스트하려는 서비스의 현재 가격과 이용 가능 여부를 GET /api/v1/prices?country=id&service=<id>로 요청합니다. 재고는 하루 중 움직이므로 하드코딩하지 말고 실행마다 조회하세요.
3. POST /api/v1/activations에 {"service": "tokopedia", "country": "id"} 같은 본문을 보내 주문을 만듭니다. 활성화 ID와 +62 번호가 돌아옵니다.
4. 그 번호를 자사 앱이나 테스트 계정의 전화번호 필드에 입력하거나 주입합니다.
5. 웹훅으로 결과를 읽거나 GET /api/v1/activations/{id}를 폴링합니다. SMS 단계 전에 테스트가 실패하면 POST /api/v1/activations/{id}/cancel로 깔끔하게 중단하세요.

스위트를 시작하기 전에 GET /api/v1/balance를 빠르게 호출하면 실행이 중간이 아니라 처음에 실패하게 할 수 있습니다. 적절한 간격의 폴링은 분당 300건 상한 안에 충분히 들어갑니다. 전체 스키마는 API 문서에 있습니다.

서명된 웹훅으로 +62 코드를 처리하려면 어떻게 하나요?

폴링은 개발자 한 명에게는 충분하지만, 병렬 작업에서는 푸시 전달이 더 안정적입니다. 계정당 최대 5개의 엔드포인트를 등록하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요.

모든 요청에는 t=<unix>,v1=<hex> 형태의 X-OTPRoute-Signature 헤더가 포함됩니다. 서명 대상 문자열을 <t>.<raw body>로 재구성하고, 엔드포인트 시크릿으로 HMAC-SHA256을 계산해 v1과 상수 시간으로 비교하세요. JSON 파싱 전에 원본 바이트를 해시하고, 가로챈 페이로드가 재생되지 않도록 타임스탬프가 너무 오래된 요청은 버리세요.

이벤트는 활성화 ID를 키로 취급하고 핸들러를 멱등하게 만드세요. 재전송된 요청은 이미 저장된 코드를 그대로 발견하면 됩니다. HMAC 웹훅 보안 글에서 검사 과정을 차례로 설명합니다.

OTP Route에서 인도네시아 SMS OTP를 받을 수 있는 서비스는 무엇인가요?

인도네시아의 실시간 스냅샷에는 3,000개 이상의 서비스가 포함됩니다. 인기 경로로는 WhatsApp, Tokopedia, Shopee, Lazada, Telegram, Google(Gmail & YouTube), Facebook, Instagram, TikTok, LINE, Discord, Microsoft & Outlook, ChatGPT(OpenAI)가 있습니다.

API를 쓰지 않는 동료에게는 대시보드가 같은 일을 해 줍니다. 로그인해서 서비스를 고르고, 인도네시아를 선택하고, 표시된 가격을 확인한 뒤 주문하세요. +62 번호가 화면에 나타나고 SMS가 들어오면 그 옆에 코드가 표시됩니다. 테스트가 취소되면 같은 화면에서 취소하세요.

+62 번호는 어떻게 저장하고 정규화해야 하나요?

인도네시아는 트렁크 접두사로 0을 쓰므로, 사람들은 국내에서 휴대폰 번호를 08 뒤에 나머지 숫자를 붙여 씁니다. E.164에서는 0이 사라집니다. 현지에서 0812...로 쓰는 번호는 +62812...가 됩니다. E.164 형식을 저장하고, 사용자가 입력한 값은 공백, 대시, 앞의 0을 제거해 정규화하세요. 인도네시아 가입자 번호는 길이가 모두 같지 않으므로 유효성 판단은 관리되는 전화번호 라이브러리에 맡기세요.

인도네시아 번호로 보내는 SMS 템플릿은 인도네시아어(바하사 인도네시아)인 경우가 많지만 영어로 보내는 서비스도 있습니다. "kode"나 "code" 같은 단어를 매칭하는 대신 숫자 패턴으로 코드를 추출하면, 파서는 템플릿 언어가 무엇이든 신경 쓰지 않습니다.

제품 팀은 왜 인도네시아에서 가입 흐름을 테스트하나요?

인도네시아는 세계에서 인구가 가장 많은 나라 중 하나이며 인터넷 이용이 모바일 중심이어서, 전화번호 인증이 많은 온보딩 흐름의 맨 앞에 놓입니다. 동남아시아로 확장하는 팀은 자사의 인도네시아 가입 및 로그인 화면이 실제 +62 번호로 올바르게 동작하는지, 인도네시아어 문구가 잘리지 않고 표시되는지, 사기 방지 규칙이 정상적인 현지 사용자를 막지 않는지 확인하려 합니다.

지역 운영팀과 마켓플레이스 팀도 인도네시아 스토어프론트를 위해 관리하는 비즈니스 계정을 인증하는 데 이 경로를 사용합니다. 이를 회귀 테스트 계획에 넣는 방법은 QA 테스트 페이지에서 다룹니다.

인도네시아 코드가 끝내 나타나지 않으면 어떻게 하나요?

전달 시간은 서비스와 경로에 따라 다르므로, 실패로 판단하기 전에 활성화에 여유를 주세요. SMS가 도착하지 않을 때는 다음과 같이 하세요.

• 20분의 창이 끝날 때까지 기다리거나 취소하세요. 어느 쪽이든 전액이 자동으로 지갑으로 돌아옵니다.
• 잠시 후 다시 주문하거나, 테스트가 허용한다면 다른 서비스 경로를 사용해 보세요.
• 대상 서비스가 이 작업에서 가상 번호를 받아주는지 확인하세요. 일부는 받지 않으며, 바로 그래서 환불 규정이 있습니다.
• 빠른 루프로 재주문하지 마세요. CI 작업이 몇 초 만에 재시도를 소진하지 않도록 시도 사이에 백오프를 두세요.

더 많은 진단 아이디어는 OTP 전달 실패 줄이기에 있습니다.

전용 +62 번호가 있나요? 청구는 어떻게 되나요?

아니요. 셀프서비스 장기 인도네시아 회선은 제공되지 않습니다. 전용 번호는 월 $1.95부터 시작하는 미국·캐나다 상품입니다. 팀에 지속적인 +62 회선이 정말 필요하다면 [email protected]으로 이메일을 보내세요. 마련 가능 여부는 현지 규정에 달려 있으며 약속되지 않습니다.

OTP Gateway의 청구는 월 사용료도 선택할 요금제도 없는 하나의 선불 USD 지갑을 사용합니다. 카드 또는 USDT/USDC 스테이블코인으로 지갑을 충전하세요. 충전마다 재무 기록용 PDF 인보이스가 이메일로 발송됩니다. 개발 계정은 샌드박스 모드를 요청할 수 있으며, 자금을 쓰지 않고 엔드 투 엔드 연동 테스트를 할 수 있도록 모의 번호와 코드를 반환합니다. 요금을 확인하거나 계정을 만드세요.

자주 묻는 질문

현지 SIM 없이 앱의 인도네시아 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 해당 서비스용 +62 번호를 주문해 앱에 입력하고, 대시보드나 API에서 코드를 읽으세요.

OTP Route API에서 인도네시아의 국가 ID는 무엇인가요?

인도네시아는 id이므로 가격 조회는 GET /api/v1/prices?country=id&service=<id>가 됩니다.

인도네시아 SMS가 도착하지 않으면 요금을 내나요?

아니요. 20분의 창 동안 아무것도 오지 않거나 취소하면 청구된 전액이 자동으로 지갑에 돌아옵니다.

인도네시아 휴대폰 번호를 저장할 때 앞의 0을 유지해야 하나요?

현지 형식으로 표시할 때만 유지하세요. 저장은 E.164 형식인 +62와 0을 뺀 국내 번호로 하세요.

인도네시아 인증 문자는 영어로 오나요?

항상 그렇지는 않습니다. 많은 문자가 인도네시아어로 오므로, 주변 단어에 의존하지 말고 숫자 코드를 파싱하세요.

인도네시아 번호는 어떤 목적으로든 사용할 수 있나요?

합법적인 용도에 한합니다. 각 서비스의 약관 안에서 자사 제품과 계정을 테스트하고 운영하는 것입니다. 모든 주문에는 OTP Route 이용 정책이 적용됩니다.

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