코드로 +595 번호를 요청하려면 어떻게 하나요?
개발자 콘솔에서 Bearer 키를 만드는 것부터 시작하세요. 키는 or_live_로 시작하며 최대 10개까지 보유할 수 있어, 스테이징과 CI용 키를 따로 쓰기 쉽습니다. 모든 호출은 https://otproute.com/api/v1로 보냅니다.
GET /api/v1/services와GET /api/v1/countries의 카탈로그를 캐시합니다. 파라과이는py로 표시됩니다.- 주문하기 전마다
GET /api/v1/prices?country=py&service=<id>를 읽습니다. 가격과 가용성은 상수가 아니라 실시간 값입니다. POST /api/v1/activations에{"service": "whatsapp", "country": "py"}로 주문합니다. 응답의 활성화 ID를 보관하세요.- 테스트하는 흐름에 번호를 입력합니다.
- 웹훅을 기다리거나
GET /api/v1/activations/{id}를 확인합니다. 테스트가 일찍 끝나면POST /api/v1/activations/{id}/cancel을 호출합니다.
GET /api/v1/balance는 파이프라인의 사전 점검 단계로 유용합니다. 잔액이 비었을 때 작업이 시간 초과로 끝나는 대신 분명하게 실패하게 만들 수 있습니다. 연동 가이드에서 같은 호출을 더 많은 맥락과 함께 단계별로 살펴볼 수 있습니다.
웹훅 핸들러는 파라과이 코드를 어떻게 처리해야 하나요?
엔드포인트는 메시지가 도착하면 activation.sms_received를, 코드 없이 유효 시간이 끝나면 activation.expired를, 취소 후에는 activation.cancelled를 받습니다. 각 이벤트는 활성화 ID에 연결됩니다.
- 먼저 검증하세요.
X-OTPRoute-Signature를t와v1로 나누고, 엔드포인트 시크릿으로 타임스탬프, 점, 원본 요청 본문을 이어 붙인 값의 HMAC-SHA256을 계산해 상수 시간으로 비교합니다. - 오래된 요청은 거부하세요. 시계와 크게 차이 나는 타임스탬프는 재전송 공격이거나 서버 시간이 크게 어긋났다는 뜻입니다.
- 멱등성을 갖추세요. 활성화 ID를 저장하고 중복은 무시해서, 재시도된 전달이 코드를 두 번 처리하지 않도록 합니다.
계정당 웹훅 엔드포인트는 최대 5개까지 허용됩니다. 폴링을 선호한다면 간격을 적당히 유지하세요. 한도는 계정 전체 기준 분당 300건입니다. HMAC 웹훅 가이드에 더 자세한 체크리스트가 있습니다.
파라과이 경로에서는 어떤 서비스를 쓸 수 있나요?
파라과이는 현재 1,600개가 넘는 서비스를 제공합니다. 가장 많이 요청되는 서비스로는 WhatsApp, Instagram, Telegram, Uber, Facebook, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, X (Twitter), Discord, LinkedIn, Netflix, ChatGPT (OpenAI)가 있습니다. WhatsApp은 이 지역 많은 사람들의 일상적인 메신저이므로, 채팅 기반 고객 지원을 테스트할 때 팀이 가장 먼저 인증하는 서비스인 경우가 많습니다.
+595 휴대전화 번호는 어떻게 쓰고 정규화하나요?
파라과이는 국내 전화에 접두 번호 0을 쓰므로, 현지에서 보이는 휴대전화 번호는 09로 시작합니다. E.164에서는 이 0이 사라지고, 표준 형식은 +595 뒤에 9자리가 오며 휴대전화는 9로 시작합니다. 입력 시점에 정규화하고, E.164 형식만 저장하며, 표시용 서식은 가장자리에서 적용하세요. 다른 나라의 고정 길이를 기대하는 검증 규칙이 파라과이 사용자의 가입이 실패하는 흔한 원인이므로, 검증 테스트 케이스에 +595 번호를 포함하세요.
스페인어와 과라니어가 모두 공용어입니다. 국제 서비스가 보내는 인증 메시지는 템플릿과 계정 설정에 따라 스페인어나 영어로 오는 경향이 있습니다. 숫자만 잡는 패턴으로 코드를 파싱하고, 악센트 문자와 ñ가 로그에서도 유지되도록 메시지 본문을 UTF-8로 보관하세요.
팀이 파라과이에서 계정을 인증하는 이유는 무엇인가요?
파라과이는 메르코수르의 일원이며 아르헨티나, 브라질, 볼리비아 사이에 있어서, 이미 이 지역에서 운영하는 회사들이 남미 확장 계획에 흔히 추가합니다. 이곳에서 테스트하는 전형적인 이유로는 파라과이 사용자를 위한 스페인어 현지화 QA, 지역 온보딩 흐름이 +595 번호를 받아주는지 확인, 현지 고객의 비즈니스 프로필을 인증하는 운영 팀, 본국 번호로 가입하는 해외 거주 파라과이 사람들에 대한 지원이 있습니다. 모바일 앱 인증 페이지에서 이런 점검이 릴리스 테스트에 어떻게 들어맞는지 설명합니다.
코드 없이 파라과이 인증 번호를 받는 방법이 있나요?
네. 대시보드에서 OTP Gateway를 열고 파라과이와 서비스를 선택한 뒤, 가격을 확인하고 확정하세요. 번호를 앱에 복사하고 그 옆에 코드가 나타날 때까지 활성화를 열어 두세요. 브라우저 주문과 API 주문은 같은 지갑과 기록을 사용합니다.
+595 코드가 나타나지 않을 때 도움이 되는 방법은?
결론을 내리기 전에 활성화에 20분 전체를 주세요. 아무것도 없이 끝나면 요금은 자동으로 환불됩니다. 그다음 일반적인 원인을 살펴보세요. 서비스가 가상 번호를 거부할 수도 있고, 그 시간대에 경로가 혼잡할 수도 있으며, 나중에는 다른 서비스 경로가 성공할 수도 있습니다. 반복 주문을 짧은 간격으로 연달아 보내지 마세요. 시도 사이에 백오프를 두고 활성화 ID를 기록하면 서비스별 패턴을 찾을 수 있습니다.
파라과이 번호를 장기 보유할 수 있나요? 결제는 어떻게 하나요?
파라과이에는 셀프 서비스 장기 회선을 판매하지 않습니다. 전용 가상 번호(Dedicated Virtual Numbers)는 미국과 캐나다에만 있으며 월 $1.95부터입니다(From $1.95/month). 그래서 계속 로그인해야 하는 계정은 그 번호 중 하나에 두는 경우가 많습니다. 파라과이 장기 회선에 대해 문의하려면 [email protected]으로 이메일을 보내세요. 답변은 현지 규정에 따라 달라집니다.
결제는 하나의 선불 USD 지갑을 사용합니다. 카드 또는 USDT/USDC로 충전하고, 이메일로 PDF 청구서를 받으며, 실제로 도착한 코드에 대해서만 비용을 냅니다. 요청하면 개발 계정을 샌드박스로 전환해 시뮬레이션된 번호와 코드를 받을 수 있습니다. OTP Route는 자사의 정상적인 제품을 테스트하고 운영하기 위한 서비스입니다. 각 서비스의 약관과 허용 사용 정책(Acceptable Use Policy)을 따르세요.
자주 묻는 질문
OTP Route API에서 파라과이의 국가 ID는 무엇인가요?
py입니다. 가격 조회와 POST /api/v1/activations의 본문에 사용하세요.
파라과이 번호를 09 접두로 저장해야 하나요?
아니요. 국내 0을 빼고 +595 뒤에 9자리 국내 번호를 붙여 저장하세요.
테스트용 +595 번호는 비용이 얼마나 드나요?
파라과이 활성화는 서비스에 따라 코드당 $0.20부터이며, 지갑은 실제로 도착한 코드에 대해서만 차감됩니다.
현지 SIM 없이 파라과이용 스페인어 가입 흐름을 테스트할 수 있나요?
네. OTP Gateway에서 파라과이 인증 번호를 주문하고 대시보드나 API로 코드를 읽으세요.
코드가 과라니어로 오나요?
거의 없습니다. 국제 서비스는 보통 스페인어나 영어 텍스트를 보내므로 숫자만 파싱하세요.
활성화가 만료되면 내 돈은 어떻게 되나요?
20분의 유효 시간 안에 SMS가 도착하지 않으면 전액이 자동으로 지갑으로 돌아갑니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.