콩고 공화국(+242) 인증번호를 테스트 환경으로 라우팅하기

+242 코드를 처음부터 끝까지 받아 오는 API 호출은 무엇인가요?

모든 요청은 https://otproute.com/api/v1 아래에서 이루어지며 or_live_로 시작하는 Bearer 키로 인증합니다. 키는 Developer 콘솔에서 만들 수 있고 계정당 최대 10개까지 보유할 수 있어서, 스테이징, CI, 팀원의 노트북에 각각 별도 자격 증명을 주고 독립적으로 폐기할 수 있습니다.

브라자빌 시장을 대상으로 한 일반적인 테스트 실행 순서는 다음과 같습니다.

1. GET /api/v1/services와 GET /api/v1/countries를 호출해 ID를 캐시합니다. 콩고 공화국은 cg입니다(자체 ID와 페이지가 있는 더 큰 이웃 나라인 콩고민주공화국(DRC)과 혼동하지 마세요).
2. GET /api/v1/prices?country=cg&service=<id>로 테스트 중인 앱의 실시간 가격과 가용 여부를 조회합니다.
3. {"service": "telegram", "country": "cg"} 같은 본문으로 POST /api/v1/activations를 호출해 활성화를 만듭니다. activation id와 +242 번호를 받습니다.
4. 그 번호를 자사 제품의 가입 또는 로그인 화면에 입력합니다.
5. 웹훅 전달 또는 GET /api/v1/activations/{id} 폴링으로 콩고 코드를 받습니다. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel로 해제합니다.

스위트를 시작하기 전에 GET /api/v1/balance를 실행해 두면 지갑이 비어 있을 때 작업 중간이 아니라 초반에 실패합니다. 분당 300건의 한도는 몇 개의 병렬 워커를 돌리기에도 충분합니다. 요청과 응답의 전체 형태는 개발자 문서에 있습니다.

콩고 활성화용 서명 웹훅은 어떻게 연결하나요?

엔지니어 한 명이 흐름을 따라 클릭해 볼 때는 폴링으로 충분하지만, CI 서버 군에는 웹훅이 더 적합합니다. Developer 콘솔에서 엔드포인트를 추가하고(계정당 5개까지 허용) activation.sms_received, activation.expired, activation.cancelled를 구독하세요.

모든 요청에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 해당 엔드포인트의 시크릿으로 "<t>.<raw body>"의 HMAC-SHA256을 다시 계산하고, 상수 시간 비교로 v1과 대조하며, 타임스탬프가 오래된 요청은 버리세요. 다시 직렬화한 JSON은 바이트 단위로 일치하는 경우가 드물기 때문에, JSON을 파싱하기 전에 원본 바이트를 해시해야 합니다.

이벤트는 activation id를 키로 다루세요. 같은 이벤트가 두 번 도착하면 핸들러가 해당 id가 이미 처리되었음을 알아채고 성공 상태만 반환해야 합니다. 느린 테스트 러너가 타임아웃되지 않도록 하는 큐잉 패턴은 웹훅 기반 OTP 수집 가이드에서 다룹니다.

콩고 인증 번호로 어떤 서비스를 이용할 수 있나요?

cg의 현재 스냅샷에는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, LinkedIn, Signal, Viber, imo가 포함되어 있습니다. 전체적으로 이 국가에는 OTP Gateway에서 1,000개가 넘는 서비스가 있습니다.

경로가 열리고 닫히면서 이 목록은 하루 중에도 바뀌므로 절대 하드코딩하지 마세요. 테스트 하네스가 필요한 특정 서비스에 대해 가격 엔드포인트에 물어보게 하고, 가용 상태가 비어 있으면 건너뛰거나 일정을 다시 잡도록 하세요. 콩고에서는 메신저 앱이 목록을 주도하는 경향이 있는데, 이는 많은 고객이 새 제품을 앱스토어 검색이 아니라 채팅 그룹에 공유된 링크로 처음 접하는 방식과 맞아떨어집니다.

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

콩고 공화국 번호는 국가 코드 뒤에 9자리이며, 많은 번호 체계와 달리 맨 앞의 0은 트렁크 접두사가 아니라 가입자 번호의 일부입니다. 휴대폰 회선은 현지에서는 06… 또는 05…로, 국제 형식에서는 +242 06…로 쓰는 것이 일반적입니다. 유럽 코드베이스에서 가져온, 맨 앞의 0을 무조건 지우는 정규화 로직은 이런 번호를 조용히 망가뜨리므로, API가 돌려주는 E.164 문자열을 그대로 저장하고 전 세계 공통 규칙이 아니라 국가별로 길이를 검증하세요.

공용어는 프랑스어이며 인증 SMS도 대개 프랑스어이지만, 일상에서는 링갈라어와 키투바어도 널리 쓰입니다. 일부 템플릿에는 악센트 문자가 들어가므로, 영어 고정 문구에 의존하지 말고 패턴으로 숫자를 뽑는 파서를 만드세요.

팀들은 보통 프랑스어권 중앙아프리카로 제품을 확장하거나, 브라자빌·푸앵트누아르의 운영 담당자를 지원하거나, 고향 번호로 여전히 가입하는 해외 거주 콩고 고객을 대상으로 서비스할 때 이곳에서 테스트합니다. 실제 +242 경로에서 전체 흐름을 확인하면 시뮬레이터가 놓치는 형식과 문구 문제를 잡아낼 수 있습니다.

+242 번호로 코드가 오지 않으면 어떻게 하나요?

응답이 없다면 대개 연동 버그가 아니라 경로나 수락의 문제입니다. 합리적인 대응 순서는 다음과 같습니다.

• 일부 발신처는 발송을 묶어서 처리하므로, 결론을 내리기 전에 20분의 유효 시간을 끝까지 두세요.
• 대상 서비스가 가상 번호를 받아주는지 확인하세요. 받지 않는 서비스도 여럿 있으며, 그래서 받지 못한 코드에는 비용이 들지 않습니다.
• 요청 한도를 소진시키는 짧은 간격의 재주문 대신, 나중에 다시 시도하거나 다른 서비스 경로로 바꿔 보세요.
• 더 이상 필요 없는 번호는 취소하면 만료를 기다리지 않고 금액이 바로 돌아옵니다.

백오프와 재시도 예산은 OTP 전송 실패 줄이기 글에서 더 자세히 다룹니다.

콩고 장기 회선을 유지할 수 있나요?

콩고 공화국에는 셀프서비스 장기 번호가 없습니다. OTP Gateway는 인증 코드 한 건당 번호 하나를 발급하며, 현재 cg에 제공되는 상품은 그것뿐입니다.

OTP Route의 전용 가상 번호(Dedicated Virtual Numbers)는 미국과 캐나다 전용 상품으로 월 $1.95부터 시작하며, 문자 수신·발신과 브라우저 통화를 지원합니다. 팀에 지속적인 콩고 회선이 꼭 필요하다면 [email protected]으로 이메일을 보내세요. 가능한지는 현지 규정에 따라 달라지므로 약속이 아니라 문의로 여기세요. 장단점은 임시 번호 vs 전용 번호에 정리되어 있습니다.

콩고 OTP 라우팅 설정의 요금은 어떻게 청구되고 안전하게 테스트하나요?

요금은 구독이나 요금제 등급 없이 선불 USD 지갑 하나에서 청구됩니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하며, 충전할 때마다 재무팀을 위한 PDF 인보이스가 이메일로 발송됩니다.

파이프라인에 실제 비용을 연결하기 전에 지원팀에 요청해 개발 계정을 샌드박스 모드로 전환하세요. 시뮬레이션 번호와 코드를 반환하므로 아무것도 쓰지 않고 SMS 인증 API 경로 전체를 처음부터 끝까지 실행해 볼 수 있습니다. OTP Route는 자사 제품과 운영 권한이 있는 계정에만 사용하세요. 모든 서비스의 약관과 이용 정책(Acceptable Use Policy)이 계속 적용됩니다. 지갑에 요금과 환불이 어떻게 표시되는지는 요금을 참고하세요.

자주 묻는 질문

OTP Route API에서 콩고 공화국의 국가 ID는 무엇인가요?

cg입니다. 콩고민주공화국은 별도의 국가이며 자체 ID가 있으므로, 설정에서 어느 쪽을 참조하는지 다시 확인하세요.

현지 SIM 없이 앱의 콩고 가입 절차를 테스트할 수 있나요?

네. OTP Gateway에서 테스트용 +242 번호를 주문해 앱에 입력하고, 대시보드나 API로 코드를 확인하세요.

+242 번호를 저장할 때 맨 앞의 0을 빼야 하나요?

아니요. 콩고 공화국에서 0은 9자리 가입자 번호에 속하므로, E.164 값을 API가 반환한 그대로 유지하세요.

콩고 인증 문자는 어떤 언어로 오나요?

대부분 프랑스어로 오며, 국제 앱은 영어로 오기도 합니다. 특정 단어를 매칭하지 말고 패턴으로 숫자를 추출하세요.

코드가 끝내 오지 않으면 요금이 청구되나요?

아니요. SMS 없이 유효 시간이 끝나거나 먼저 취소하면 결제 금액 전액이 자동으로 지갑에 돌아옵니다.

콩고 SMS OTP를 받는 데 비용이 얼마나 드나요?

$0.20/코드부터이며, 각 앱의 +242 가격은 실시간으로 제시되므로 주문 전에 조회해 보세요.

연동을 만드는 동안 쓸 샌드박스가 있나요?

네, 요청하면 가능합니다. 지원팀이 개발 계정을 샌드박스 모드로 전환해 주며, 지갑 잔액을 쓰지 않고 시뮬레이션 번호와 코드가 반환됩니다.

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