팀들이 라이베리아 번호를 원하는 이유는 무엇인가요?
라이베리아는 영어를 쓰는 서아프리카 시장이라서, 해안을 따라 확장하는 기업에게 현실적인 첫 기착지입니다. 문구를 번역할 일이 드물어 테스트 노력을 인증 플로우 자체에 쏟을 수 있기 때문입니다. 라이베리아 디아스포라를 대상으로 하는 팀도 +231을 살펴보는데, 고향에 있는 가족이 실제로 가입을 마칠 수 있는지 확인하고 싶어서입니다. 특히 핀테크와 마켓플레이스 제품은 출시 전에 현지 번호가 자사 검증을 통과하는지 확인해야 합니다. 더 넓은 패턴은 핀테크 온보딩을 참고하세요.
세 번째 그룹은 라이베리아 사무소나 파트너의 비즈니스 계정을 관리하는 운영 담당자입니다. 일회성 인증에 Gateway 번호를 쓰면 직원의 개인 휴대폰이 회사 프로필에 연결되지 않고, 코드는 팀 전체가 볼 수 있는 곳에 도착합니다.
+231 경로에서는 무엇을 인증할 수 있나요?
현재 이 국가에는 1,700개가 넘는 서비스가 등록되어 있습니다. 자주 선택되는 서비스는 WhatsApp, Facebook, TikTok, Telegram, Instagram, Google (Gmail & YouTube), Snapchat, imo, Viber, X (Twitter), LinkedIn, Microsoft & Outlook 등입니다. 재고는 하루 중에도 움직이므로 API는 고정된 카탈로그가 아니라 실시간 가용성을 반환합니다.
테스트 계획에서는 사용자가 실제로 의존하는 서비스 두세 개를 정리하고, 실행을 시작할 때 가격 조회로 각 조합을 확인하세요. 오늘 아침에는 +231에서 되던 메시징 앱이 오후에는 잠시 사용 불가일 수 있습니다. 먼저 확인하는 파이프라인은 타임아웃 대신 명확한 이유와 함께 실패합니다.
라이베리아 연동에서는 어떤 엔드포인트를 호출하나요?
모든 호출은 개발자 콘솔에서 받은 Bearer 키로 https://otproute.com/api/v1 아래에서 이루어집니다.
GET /api/v1/services와GET /api/v1/countries로 id를 조회합니다. 라이베리아는lr입니다.GET /api/v1/prices?country=lr&service=<id>로 해당 조합의 가격을 확인합니다.POST /api/v1/activations에{"service": "<id>", "country": "lr"}본문을 보내 주문을 생성합니다.- 활성화 id를 키로 하는
activation.sms_received,activation.expired,activation.cancelled를 웹훅으로 받거나,GET /api/v1/activations/{id}를 폴링합니다.
모든 웹훅에서 X-OTPRoute-Signature를 확인하세요. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산하고 오래된 타임스탬프는 거부합니다. 자세한 내용은 웹훅 보안 글에 있습니다.
코드를 작성하지 않고 라이베리아 SMS OTP를 받을 수 있나요?
네. 대시보드에서 라이베리아와 서비스를 선택하고, 표시된 가격을 확인한 다음 주문하세요. +231 번호를 앱에 붙여 넣으면 코드가 전달되는 즉시 주문 옆에 나타납니다. 그 코드를 앱의 코드 입력란에 바로 복사해 넣으세요. 더 이상 필요 없는 주문은 같은 화면에서 취소하면 잔액이 즉시 돌아옵니다.
+231 번호는 어떻게 포맷하고 정규화하나요?
라이베리아 번호는 보통 현지에서 앞에 국내 접두번호 0을 붙여 적습니다. 그 0을 빼고 +231을 앞에 붙이면 데이터베이스에 저장할 E.164 형식이 됩니다. 현지 통신사가 달라도 모든 휴대폰 번호가 같은 +231 국가 코드를 쓰므로, OTP를 라우팅할 때 통신사별로 분기할 필요가 없습니다. 현지 형식이 아니라 국제 형식을 기준으로 검증하고, 지원팀이 익숙한 현지 표기를 선호한다면 표시용 문자열을 따로 두세요. 영어가 공용어여서 대부분의 서비스 템플릿은 영어로 도착합니다. 코드 추출은 간단해지지만, 서비스가 예고 없이 문구를 바꾸므로 고정된 문장이 아니라 숫자 그룹을 기준으로 매칭하세요.
라이베리아 코드가 늦거나 오지 않을 때는 어떻게 하나요?
전달은 서비스와 경로에 따라 달라집니다. 아무것도 오지 않는다면 다음을 확인하세요.
- 20분 창이 끝날 때까지 기다리세요. 취소되거나 만료된 주문은 전액 환불됩니다.
- 나중에 다시 시도하거나 다른 서비스 경로를 사용하세요.
- 서비스가 가상 번호를 받아들이는지 확인하세요. 거부하는 서비스도 있습니다.
- 짧은 간격으로 반복 주문하지 마세요. 시도 횟수만 소모됩니다.
더 자세한 내용은 OTP 전달 실패 줄이기에 있습니다.
라이베리아 장기 회선이 있나요? 결제는 어떻게 하나요?
라이베리아에는 셀프서비스 장기 번호가 없습니다. 전용 회선은 미국과 캐나다 상품이며 월 $1.95부터입니다. 라이베리아에서 오래 쓸 회선이 필요하면 [email protected]으로 이메일을 보내세요. 가능 여부는 현지 규정에 달려 있고 보장되지는 않습니다. 가입이나 확인 단계마다 코드 한 번이면 충분하므로, 대부분의 라이베리아 테스트 계획에는 Gateway로 충분합니다.
결제는 월 이용료 없이 하나의 선불 USD 지갑으로 이루어집니다. 카드 또는 USDT/USDC로 충전하고, PDF 인보이스를 이메일로 받고, 개발하는 동안에는 샌드박스 모드를 요청하세요. 회원가입에서 시작할 수 있습니다.
자주 묻는 질문
해외에서 내 앱의 라이베리아 가입 플로우를 테스트할 수 있나요?
네. OTP Gateway에서 +231 번호를 주문하면 원격으로 인증을 마칠 수 있으며, 현지 SIM은 필요하지 않습니다.
API에서 라이베리아의 국가 id는 무엇인가요?
POST /api/v1/activations의 country 필드와 가격 조회에 lr을 사용하세요.
라이베리아 코드는 얼마인가요?
라이베리아 주문은 서비스에 따라 코드당 $0.20부터 시작합니다. 정확한 금액은 GET /api/v1/prices에서 반환되며 주문 전에 표시됩니다.
라이베리아 코드가 전달되지 않으면 잔액은 어떻게 되나요?
걱정하지 않으셔도 됩니다. SMS 없이 20분이 지나거나 직접 취소한 +231 주문은 전액 자동으로 지갑에 환불됩니다.
다음 주에 같은 +231 번호를 다시 쓸 수 있나요?
아니요. Gateway 번호는 인증 코드 한 번을 위한 것입니다. 장기 회선은 미국과 캐나다에만 있습니다.
폴링과 웹훅 중 무엇을 써야 하나요?
웹훅이 시스템 부담이 적고, 스크립트에는 폴링으로 충분합니다. 많은 팀이 웹훅을 쓰다가 핸들러가 멈췄을 때 폴링으로 대체합니다.
지갑에서 차감되지 않는 테스트 모드가 있나요?
네. 요청하면 개발 계정을 샌드박스로 전환할 수 있으며, 모의 번호와 코드가 반환됩니다.
인증할 수 있는 대상에 제한이 있나요?
네. 대상 앱의 자체 약관과 OTP Route 이용 정책(Acceptable Use Policy)이 적용됩니다. 라이베리아 번호는 자사 제품을 테스트하거나 조직이 정당하게 소유한 계정을 운영하는 용도입니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.