QA, 출시, 운영팀을 위한 르완다(+250) 인증 코드

누가 르완다 인증 번호가 필요한가요?

키갈리는 지역 스타트업, 핀테크 시범 사업, 동아프리카 운영팀의 거점이 되었고, 이곳에 출시하는 제품은 실제 르완다 경로에서 전화번호 인증 단계를 테스트해야 합니다. 대표적인 경우는 르완다용으로 현지화하는 결제·온보딩 플로우(핀테크 온보딩 참고), 지역 사무소의 비즈니스 계정을 운영하는 지원팀, 케냐나 우간다와 함께 CI에서 +250 경로를 점검하려는 QA 엔지니어입니다.

E.164에서 +250 번호는 어떤 모양인가요?

르완다의 국가 코드는 +250이고 트렁크 접두사는 0입니다. 휴대전화 번호는 국내에서 07X XXX XXXX로 쓰므로 저장 형식은 +2507XXXXXXXX입니다. 앞의 0을 빼고 뒤의 아홉 자리를 유지하세요. 폼이 국내식 07...뿐 아니라 +250과 00250도 받는지, 그리고 +2500...을 절대 저장하지 않는지 테스트하세요.

키냐르완다어, 영어, 프랑스어, 스와힐리어가 모두 공용어입니다. 대부분의 국제 서비스는 영어로 인증 문자를 보내고 일부는 계정 언어를 따르므로, 메시지를 그대로 보여 주는 화면이 제품에서 제공하는 로케일을 처리하는지 확인하세요.

첫 +250 주문 전에 무엇을 준비해야 하나요?

간단히 준비해 두면 나중에 낭비되는 주문을 줄일 수 있습니다.

• TOTP 2단계 인증을 켜고 소액 잔액을 충전해 둔 OTP Route 계정
• 환경마다 Bearer 키 하나씩. CI와 노트북이 자격 증명을 공유하지 않도록 합니다.
• 코드에 하드코딩하지 않고 설정에 저장한 국가 ID rw와 서비스 ID
• 시크릿을 시크릿 매니저에 보관한 웹훅 엔드포인트, 또는 적절한 간격을 둔 폴링 헬퍼
• 전화번호를 변경할 수 있는, 자체 제품의 테스트 계정

각 스위트를 시작할 때 GET /api/v1/balance로 잔액을 확인하면 실행이 중간에 멈추지 않고 빨리 실패하게 할 수 있습니다.

르완다 SMS OTP 코드를 받을 수 있는 서비스는 무엇인가요?

현재 rw에는 900개 이상의 서비스가 등록되어 있습니다. 현재 스냅샷의 인기 경로는 WhatsApp, Telegram, Facebook, Instagram, X(Twitter), TikTok, Google(Gmail 및 YouTube), LinkedIn, imo, Uber, ChatGPT (OpenAI), Claude 등입니다. OTP 라우팅 재고는 하루 중에도 바뀌므로 주문 직전에 API에서 가용성을 확인하세요.

르완다 OTP API 플로우는 어떻게 진행되나요?

개발자 콘솔에서 받은 or_live_ Bearer 키로 https://otproute.com/api/v1에 인증합니다.

1. GET /api/v1/prices?country=rw&service=whatsapp는 실시간 가격과 해당 경로가 주문을 받을 수 있는지 반환합니다.
2. POST /api/v1/activations에 {"service": "whatsapp", "country": "rw"}를 보내면 활성화 ID와 +250 번호가 반환됩니다.
3. 번호를 직접 만든 앱에 입력하고 코드를 요청합니다.
4. activation.sms_received 웹훅에서 가져오거나 GET /api/v1/activations/{id}를 폴링합니다.
5. 테스트가 일찍 끝나면 POST /api/v1/activations/{id}/cancel로 중단합니다.

X-OTPRoute-Signature(엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256)를 검증하고, 오래된 타임스탬프는 거부하며, 활성화 ID마다 한 번만 처리하세요. 전체 내용은 웹훅 수신 가이드와 API 문서에 있습니다.

개발자가 아닌 사람은 테스트용 +250 번호를 어떻게 주문하나요?

대시보드에서 OTP Gateway를 열고 르완다와 서비스를 선택한 뒤 가격을 확인하고 확정한 다음, 번호를 테스트 중인 앱에 붙여 넣으세요. 코드는 주문 카드에 나타납니다. 20분 동안 SMS가 없으면 주문이 종료되고 금액이 지갑으로 돌아갑니다.

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

+250 주문에서 소식이 없다면 대개 평범한 이유가 있습니다.

• 플랫폼이 번호를 거부했습니다. 일부 서비스는 가상 번호를 거부하며, 바로 그 때문에 사용하지 않은 주문을 환불합니다. 다른 서비스 경로를 시도하거나, 테스트 케이스가 허용한다면 우간다 같은 인접 시장을 이용해 보세요.
• 폼이 번호를 망가뜨렸습니다. 앱이 +250과 아홉 자리를 보냈는지, 남은 0이 없는지 확인하세요.
• 경로가 잠시 바빴습니다. 1분 만에 취소하지 말고 유효 시간을 끝까지 두었다가 나중에 다시 시도하세요.

짧은 간격으로 재주문하지 말고 시도 사이에 간격을 두어, 직접 만든 스크립트가 대상 플랫폼에 남용처럼 보이지 않게 하세요.

장기 회선과 요금 청구는 어떻게 되나요?

OTP Route에는 르완다용 셀프서비스 장기 번호가 없습니다. 운영상 필요가 있는 팀은 [email protected]으로 문의할 수 있지만, 제공 여부는 현지 규정에 따르며 보장되지 않습니다. 월 $1.95부터인 Dedicated Virtual Numbers는 미국과 캐나다만 지원합니다.

결제는 하나의 USD 지갑에서 사용한 만큼 내는 방식이며, 카드 또는 USDT/USDC로 충전하고 충전마다 PDF 인보이스가 이메일로 오며 월 요금은 없습니다. 연동 작업을 위한 모의 번호 샌드박스는 요청 시 이용할 수 있습니다. 모든 서비스의 약관과 OTP Route의 이용 정책(Acceptable Use Policy)을 따르세요.

자주 묻는 질문

현지 SIM 카드 없이 내 앱의 르완다 가입 플로우를 테스트할 수 있나요?

네. OTP Gateway에서 서비스용 +250 번호를 주문해 대시보드나 API에서 코드를 확인하세요.

API에서 르완다의 국가 ID는 무엇인가요?

rw이며, GET /api/v1/prices와 POST /api/v1/activations 본문에서 사용합니다.

저장하는 르완다 휴대전화 번호에 맨 앞 0을 유지해야 하나요?

아니요. 트렁크 0을 제거하고 +250을 붙이면 078X XXX XXX는 +25078XXXXXXX가 됩니다.

르완다 활성화는 얼마 동안 열려 있나요?

20분입니다. 그 시간 안에 SMS가 도착하지 않거나 취소하면 요금 전액이 지갑으로 환불됩니다.

+250 코드에 폴링 대신 웹훅을 쓸 수 있나요?

네. 엔드포인트를 최대 5개 등록하고 activation.sms_received, activation.expired, activation.cancelled를 수신하며, 각 전달의 서명 헤더를 검증하세요.

르완다 번호를 장기간 유지할 방법이 있나요?

셀프서비스 옵션은 없습니다. 장기 Dedicated Numbers는 미국과 캐나다에서만 판매되며, 르완다는 [email protected]에 문의할 수 있지만 보장되는 것은 없습니다.

르완다 인증 코드 비용은 어떻게 결제하나요?

선불 USD 지갑을 카드 또는 USDT/USDC로 충전하고 전달된 코드에 대해서만 지불합니다. 현재 시작 요금은 요금을 참고하세요.

비용을 쓰기 전에 연동을 시험해 볼 수 있나요?

네. 개발 계정에 샌드박스 모드를 요청하면 모의 번호와 코드를 받을 수 있으며, 실제 사용은 가입 후에 하세요.

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