차드(+235) 인증 코드를 내 스택으로 가져오기

차드 OTP API 요청의 호출 순서는 어떻게 되나요?

차드 요청도 다른 모든 시장과 같은 기본 URL인 https://otproute.com/api/v1로 보내며, or_live_ Bearer 키로 서명합니다. 키는 개발자 콘솔에서 만들며, 계정당 최대 10개를 보유하고 분당 300건의 요청을 보낼 수 있습니다.

일반적인 차드 테스트는 호출 네 번으로 이루어집니다.

1. GET /api/v1/countries와 GET /api/v1/services로 td가 목록에 있는지 확인하고 테스트 대상 서비스 ID를 조회합니다.
2. GET /api/v1/prices?country=td&service=<id>로 비용을 쓰기 전에 해당 조합의 실시간 가격을 읽습니다.
3. {"service": "telegram", "country": "td"} 같은 본문으로 POST /api/v1/activations를 호출합니다. 응답에는 활성화 ID와 테스트 대상 앱에 입력할 +235 번호가 들어 있습니다.
4. 코드를 기다린 다음 활성화가 완료되게 두거나, 테스트가 일찍 중단되면 POST /api/v1/activations/{id}/cancel을 호출합니다.

CI 작업을 시작할 때 GET /api/v1/balance를 호출해 두면, 지갑이 비었을 때 파이프라인이 중간에 타임아웃되는 대신 곧바로 분명하게 실패합니다. 전체 레퍼런스는 개발자 문서에 있습니다.

웹훅 수신기는 +235 코드를 어떻게 처리해야 하나요?

몇 초마다 GET /api/v1/activations/{id}를 폴링하는 방식은 스크립트 하나에는 충분합니다. 여러 테스트 러너가 키를 공유하게 되면 웹훅이 더 깔끔합니다. 엔드포인트(계정당 5개)를 등록하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요.

각 요청에는 t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature 헤더가 포함됩니다. <t>.<raw body> 문자열을 다시 만들어 엔드포인트 시크릿으로 HMAC-SHA256 서명을 계산하고 v1과 상수 시간으로 비교하세요. 타임스탬프가 오래된 요청은 거부하면 재전송된 요청을 막을 수 있습니다. HMAC으로 OTP 웹훅 보호하기 가이드에서 여러 언어로 설명합니다.

활성화 ID를 멱등성 키로 사용하세요. 같은 이벤트가 두 번 전달되더라도 두 번째 쓰기는 아무것도 바꾸지 않아야 하며, 핸들러는 2xx를 빠르게 반환하고 오래 걸리는 작업은 그 뒤에 처리해야 합니다.

차드 인증 번호로 코드를 보낼 수 있는 앱은 무엇인가요?

td의 라이브 스냅샷에는 1,500개 넘는 서비스가 올라와 있습니다. 인기 서비스로는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, imo, Signal, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI), AliExpress가 있습니다.

이용 가능 여부는 고정되어 있지 않습니다. 제휴 통신사 파트너가 용량을 옮기면서 경로가 하루 중에도 열리고 닫히므로, 오전에 보이던 서비스가 오후에는 없을 수 있습니다. 카탈로그를 하드코딩하지 말고 실행 시점에 읽으세요. 첫 번째 서비스가 차드에서 일시적으로 이용 불가일 때를 대비해 테스트 계획에 두 번째 서비스도 넣어 두세요.

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

차드는 폐쇄형 번호 체계를 사용합니다. 국내 번호는 8자리이고 제거할 트렁크 프리픽스가 없으므로, E.164 형식은 +235 뒤에 그 8자리를 붙인 것입니다. 덕분에 차드는 검증하기 쉬운 시장에 속합니다.

• 국가 코드와 가입자 번호를 나누지 말고 전체 E.164 문자열을 한 열에 저장하세요.
• 폼이 공백이나 사람들이 흔히 입력하는 두 자리씩 묶는 형식을 받는다면, 저장 전에 제거하세요.
• 다른 번호 체계를 쓰던 사용자가 습관적으로 맨 앞에 0을 붙이는 경우가 있으므로, 이런 값이 거부되거나 정리되는지 테스트에서 확인하세요.

공용어는 프랑스어와 아랍어입니다. 다만 인증 SMS의 문구는 앱이나 계정에 설정된 언어를 따르므로, 현지화 테스트에서는 프랑스어, 아랍어, 영어 템플릿을 각각 확인해야 합니다.

제품 팀이 차드에서 테스트하는 이유는 무엇인가요?

응자메나에 있는 엔지니어링 팀은 드물고, 바로 그래서 원격 +235 번호가 유용합니다. 저희가 자주 보는 이유는 다음과 같습니다.

• 프랑스어권 중앙아프리카 출시. 이웃 시장에서 이미 서비스 중인 제품이 가입 국가 선택기에 차드를 추가하고 흐름이 동작한다는 증거가 필요한 경우입니다.
• 아랍어·프랑스어 현지화 QA. 코드 입력 화면의 오른쪽에서 왼쪽 레이아웃 점검을 포함합니다.
• 디아스포라 고객. 해외에 살면서 차드 번호를 유지하는 고객이며, 이는 사기 방지 규칙이 국가 코드를 해석하는 방식에 영향을 줍니다.
• 운영팀. 지역 파트너를 위한 비즈니스 메시징 계정을 관리하는 팀입니다.

더 넓은 패턴은 OTP 국가별 라우팅에 설명되어 있습니다.

차드 코드가 오지 않으면 어떻게 하나요?

번호가 조용하다면 보통 코드 버그가 아니라 경로나 수신 거부 문제입니다. 다음 순서로 확인하세요.

• 20분의 창이 끝까지 진행되도록 기다리세요. 일부 발신자는 메시지를 묶어서 보냅니다.
• 대상 서비스가 가상 번호를 허용하는지 확인하세요. 허용하지 않는 곳도 있으며, 환불이 존재하는 이유가 바로 이것입니다.
• 짧은 간격으로 반복 주문하지 말고, 나중에 다시 시도하거나 같은 국가에서 다른 서비스를 써 보세요. 빠른 재시도는 발신 측의 속도 제한을 건드릴 수 있습니다.
• 핸들러가 서명을 올바르게 검증했는지 확인하세요. 거부된 웹훅은 코드가 없는 것처럼 보입니다.

창이 닫히거나 취소하면 지원 요청 없이 전액이 지갑으로 돌아갑니다. 더 많은 방법은 OTP 전송 실패 줄이기에 있습니다.

차드 장기 회선이 있나요? 요금은 어떻게 청구되나요?

셀프서비스로 쓸 수 있는 차드 장기 번호는 없습니다. 전용 번호(Dedicated Numbers)는 미국과 캐나다 상품이며 월 $1.95부터 시작하고, 수신·발신 SMS와 브라우저 통화를 지원합니다. 지속적으로 쓸 +235 회선이 필요하다면 [email protected]으로 이메일을 보내 주세요. 이용 가능 여부는 현지 규정에 따라 다르며 저희가 약속할 수 없습니다.

+235 코드 요금은 하나의 선불 USD 잔액에서 차감되며, 구독 등급이나 월 요금은 없습니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하고, 입금할 때마다 PDF 인보이스가 받은편지함에 도착합니다. 실시간 요금은 요금 페이지에 표시됩니다. 연동 작업에는 샌드박스 전환을 요청하세요. 시뮬레이션된 번호와 코드가 반환되므로 지갑 자금을 쓰지 않고 흐름을 리허설할 수 있습니다. 새 계정은 6자리 이메일 코드로 만들 수 있고, 팀이 선호하면 Google 로그인도 가능합니다.

자주 묻는 질문

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

POST /api/v1/activations의 country 필드와 가격 조회에서 td를 사용하세요.

현지 SIM 없이 우리 앱의 차드 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 +235 번호를 주문해 앱에 입력하고, 대시보드, API 또는 웹훅에서 코드를 읽으면 됩니다.

+235 번호는 얼마 동안 사용할 수 있나요?

활성화 한 건은 20분 동안 열려 있으며 코드 한 건을 받습니다. 그 후에는 새로 주문하세요.

SMS가 끝내 오지 않아도 요금을 내나요?

아니요. 창이 닫히기 전에 메시지가 오지 않거나 취소하면 금액은 자동으로 지갑에 환불됩니다.

차드 번호에서 제거해야 할 트렁크 프리픽스가 있나요?

아니요. 차드에는 트렁크 프리픽스가 없으므로 저장 형식은 +235에 8자리 국내 번호를 붙인 것입니다.

나중에 로그인할 때를 위해 차드 번호를 계속 보유할 수 있나요?

셀프서비스로는 불가능합니다. 장기 전용 번호(Dedicated Numbers)는 미국과 캐나다에만 있습니다. 차드는 팀에 이메일로 문의해 가능한 방법을 확인하세요.

이용 규칙이 있나요?

네. 각 서비스의 약관과 OTP Route 이용 정책(Acceptable Use Policy)을 따르세요. 게이트웨이는 자사의 정당한 제품과 계정을 테스트하고 운영하기 위한 것입니다.

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