QA 및 출시 팀을 위한 니카라과(+505) SMS 인증

+505 번호는 어떤 구조이며 데이터베이스에는 어떻게 저장해야 하나요?

니카라과 번호는 국가번호 +505 뒤에 8자리가 붙으며, 국내 다이얼링에 국내 접두번호는 없습니다. 따라서 표준 E.164 형식은 +505와 8자리 숫자이고 그 외에는 아무것도 붙지 않습니다.

함정은 지역적인 데 있습니다. 코스타리카(+506), 온두라스(+504), 엘살바도르(+503), 과테말라(+502)도 8자리 국내 번호를 사용하므로, 8자리 숫자만으로는 어느 나라 번호인지 알 수 없습니다. 중미를 대상으로 하는 제품의 실무 규칙은 다음과 같습니다.

• UI가 국가를 미리 선택해 주더라도 국가번호 없이 전화번호를 저장하지 마세요.
• 브라우저뿐 아니라 서버에서도 정규화해 가져오기 작업과 API 클라이언트가 같은 규칙을 따르게 하세요.
• 테스트 픽스처에 +505 번호를 포함해, 국가 선택기 회귀가 고객 문의가 아니라 실패한 단언으로 드러나게 하세요.

니카라과에서 인증 메시지는 어떤 언어로 오나요?

공용어는 스페인어이며 대부분의 니카라과 사용자에게 기본 언어입니다. 카리브해 연안에서는 영어 기반 크리올어와 미스키토어 같은 원주민 언어도 쓰입니다. 대형 플랫폼은 계정이나 기기의 로케일로 SMS 언어를 정하므로, 같은 서비스가 한 테스터에게는 스페인어 템플릿을, 다른 테스터에게는 영어 템플릿을 보낼 수 있습니다.

현지화 QA에서는 두 가지를 확인하세요. 코드 입력란 주변의 자체 스페인어(중남미식) 문구가 올바른지, 그리고 자동 완성 힌트나 테스트의 정규식 추출처럼 코드를 파싱하는 로직이 메시지 본문의 영어 단어에 의존하지 않는지입니다.

팀은 왜 니카라과 번호로 테스트하거나 운영할까요?

니카라과만 단독으로 출시하는 회사는 드물고, 보통 중미 전체 롤아웃의 일부로 들어옵니다. 팀이 니카라과 인증 번호를 필요로 하는 대표적인 이유는 다음과 같습니다.

• 지역 출시 점검: 중미 지협 국가마다 가입 경로, 통화 표시, 고객지원 라우팅을 확인해야 합니다.
• 해외 거주 고객: 이웃 나라나 북미에서 일하면서 가족 연락과 은행 업무를 위해 +505 SIM을 유지하는 고객입니다.
• 니어쇼어 운영: 지원 또는 백오피스 직원이 비즈니스 계정을 관리하는데, 회사가 그 계정을 누군가의 개인 휴대폰에 묶고 싶지 않은 경우입니다.
• 핀테크 및 마켓플레이스 온보딩 검토: 팀들이 이런 테스트를 구성하는 방법은 핀테크 온보딩을 참고하세요.

어떤 서비스가 니카라과 번호로 코드를 보낼 수 있나요?

OTP Gateway를 통해 니카라과에서 1,000개가 넘는 서비스를 이용할 수 있습니다. 현재 인기 있는 서비스는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Uber, Discord 등입니다.

이 목록은 한 시점의 스냅샷입니다. 조합별 가용 여부는 하루 중에도 바뀌기 때문에, 고정된 표 대신 API가 실시간으로 알려 줍니다.

국가 `ni`의 API 호출은 어떤 모습인가요?

or_live_로 시작하는 Bearer 키로 https://otproute.com/api/v1에 인증합니다. 키는 개발자 콘솔에서 발급하며 계정당 최대 10개입니다. 니카라과의 국가 id는 ni입니다.

1. GET /api/v1/services로 서비스 id를 한 번 확인하고 GET /api/v1/countries로 국가를 확인합니다.
2. GET /api/v1/prices?country=ni&service=<id>로 실시간 가격을 조회하고, 서비스가 현재 제공되지 않으면 주문을 건너뜁니다.
3. POST /api/v1/activations에 {"service": "telegram", "country": "ni"}를 보내 주문하고, 반환된 활성화 id를 보관합니다.
4. +505 번호로 앱의 인증 단계를 진행합니다.
5. activation.sms_received 이벤트를 기다리거나 GET /api/v1/activations/{id}를 폴링합니다. 더 이상 필요 없는 테스트는 POST /api/v1/activations/{id}/cancel로 해제하세요.

모든 웹훅에는 t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature가 포함됩니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산해 검증하고, 타임스탬프가 오래된 요청은 버리세요. 재전송되어도 문제가 없도록 이벤트를 활성화 id 기준으로 처리하세요. 제한은 분당 300건이며 웹훅 엔드포인트는 최대 5개입니다. 자세한 내용은 개발자 문서와 OTP API 연동 가이드에 있습니다.

대시보드에서 +505 점검을 실행하는 방법과 코드가 오지 않을 때 대처법

개발자가 아니어도 같은 작업을 수동으로 할 수 있습니다. 니카라과와 서비스를 고르고, 표시된 가격을 확인한 뒤, 번호를 앱에 복사해 넣고 화면에 코드가 나타나기를 기다리면 됩니다.

활성화는 20분 동안 열려 있습니다. 그 시간 안에 SMS가 도착하지 않거나 직접 취소하면 전액이 자동으로 지갑에 돌아오며, 수신된 코드에 대해서만 비용을 내게 됩니다. 도착 시간은 서비스와 경로에 따라 다릅니다. 아무것도 오지 않으면 제한 시간이 끝날 때까지 기다린 다음, 새 주문을 연달아 넣지 말고 나중에 다시 시도하거나 다른 서비스 경로를 사용하세요. 또한 해당 단계에서 그 서비스가 가상 번호를 받아 주는지 확인하세요. 일부는 거부합니다. 모든 서비스의 약관을 지켜 주세요. OTP Route의 이용 정책(Acceptable Use Policy)이 적용됩니다.

니카라과 장기 번호를 쓸 수 있나요? 결제는 어떻게 하나요?

니카라과에는 셀프서비스 장기 회선이 없습니다. 월 $1.95부터 시작하는 Dedicated Virtual Number는 미국과 캐나다에서만 즉시 판매되며, 자세한 내용은 가상 번호에서 확인하세요. 지속적으로 사용할 +505 회선이 필요하면 [email protected]으로 문의해 주세요. 가능 여부는 현지 규정에 따라 달라집니다.

모든 비용은 요금제나 월 이용료 없이 하나의 선불 USD 지갑에서 결제되며, 카드 또는 USDT/USDC로 충전하고 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 개발 계정에는 요청 시 샌드박스 모드를 켤 수 있어, 시뮬레이션된 번호와 코드가 반환되므로 CI 실행이 지갑 잔액을 쓰지 않습니다. 회원가입에서 시작하세요.

자주 묻는 질문

니카라과에 있지 않아도 니카라과 SMS OTP 코드를 받을 수 있나요?

네. OTP Gateway가 어디서든 사용할 수 있는 +505 번호를 발급하며, 코드는 대시보드에 표시되거나 웹훅으로 전달됩니다.

API에서 니카라과의 국가 id는 무엇인가요?

POST /api/v1/activations의 country 필드와 가격 조회에서 ni를 사용합니다.

니카라과 번호가 코스타리카나 온두라스 번호와 혼동될 수 있나요?

국내 숫자만 저장하면 그럴 수 있습니다. 이웃 나라들도 8자리 번호를 쓰기 때문입니다. 항상 +505가 붙은 전체 E.164 형식으로 저장하세요.

니카라과 인증 번호는 얼마인가요?

서비스에 따라 코드당 $0.20부터입니다. 20분 안에 SMS가 오지 않거나 취소하면 자동으로 환불됩니다.

코드가 스페인어로 오나요?

자주 그렇지만, 서비스가 계정이나 기기 설정에서 언어를 고르므로 테스트가 특정 문구를 전제로 해서는 안 됩니다.

나중에 로그인하려고 +505 번호를 보유할 수 있나요?

셀프서비스 제품으로는 불가능합니다. 장기 Dedicated 회선은 미국과 캐나다 전용이며, 니카라과는 [email protected]으로 문의하세요.

OTP Route로 한 플랫폼에서 계정을 대량으로 만들어도 되나요?

아니요. 각 플랫폼의 약관 안에서, 실제 개인이나 사업체당 하나씩 본인의 정당한 제품과 계정을 테스트하고 운영하는 용도로만 사용하세요.

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