API로 인도(+91) 인증 코드 받기

인도 OTP API 호출 순서는 어떻게 되나요?

전체 흐름은 https://otproute.com/api/v1에 대한 몇 번의 요청이며, or_live_로 시작하는 Bearer 키로 인증합니다. 키는 개발자 콘솔에서 계정당 최대 10개까지 발급되므로 환경마다 별도의 키를 쓸 수 있습니다.

1. GET /api/v1/countries를 한 번 호출해 캐시합니다. 인도의 국가 ID는 in입니다.
2. 테스트할 서비스에 대해 GET /api/v1/prices?country=in&service=<id>를 호출합니다. 실시간 가격과 이용 가능 여부를 반환하므로 실행할 때마다 읽으세요.
3. POST /api/v1/activations와 {"service": "telegram", "country": "in"} 같은 JSON 본문으로 주문합니다. 응답으로 활성화 ID와 +91 번호가 돌아옵니다.
4. 그 번호를 자사 앱의 가입 또는 로그인 화면에 입력합니다.
5. 웹훅이나 GET /api/v1/activations/{id} 폴링으로 코드를 수집합니다. 테스트가 일찍 끝나면 POST /api/v1/activations/{id}/cancel을 호출하세요.

스위트를 시작할 때 GET /api/v1/balance를 확인해 실행을 빨리 실패시킬 수 있습니다. API는 분당 300건을 허용하므로 몇 초마다 폴링하기에 충분합니다. 요청과 응답의 자세한 내용은 API 문서에 있습니다.

+91 코드용 웹훅 핸들러는 어떻게 만들어야 하나요?

작업이 병렬로 실행되면 서명된 웹훅이 폴링보다 확장성이 좋습니다. 개발자 콘솔에 엔드포인트를 등록하고(계정당 최대 5개) activation.sms_received, activation.expired, activation.cancelled를 수신하세요.

각 전달에는 t=<unix>,v1=<hex> 형태의 X-OTPRoute-Signature 헤더가 포함됩니다. 검증하려면 해당 엔드포인트의 시크릿으로 <t>.<raw body> 문자열의 HMAC-SHA256을 계산해 v1과 상수 시간으로 비교합니다. 흔히 놓치는 점이 두 가지 있습니다.

• 다시 직렬화한 JSON 객체가 아니라 원본 요청 바이트를 해시하세요. 키 순서와 공백이 다이제스트를 바꿉니다.
• 가로챈 요청이 재생되지 않도록 몇 분 이상 지난 타임스탬프는 거부하세요.

중복 전달이 아무 일도 일으키지 않도록 쓰기 작업은 활성화 ID를 기준으로 하고, 느린 작업을 하기 전에 2xx로 먼저 응답하세요. HMAC로 OTP 웹훅 보호하기 글이 비교 단계를 한 줄씩 설명합니다.

어떤 서비스가 인도 번호로 코드를 보낼 수 있나요?

인도 경로에는 현재 2,300개 이상의 서비스가 나열되어 있습니다. 실시간 스냅샷의 인기 항목으로는 WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, X(Twitter), ChatGPT(OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Discord, Uber, Snapchat이 있습니다.

이용 가능 여부는 하루 중 바뀌기 때문에 API가 실시간으로 보고합니다. 테스트 매트릭스가 특정 서비스에 의존한다면 실행 전에 in에 대한 가격을 조회하고, 그 경로가 닫혀 있으면 깔끔하게 건너뛰세요. 이 경로는 자사 제품과 계정에만 사용하고, 각 서비스의 약관을 따르며, OTP Route의 이용 정책이 적용된다는 점을 기억하세요.

비개발자도 대시보드에서 인도 인증 번호를 주문할 수 있나요?

네. 운영 직원과 에이전시 계정 관리자는 API를 건너뛸 수 있습니다.

1. 이메일과 6자리 이메일 코드 또는 Google 로그인으로 계정을 만들고 TOTP 2단계 인증을 켭니다.
2. 지갑을 충전합니다.
3. 인도와 서비스를 선택하고 화면의 가격을 확인한 뒤 주문합니다.
4. 설정 중인 앱에 +91 번호를 입력하면, SMS가 도착한 뒤 활성화 페이지에 코드가 나타납니다.

대시보드와 API는 하나의 창, 하나의 환불 규정, 하나의 지갑을 공유합니다.

20분 안에 코드가 오지 않으면 어떻게 해야 하나요?

모든 활성화는 20분 동안 열려 있습니다. SMS가 도착한 경우에만 요금을 내며, 창이 빈 채로 닫히거나 먼저 취소하면 전액이 자동으로 지갑으로 돌아가고 웹훅은 activation.expired 또는 activation.cancelled를 받습니다.

코드가 없다면 다음을 확인하세요.

• 반응하기 전에 창이 끝날 때까지 기다리세요. 서비스가 평소보다 느리게 보내는 것일 수 있습니다.
• 서비스가 가상 번호를 받아주는지 확인하세요. 일부 플랫폼은 거부하며, 이는 전달 오류가 아니라 그쪽의 정책입니다.
• 나중에 다시 시도하거나 다른 서비스 경로로 테스트하세요.
• 빠른 루프로 재주문하지 마세요. 번호를 거부하는 경로에 노력을 쓰지 않도록 시도 사이에 백오프를 두세요.

재시도 전략에 대한 더 자세한 설명은 OTP 전달 실패 줄이기에 있습니다.

인도 전화번호는 어떻게 저장하고 정규화해야 하나요?

인도 휴대폰 번호는 10자리이고 실제로는 6, 7, 8, 9로 시작합니다. 인도 안에서는 앞에 트렁크 0을 붙이거나 5자리씩 공백으로 나누어 쓰는 경우가 많습니다. 국제 형식에서는 그 0을 빼고 국가 코드를 붙여 +91과 10자리가 됩니다.

E.164 형식만 저장하세요. +91과 10자리이며 공백, 하이픈, 0은 없습니다. 입력은 가장자리에서 형식 문자, 앞의 0, 또는 플러스 없이 입력된 91을 제거해 정규화하세요. 그러면 형식만 다른 중복 사용자를 막을 수 있습니다.

인도의 인증 SMS는 대부분 영어로 도착하며 전화번호가 아니라 영숫자 발신자 헤더로 옵니다. 일부 앱은 힌디어나 다른 지역 언어로 보내기도 하므로, 코드 파서를 비라틴 문자에 대해서도 테스트하세요.

제품 팀에 테스트용 +91 번호가 필요한 이유는 무엇인가요?

인도는 소비자 앱, 핀테크 온보딩, 마켓플레이스의 대표적인 출시 시장이며, 사용자는 가입 시 SMS 단계를 기대합니다. 팀들은 +91 경로로 출시를 리허설하고, 힌디어, 타밀어, 텔루구어, 벵골어, 마라티어 등의 인터페이스에서 현지화 QA를 하고, 지역 운영 직원을 지원하며, 해외에 살면서도 고국 번호로 로그인하는 인도 디아스포라 고객의 흐름을 확인합니다. 이곳에서 좋은 OTP 라우팅이란 실제 사용자 여정에 맞는 서비스 경로를 고른 다음, 다른 시장에서 쓰는 것과 같은 SMS 인증 API 호출에 연결하는 것입니다.

인도 장기 회선이 있나요? 청구는 어떻게 이루어지나요?

아니요. 전용 번호는 월 $1.95부터 시작하는 미국·캐나다 상품이며, 대시보드에서 인도 장기 회선을 구매할 수는 없습니다. 필요하다면 [email protected]으로 이메일을 보내세요. 제공 여부는 현지 규정에 달려 있어 보장되지 않습니다.

청구는 월 사용료도 선택할 요금제도 없는 하나의 선불 USD 지갑으로 이루어집니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하며, 충전마다 PDF 인보이스가 이메일로 도착합니다. 연동 작업을 위해 지원팀에 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 모의 번호와 코드가 반환되므로 지갑 자금을 쓰지 않고 웹훅 핸들러를 엔드 투 엔드로 테스트할 수 있습니다.

자주 묻는 질문

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

네. OTP Gateway에서 +91 번호를 주문해 가입 화면에 입력하고, 대시보드, API 또는 웹훅에서 코드를 읽으세요.

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

in입니다. GET /api/v1/prices의 국가와 POST /api/v1/activations의 본문에 전달하세요.

인도 SMS OTP를 받는 데 비용이 얼마나 드나요?

코드는 $0.20부터 시작하며 정확한 가격은 서비스에 따라 다릅니다. 주문 전에 확인할 수 있고, 코드를 받지 못한 활성화는 지갑으로 환불됩니다.

다음 달 다시 로그인하려고 같은 +91 번호를 재사용할 수 있나요?

아니요. 게이트웨이 번호는 인증 코드 한 건을 처리합니다. 반복 로그인이 필요한 계정은 전용 회선을 써야 하며, 전용 회선은 미국과 캐나다에만 있습니다.

인도 연동을 개발할 샌드박스가 있나요?

네, 요청 시 제공됩니다. 지원팀이 개발 계정을 샌드박스로 옮기면 모의 번호와 코드가 지갑을 건드리지 않고 코드로 흐릅니다.

재무팀이 스테이블코인으로 결제할 수 있나요?

네. 지갑은 카드 결제와 함께 USDT, USDC를 받으며, 충전마다 PDF 인보이스가 이메일로 발급됩니다.

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