한국어
테스트와 운영을 위한 과테말라(+502) 인증 번호
네, OTP Route는 OTP Gateway의 일회용 번호로 과테말라(+502) SMS 인증 코드를 받을 수 있으며, 각 코드를 대시보드에서 읽거나 API와 서명된 웹훅으로 수집할 수 있습니다. 코드는 $0.20 이상이며 모든 서비스의 실시간 가격은 주문 전에 표시되고, 20분 안에 아무것도 오지 않으면 요금이 지갑으로 환불됩니다.
과테말라가 전용 테스트 실행을 할 만한 이유는 무엇인가요?
과테말라는 중앙아메리카에서 인구가 가장 많은 나라이며, 많은 팀에게 스페인어권 지역 출시의 첫 시장입니다. 공용어는 스페인어이지만 인구의 상당수가 여러 마야 언어 중 하나도 사용하므로, 온보딩 문구나 지원 콘텐츠가 스페인어를 넘어선다면 이 점이 중요합니다.
세 가지 상황이 반복해서 나옵니다.
- 지역 출시에서는 전화번호 입력 화면, 스페인어 SMS 문구, 인증 단계를 실제 +502 경로에서 점검해야 합니다(모바일 앱 인증).
- 디아스포라 제품, 예를 들어 미국에 사는 과테말라인이 쓰는 송금 또는 통화 앱은 계정이 본국 번호에 묶여 있습니다.
- 운영 팀은 과테말라 고객의 비즈니스 프로필을 관리하면서 누구의 개인 휴대전화도 연결하고 싶어 하지 않습니다(운영 팀).
과테말라 전화번호는 어떤 형식인가요?
과테말라는 8자리 국내 번호를 쓰며 트렁크 접두사가 없으므로 제거할 앞자리 0이 없습니다. E.164 형식은 +502 뒤에 그 8자리를 붙인 것이며, +502 xxxx xxxx로 표기합니다.
이렇게 짧은 길이는 10자리 북미 번호를 염두에 두고 작성된 양식 검증기를 곤란하게 합니다. 8자리 입력, 더하기 기호 없이 502를 입력하는 사용자, 중간에 공백이나 대시가 들어간 경우에 대한 테스트 케이스를 추가하세요. 정규화된 E.164 문자열을 저장하고, 휴대전화와 유선전화가 같은 8자리를 쓰기 때문에 길이만으로 어느 쪽인지 추측하지 마세요.
API로 과테말라 SMS OTP 코드를 받을 수 있나요?
네. 과테말라 OTP API는 기본 URL https://otproute.com/api/v1에서 국가 id gt를 사용하며, or_live_ 접두사의 Bearer 키로 인증합니다.
먼저 GET /api/v1/services로 서비스 id를 찾은 다음 GET /api/v1/prices?country=gt&service=<id>로 현재 견적을 확인하세요. {"service": "<id>", "country": "gt"}를 본문으로 POST /api/v1/activations를 호출해 번호를 만듭니다. 앱이 SMS를 보내면 GET /api/v1/activations/{id}를 폴링하거나 웹훅 엔드포인트가 activation.sms_received를 받게 하세요. OTP 웹훅 보안에 설명된 대로 타임스탬프와 원문 본문에 대한 HMAC-SHA256인 X-OTPRoute-Signature 헤더를 검증하고 오래된 타임스탬프는 거부하세요. 한도(키 10개, 웹훅 엔드포인트 5개, 분당 요청 300회)는 개발자 개요에 나와 있습니다.
지금 +502 경로에는 어떤 서비스가 있나요?
과테말라에는 1,600개가 넘는 서비스가 등록되어 있습니다. 현재 스냅샷의 인기 서비스는 WhatsApp, Facebook, TikTok, Telegram, Instagram, Google(Gmail & YouTube), X(Twitter), Uber, Amazon, Discord, LinkedIn, Signal, Netflix, Microsoft & Outlook입니다. 재고는 하루 중에 순환하므로 API는 고정된 카탈로그가 아니라 실시간 이용 가능 여부를 반환합니다.
지원 및 운영 담당자를 위한 노코드 경로가 있나요?
이메일과 6자리 코드 또는 Google 로그인으로 가입하면 팀원 누구나 대시보드에서 주문할 수 있습니다. 과테말라를 고르고 서비스를 선택한 뒤 표시된 가격을 확인하고 +502 번호를 앱에 복사해 넣으세요. 코드는 도착하면 같은 화면에 나타납니다. 공유 팀 접근에는 OTP Route 계정 자체에 2단계 인증(TOTP)을 켜 두는 것이 좋습니다.
+502 코드가 나타나지 않았는데 무엇을 시도해야 하나요?
번호는 20분 동안 활성 상태로 유지되며, 코드가 전달되었을 때만 요금이 적용됩니다. 제한 시간이 끝나거나 취소하면 전액이 자동으로 지갑으로 돌아옵니다.
- 제한 시간이 끝날 때까지 기다리세요. 전달 시간은 서비스와 경로에 따라 다릅니다.
- 나중에 다시 시도하거나, 다른 서비스 경로가 제공된다면 그 경로로 시도하세요.
- 서비스가 가상 번호를 받아 주는지 확인하세요. 거부하는 곳도 있습니다.
- 빠른 루프로 새 주문을 보내지 말고 시도 사이에 백오프를 두세요.
과테말라 장기 번호, 결제, 샌드박스는 어떤가요?
OTP Route에는 셀프서비스 과테말라 장기 번호가 없습니다. 전용 회선은 미국과 캐나다에서만 월 $1.95부터 제공됩니다. 고정된 +502 회선이 필요하면 [email protected]으로 이메일을 보내 주세요. 가능한 범위는 현지 규정에 달려 있으며 보장되지 않습니다.
결제는 요금제나 월 요금이 없는 선불 USD 지갑 하나로 이루어지며, 카드 또는 USDT/USDC로 충전하고 충전마다 PDF 인보이스가 이메일로 발송됩니다. 연동 작업에는 요청 시 개발 계정을 샌드박스로 전환해, 시뮬레이션된 번호와 코드가 비용 없이 코드를 통과하게 할 수 있습니다.
자주 묻는 질문
현지 SIM 없이 과테말라용 스페인어 가입 흐름을 점검할 수 있나요?
네. OTP Gateway에서 gt 번호를 주문해 앱에 입력하고, 대시보드나 웹훅에서 스페인어 코드를 읽으세요.
과테말라 번호에는 앞의 0이 필요한가요?
아니요. 과테말라에는 트렁크 접두사가 없으므로 번호는 +502에 8자리를 붙인 것입니다.
+502 코드의 최저 비용은 얼마인가요?
가격은 코드당 $0.20부터 시작합니다. 특정 서비스의 금액은 GET /api/v1/prices가 반환하며 확정하기 전에 표시됩니다.
인증 SMS가 오지 않으면 요금이 청구되나요?
아니요. 20분 제한 시간 안에 코드가 전달되지 않거나 취소하면 전액이 지갑으로 돌아갑니다.
OTP Route가 팀을 위해 같은 +502 번호를 장기간 유지해 줄 수 있나요?
셀프서비스로는 안 됩니다. OTP Gateway 번호는 코드 한 건용이고 장기 회선은 미국과 캐나다에서만 제공되므로, 과테말라는 [email protected]에 문의하세요.
이 번호를 쓸 때 어떤 규칙이 적용되나요?
각 서비스의 자체 약관과 OTP Route 이용 정책(Acceptable Use Policy)입니다. 번호는 테스트하거나 본인의 합법적인 제품과 비즈니스 계정을 운영하는 데에만 사용하세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.