+226 가입 테스트 준비하기: 부르키나파소 인증 번호 체크리스트

+226 번호를 요청하기 전에 무엇을 준비해야 하나요?

첫 시도가 실패하는 원인은 대부분 경로 자체가 아니라 빠뜨린 사전 설정입니다. 첫 주문 전에 아래 항목을 확인하세요.

• API 키. 개발자 콘솔에서 키를 만드세요. 라이브 키는 or_live_ 접두사로 시작하며 Bearer 토큰으로 전송합니다. 키는 최대 10개까지 보유할 수 있으니 스테이징과 CI용으로 따로 발급하세요.
• 충전된 지갑. 카드 또는 USDT/USDC로 충전합니다. 코드가 도착하지 않으면 차감되지 않습니다.
• 올바른 ID. 부르키나파소는 API에서 bf입니다. 서비스 ID는 추측하지 말고 GET /api/v1/services로 조회하세요.
• 수신 방식. 시크릿을 안전하게 보관한 웹훅 엔드포인트나, 적절한 간격을 둔 폴링 루프 중 하나를 정하세요. 계정당 웹훅 엔드포인트를 최대 5개까지 등록할 수 있어 스테이징과 운영을 분리하기 좋습니다.
• 정당한 인증 대상 계정. 자사 제품의 테스트 사용자이거나 팀이 운영하는 비즈니스 계정이어야 합니다. 각 서비스의 약관과 OTP Route 이용 정책(Acceptable Use Policy)이 적용됩니다.

코드를 작성하기 전에 모든 필드를 확인하고 싶다면 API 레퍼런스를 참고하세요.

부르키나파소 경로로 코드를 받을 수 있는 앱은 무엇인가요?

bf의 라이브 카탈로그에는 현재 900개 넘는 서비스가 올라와 있습니다. 작성 시점에 이용 가능한 인기 서비스로는 WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, imo, Viber, Signal, LinkedIn, Uber, Amazon, ChatGPT (OpenAI)가 있습니다.

제휴 통신사 파트너가 용량을 늘리고 줄이면서 이용 가능 여부는 하루 중에도 바뀌므로, 위 목록은 한 시점의 스냅샷으로 보세요. 코드에서는 주문 직전마다 GET /api/v1/prices를 호출하는 것이 좋습니다. 이 호출은 현재 가격과 해당 조합을 주문할 수 있는지 여부를 알려 줍니다.

`bf` 국가의 API 호출 순서는 어떻게 되나요?

1. GET /api/v1/prices?country=bf&service=whatsapp로 해당 조합의 가격을 확인합니다(서비스 ID는 사용하는 것으로 바꾸세요).
2. POST /api/v1/activations에 본문 {"service": "whatsapp", "country": "bf"}를 보내 활성화를 생성합니다. 응답으로 받은 활성화 ID를 저장하세요. 이후의 모든 처리는 이 ID를 기준으로 합니다.
3. 응답에 포함된 +226 번호를 사용해 테스트 중인 앱에서 SMS 발송을 요청합니다.
4. 웹훅으로 activation.sms_received가 오기를 기다립니다. X-OTPRoute-Signature 헤더(형식 t=<unix>,v1=<hex>)를 확인하세요. 엔드포인트 시크릿으로 "<t>.<raw body>"의 HMAC-SHA256을 계산해 비교하고, 타임스탬프가 오래된 요청은 버립니다. 자세한 예외 상황은 HMAC으로 OTP 웹훅 보호하기에서 다룹니다.
5. 웹훅이 없다면 GET /api/v1/activations/{id}를 몇 초 간격으로 폴링하세요.
6. 일찍 끝났거나 실패 경로를 테스트 중이라면 POST /api/v1/activations/{id}/cancel을 호출하세요. 코드 없이 실행이 끝나면 activation.expired 또는 activation.cancelled 이벤트도 받게 됩니다.

계정당 분당 300건의 요청이 허용되므로, 각 실행이 약간씩 간격을 두기만 하면 폴링에는 충분합니다.

코드를 다루지 않는 사람도 +226 코드를 주문할 수 있나요?

네. 지원팀, 마케터, 계정 매니저도 직접 같은 작업을 할 수 있습니다. 로그인하고 OTP Gateway를 연 다음 부르키나파소를 선택하고, 서비스를 고른 뒤 화면에 표시된 가격을 확인하고 주문하세요. 번호가 바로 표시되면 앱에 붙여 넣어 SMS를 요청하고, 같은 대시보드 행에서 코드를 확인하면 됩니다. 탭을 열어 두거나 나중에 다시 와도 됩니다. 활성화는 20분 동안 계속 수신 대기합니다.

+226 번호는 어떻게 저장해야 하고 SMS는 어떤 언어로 올까요?

부르키나파소의 국내 번호는 8자리이며 국내 접두사(트렁크 프리픽스)가 없으므로, 제거해야 할 맨 앞의 0이 없습니다. 국내 형식과 +226 뒤의 숫자는 같습니다. 번호는 E.164 형식으로 +226 뒤에 8자리를 붙여 저장하고, 저장 전에 입력값에서 공백, 하이픈, 국제 접두사 00을 제거해 정규화하세요. 트렁크 0이 있는 국가 기준의 검증 규칙을 그대로 가져오면 올바른 +226 입력이 거부될 수 있습니다. 이는 현지화 버그의 대표적인 사례이므로 회귀 테스트를 추가해 두세요.

프랑스어는 오랫동안 행정, 교육, 비즈니스의 언어였고, 모시어(Mooré), 디울라어(Dioula), 풀푸르데어(Fulfulde)도 널리 쓰입니다. 인증 메시지 템플릿은 계정 로캘에 따라 대개 프랑스어나 영어로 오므로, 숫자 주변에 악센트 문자가 있어도 파서가 처리하는지 확인하세요.

팀들은 보통 프랑스어권 서아프리카 시장에 진출하거나, 가입 화면의 프랑스어 문구를 점검하거나, 결제·모바일 머니 서비스 고객을 온보딩할 때 이곳을 테스트합니다. 이런 패턴은 핀테크 온보딩 페이지에 정리되어 있습니다.

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

• 창이 끝날 때까지 기다리세요. 일부 서비스는 늦게 발송합니다. 3분 만에 취소하면 성공할 수도 있었던 시도를 버리게 됩니다.
• 서비스가 가상 번호를 허용하는지 확인하세요. 일부 플랫폼은 가상 번호를 아예 거부합니다. 사용되지 않은 활성화를 환불하는 이유가 바로 이것입니다.
• 다른 경로를 쓰거나 나중에 다시 시도하세요. 시간대를 바꾸거나 인근 서아프리카 경로를 쓰면 결과가 달라지는 경우가 많습니다.
• 짧은 간격으로 반복 주문하지 마세요. 빠른 반복은 발송 앱 자체의 속도 제한에 걸려 다음 시도를 더 어렵게 만들기 쉽습니다.

재시도 설계에 대해서는 OTP 전송 실패 줄이기 가이드에서 더 자세히 다룹니다.

부르키나파소 장기 번호가 있나요? 요금은 어떻게 청구되나요?

셀프서비스로 쓸 수 있는 장기 +226 회선은 없습니다. 전용 번호(Dedicated Numbers)는 미국과 캐나다에서만 제공되는 상품으로 월 $1.95부터 시작하며, 송수신 SMS와 브라우저 통화를 지원합니다. 부르키나파소의 고정 회선이 필요하다면 [email protected]으로 이메일을 보내 주세요. 마련할 수 있는지는 현지 규정에 따라 다르며 보장되지 않습니다.

+226 활성화 비용은 하나의 선불 USD 지갑에서 차감되며, 구독이나 선택할 요금제는 없습니다. 카드 또는 USDT/USDC로 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 통합 작업에는 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 시뮬레이션된 번호와 코드가 반환되므로 테스트 스위트가 실제 자금을 건드리지 않습니다. 현재 요금은 요금 페이지에서 확인할 수 있습니다.

자주 묻는 질문

현지 SIM 없이 우리 앱의 부르키나파소 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 +226 번호를 주문하고 앱에서 SMS를 발송시킨 다음, 대시보드나 API로 코드를 확인하세요. 코드가 도착한 경우에만 요금이 부과됩니다.

OTP Route API에서 부르키나파소의 국가 ID는 무엇인가요?

bf입니다. 가격 또는 활성화 엔드포인트를 호출할 때 GET /api/v1/services에서 얻은 서비스 ID와 함께 사용하세요.

+226 번호는 0으로 시작하나요?

아니요. 부르키나파소에는 트렁크 프리픽스가 없어서, E.164 형식의 번호는 +226 뒤에 8자리를 붙인 것입니다.

부르키나파소 인증 번호는 얼마 동안 활성 상태로 유지되나요?

활성화당 20분입니다. SMS 없이 창이 닫히거나 취소하면 결제 금액 전액이 자동으로 지갑에 환불됩니다.

코드는 프랑스어로 오나요?

발송 서비스와 계정에 설정된 언어에 따라 다릅니다. 보통 프랑스어나 영어이므로, 제품이 두 언어를 지원한다면 둘 다 테스트하세요.

+226 번호로 한 플랫폼에서 계정을 여러 개 만들어도 되나요?

아니요. OTP Route는 자사 제품을 테스트하고 정당한 비즈니스 계정을 운영하기 위한 서비스입니다. 대량 가입이나 가짜 신원 사용은 이용 정책과 해당 플랫폼의 약관을 위반합니다.

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