QA, 출시, 지역 운영을 위한 코트디부아르 +225 인증 번호

코트디부아르 전화번호는 무엇이 바뀌었고, 어떻게 저장해야 하나요?

코트디부아르는 2021년 초에 가입자 번호를 8자리에서 10자리로 바꿨기 때문에, 그 이전에 작성한 테스트 픽스처와 검증 규칙은 조용한 실패의 흔한 원인입니다. 현재 국내 번호는 10자리이며 휴대폰 번호는 01, 05, 07로 시작합니다.

엔지니어가 놓치기 쉬운 부분은 이 맨 앞의 0이 트렁크 접두사가 아니라는 점입니다. 가입자 번호의 일부이며 국제 형식에서도 유지되므로, 코트디부아르 휴대폰은 E.164로 +225 07 xx xx xx xx처럼 보입니다.

• +225와 10자리 전체를 하나의 문자열로 저장하고, 띄어쓰기는 표시할 때만 추가하세요.
• +225 입력에 대해 맨 앞의 0을 지우는 일반 규칙은 끄세요. 어떤 통신망도 라우팅하지 못하는 9자리 값이 만들어집니다.
• 8자리 입력은 구형으로 보고, 빠진 접두사를 추측하지 말고 사용자에게 다시 입력하도록 안내하세요.
• 서아프리카 번호 체계 메타데이터는 가끔 바뀌므로 전화번호 라이브러리를 최신으로 유지하세요.

제품·QA 팀은 왜 +225 번호로 테스트할까요?

아비장은 프랑스어권 서아프리카의 상업 중심지로, 기업이 이 지역의 프랑스어권으로 확장할 때 코트디부아르가 첫 번째 기착지가 되는 경우가 많습니다. 계획에 테스트용 +225 번호를 넣는 대표적인 이유는 다음과 같습니다.

• 시장 출시: 마케팅을 시작하기 전에 현지 번호로 가입, 로그인, 복구가 처음부터 끝까지 동작하는지 확인합니다.
• 현지화 QA: 공용어가 프랑스어이므로 글로벌 앱의 인증 문자는 프랑스어로, 계정 로캘에 따라서는 영어로 도착하는 경우가 많습니다. 고정 문구를 매칭하지 말고 숫자를 파싱하세요.
• 지갑과 결제 온보딩: 모바일 머니가 널리 쓰이며, 많은 금융 제품이 전화번호를 고객의 주된 신원으로 취급합니다. 이 패턴은 핀테크 온보딩 가이드에서 다룹니다.
• 지역 운영: 세네갈 같은 인접 시장을 지원하는 팀은 코트디부아르 점검도 같은 스위트에서 실행하는 경우가 많습니다.

코트디부아르 번호로 코드를 전달할 수 있는 서비스는 무엇인가요?

코트디부아르의 실시간 카탈로그에는 800개가 넘는 서비스가 있습니다. 현재 스냅샷의 인기 경로로는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber가 있습니다.

재고는 하루 중에도 달라지므로 어떤 목록이든 출발점으로만 보고, 지금 주문 가능한 항목은 API에 물어보세요. 같은 조합이라도 서비스마다 가격이 다를 수 있기 때문에, 표에 적어 두지 않고 실시간으로 제시합니다.

코트디부아르 OTP API 흐름은 실제로 어떻게 생겼나요?

HTTP 클라이언트를 https://otproute.com/api/v1로 향하게 하고 Developer 콘솔에서 받은 or_live_ Bearer 키로 인증하세요. 코트디부아르 주문의 국가 ID는 ci입니다.

테스트 실행은 보통 GET /api/v1/balance로 시작하는데, 지갑이 비어 있으면 작업이 처음부터 실패하게 하기 위해서입니다. 다음으로 GET /api/v1/prices?country=ci&service=<id>가 현재 가격과 해당 조합의 재고 여부를 확인해 줍니다. 주문은 {"service": "whatsapp", "country": "ci"} 같은 본문으로 POST /api/v1/activations를 호출하는 것이며, 응답에는 activation id와 자사 앱에 입력할 +225 번호가 담겨 있습니다.

그다음에는 GET /api/v1/activations/{id}를 폴링하거나, 병렬 스위트라면 웹훅이 더 낫습니다. 웹훅을 activation.sms_received, activation.expired, activation.cancelled에 구독하세요. 각 전달은 X-OTPRoute-Signature 헤더(t=<unix>,v1=<hex>)로 서명됩니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 다시 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프는 버리세요. HMAC 안내와 API 문서에서 더 자세히 볼 수 있습니다. 한도는 계정당 분당 300건으로, SMS 인증 API 테스트 하네스에는 충분합니다.

코드 없이도 +225 번호를 주문할 수 있나요?

네. 운영 담당자와 에이전시는 대시보드를 선호하는 경우가 많으며, 대시보드도 API와 같은 OTP 라우팅 규칙을 따릅니다.

1. 회원 가입 페이지에서 이메일과 6자리 코드, 또는 Google로 계정을 만듭니다.
2. USD 지갑에 자금을 충전합니다.
3. 코트디부아르를 고른 다음 인증하려는 서비스를 선택합니다. 확정하기 전에 가격이 표시됩니다.
4. 앱의 전화번호 입력란에 번호를 복사해 넣고 코드를 요청합니다.
5. SMS가 도착하는 즉시 활성화 카드에 나타납니다.

활성화는 20분 동안 열려 있습니다. 아무것도 오지 않거나 먼저 취소하면 결제 금액 전액이 지갑으로 자동 환급됩니다.

코트디부아르 코드가 오지 않을 때는 무엇을 시도해야 하나요?

코드가 누락되는 데는 보통 평범한 원인이 있으므로, 에스컬레이션하기 전에 다음을 확인해 보세요.

• 일부 서비스는 특정 국가나 계정 유형에서 가상 번호를 거부합니다. 환불은 바로 그런 경우를 위해 있습니다.
• 일부 발신처는 메시지를 대기열에 쌓으므로, 1분 뒤에 취소하지 말고 20분 유효 시간이 끝날 때까지 기다리세요.
• 나중에 다시 시도하거나, 테스트가 허용한다면 같은 서비스를 다른 국가 경로로 시도하세요.
• 몇 초마다 주문을 반복하지 마세요. 재시도 간격을 두는 것이 지갑과 경로 모두에 좋습니다.

항상 각 서비스의 약관을 따르세요. 모든 주문에는 OTP Route 이용 정책(Acceptable Use Policy)이 적용됩니다.

코트디부아르 장기 회선을 이용할 수 있나요? 요금은 어떻게 청구되나요?

코트디부아르에는 셀프서비스 장기 번호가 없습니다. 전용 회선은 미국과 캐나다 전용 상품으로 월 $1.95부터 시작합니다. 팀에 지속적으로 쓸 코트디부아르 회선이 필요하다면 [email protected]으로 이메일을 보내 문의하되, 제공 가능 여부는 현지 규정에 따라 달라지며 불가능할 수도 있다는 점을 이해해 주세요.

요금은 월 요금이나 선택할 요금제 없이 선불 USD 지갑 하나에서 사용한 만큼 지불합니다. 코트디부아르 테스트 예산은 카드 또는 USDT/USDC로 충전할 수 있으며, 입금마다 따라오는 PDF 인보이스는 계정 소유자의 받은편지함으로 도착합니다. 연동 작업의 경우, 요청하면 개발 계정을 샌드박스로 전환할 수 있어 지갑 잔액을 쓰지 않고 시뮬레이션 번호와 코드로 전체 흐름을 실행할 수 있습니다. 현재 요금은 요금 페이지에서 확인하세요.

자주 묻는 질문

현지 SIM 없이 앱의 코트디부아르 가입 절차를 테스트할 수 있나요?

네. 테스트하려는 서비스용 +225 번호를 OTP Gateway에서 주문해 가입 양식에 입력하고, 대시보드나 API로 코드를 확인하세요.

번호를 저장할 때 +225 뒤의 0을 빼야 하나요?

아니요. 2021년 변경 이후 맨 앞의 0은 10자리 코트디부아르 번호의 일부이므로 E.164 저장 시 유지해야 합니다.

OTP Route API에서 코트디부아르의 국가 ID는 무엇인가요?

ci입니다. POST /api/v1/activations를 호출하거나 가격을 조회할 때 country 필드에 사용하세요.

코트디부아르 코드가 오지 않으면 요금이 청구되나요?

아니요. 코드가 도착한 경우에만 요금을 내며, 만료되거나 취소된 활성화는 지갑으로 전액 환불됩니다.

인증 SMS는 어떤 언어로 오나요?

발송 서비스가 정하지만 코트디부아르 계정에서는 프랑스어와 영어가 가장 흔하므로, 텍스트를 매칭하지 말고 숫자 코드를 추출하세요.

앞으로의 로그인을 위해 같은 +225 번호를 유지할 수 있나요?

셀프서비스 상품으로는 불가능합니다. OTP Gateway 번호는 코드 한 건용이기 때문입니다. 장기 전용 번호는 미국과 캐나다에서만 즉시 제공되며, 코트디부아르는 지원팀에 이메일로 문의할 수 있습니다.

연동을 만드는 동안 지갑 잔액을 쓰지 않으려면 어떻게 하나요?

개발 계정의 샌드박스 모드를 요청하세요. 시뮬레이션 번호와 코드가 반환되므로 웹훅과 폴링을 처음부터 끝까지 테스트할 수 있습니다.

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