한국어
웹훅과 폴링으로 구성하는 +592 인증 테스트
네. OTP Route는 일회용 OTP Gateway 번호로 가이아나(+592) 인증 코드를 받을 수 있으며, 각 코드는 대시보드에서 읽거나 REST 폴링 또는 서명된 웹훅으로 자체 시스템에 가져올 수 있습니다. 주문은 코드당 $0.20 부터 시작하고 실시간 가격은 API가 반환하며, 20분 안에 SMS가 오지 않은 활성화는 전액 환불됩니다.
웹훅 우선 방식의 가이아나 OTP API 흐름은 어떻게 설계하나요?
일회성 확인을 넘어서는 작업이라면 계속 물어보는 대신 플랫폼이 코드를 푸시하도록 하세요. 개발자 콘솔에서 HTTPS 엔드포인트를 추가하고(계정당 5개까지 가능) activation.sms_received와 함께 activation.expired, activation.cancelled도 구독하면, 테스트 러너가 성공뿐 아니라 막다른 길도 즉시 알 수 있습니다.
들어오는 모든 요청은 검증을 통과하기 전까지 신뢰하지 마세요.
t=<unix>,v1=<hex>형태의X-OTPRoute-Signature헤더를 읽습니다.- 타임스탬프, 점, 수정하지 않은 요청 본문을 이어 붙인 문자열에 엔드포인트 시크릿으로 HMAC-SHA256을 계산합니다.
- 계산한 다이제스트를
v1과 상수 시간 방식으로 비교하고, 타임스탬프가 오래되었다면 요청을 폐기합니다. - 이벤트에서 활성화 ID를 찾아, 이미 처리한 것이면 성공을 반환하고 더 이상 아무것도 하지 않습니다.
마지막 규칙 덕분에 핸들러가 멱등성을 갖게 되어, 네트워크 문제 후 재전송이 와도 테스트가 흔들리지 않습니다. 더 자세한 내용은 웹훅 기반 OTP 수집에서 볼 수 있습니다.
+592 주문에는 어떤 엔드포인트와 ID를 쓰나요?
개발자 콘솔에서 발급한 Bearer 키로 인증하세요. 라이브 키는 or_live_로 시작하며 계정당 최대 10개까지 보관할 수 있습니다. 기본 URL은 https://otproute.com/api/v1이고 가이아나의 국가 ID는 gy입니다.
일반적인 실행은 먼저 GET /api/v1/prices?country=gy&service=<id>를 읽습니다. 이 경로의 가격과 이용 가능 여부는 상수가 아니라 실시간 값이기 때문입니다. 이어서 POST /api/v1/activations에 {"service": "<id>", "country": "gy"}를 보내면 +592 번호와 활성화 ID가 돌아옵니다. 웹훅이 없다면 러너가 몇 초마다 GET /api/v1/activations/{id}를 폴링하며, 이는 분당 300건 상한보다 훨씬 낮은 수준입니다. 테스트가 중단되면 정리 단계에서 POST /api/v1/activations/{id}/cancel을 호출하고, 사전 점검으로 GET /api/v1/balance를 호출해 지갑 잔액이 부족하면 스위트를 일찍 멈춥니다. 서비스 ID는 GET /api/v1/services에서 가져오며, 개발자 허브에서 이 SMS 인증 API용 클라이언트 예제를 볼 수 있습니다.
+592 번호는 저장용으로 어떻게 포맷하나요?
가이아나는 국가 코드 592와 7자리 국내 번호를 사용하며 제거해야 할 트렁크 접두사가 없으므로, E.164 형식은 +592 뒤에 그 7자리를 붙인 것입니다. 보통 숫자를 3자리와 4자리 묶음으로 씁니다.
없애야 할 앞자리 0이 없으므로 정규화는 공백과 대시를 지우고, 사용자가 지역 번호만 입력했을 때 국가 코드를 붙이는 정도로 끝납니다. 흔한 버그는 모든 남미 번호에 지역 번호가 있다고 가정하거나 최소 길이를 7자리보다 크게 설정해 올바른 가이아나 입력을 거부하는 양식입니다. 테스트용 +592 번호를 쓰면 이런 문제가 금방 드러납니다. E.164 문자열을 저장하고, 현지 형식은 표시할 때만 적용하세요.
가이아나 SMS OTP 코드를 받을 수 있는 서비스는 무엇이고, 수동으로 주문할 수도 있나요?
가이아나 경로에는 900개 이상의 서비스가 나열되어 있습니다. 자주 요청되는 서비스로는 WhatsApp, Facebook, Instagram, Google(Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix, Claude가 있습니다. 이 목록은 실시간 카탈로그의 스냅샷이므로, 특정 발신자를 중심으로 테스트를 계획하기 전에 API나 대시보드로 확인하세요.
코드를 작성하지 않는 동료에게는 대시보드가 같은 역할을 합니다. 로그인해서 OTP Gateway를 열고 가이아나와 서비스를 고른 뒤 가격을 확인하고 주문하세요. 가이아나 인증 번호가 20분 카운트다운과 함께 표시되고, 코드가 도착하면 그 옆에 나타납니다.
+592 코드가 늦거나 오지 않으면 테스트는 어떻게 해야 하나요?
활성화는 20분 동안 열려 있습니다. 그 창 안에 코드가 도착한 경우에만 요금을 내며, 만료되거나 취소하면 지원 티켓 없이 전액이 지갑으로 돌아옵니다.
자동화된 실행에서의 합리적인 처리 방법입니다.
- 테스트에 엄격한 시간 제한이 없다면 실패로 판단하기 전에 창이 끝날 때까지 기다립니다. 시간 제한이 있다면 명시적으로 취소합니다.
- 나중에 다시 시도하거나, API가 제공한다면 다른 서비스 경로로 전환합니다.
- 대상 서비스가 가상 번호를 받아주는지 확인합니다. 일부는 거부하며, 환불은 바로 그런 경우를 위한 것입니다.
- 빠르게 반복 주문하지 말고 백오프를 두고 재시도합니다.
대체 경로를 고르는 방법은 OTP 국가 라우팅 가이드에 설명되어 있습니다.
팀들은 왜 가이아나 가입 흐름을 테스트하나요?
가이아나는 영어를 공용어로 쓰는 유일한 남미 국가이고 조지타운에 카리브 공동체(CARICOM) 사무국이 있어서, 카리브 공동체를 하나의 시장으로 보는 출시 계획에 자주 포함됩니다. 빠르게 성장하는 해양 에너지 산업이 해외 계약업체와 공급업체를 끌어들였고, 미국, 캐나다, 영국의 큰 디아스포라 덕분에 송금, 메시징, 여행 앱이 +592 번호로 활발히 쓰입니다. 가이아나 크리올어가 일상에서 널리 쓰이지만 인증 문자는 대체로 영어로 도착합니다. QA 관점에서는 번역된 문구보다 번호 입력, 국가 선택기, SMS 수신 동의 문구에 노력을 집중하게 됩니다. 모든 확인은 조직이 소유한 계정으로만 하고, 각 서비스의 약관을 따르며, OTP Route의 이용 정책이 모든 주문에 적용된다는 점을 기억하세요.
가이아나 번호를 계속 보유할 수 있나요? 사용 요금은 어떻게 청구되나요?
가이아나에서는 셀프서비스 장기 번호를 제공하지 않습니다. OTP Route의 전용 번호는 미국과 캐나다에서만 월 $1.95부터 이용할 수 있습니다. +592 회선이 필요하면 [email protected]으로 이메일을 보내세요. 팀이 현지 규정이 허용하는 범위를 확인해 드리지만 보장은 없습니다.
결제는 하나의 선불 USD 지갑으로 이루어집니다. 월 사용료도 요금제도 없고, 카드 또는 USDT/USDC로 충전하며, 충전마다 PDF 인보이스가 이메일로 발송됩니다. 요청하면 개발 계정을 샌드박스로 전환할 수 있어, 통합 테스트를 모의 번호와 코드로 실행하며 잔액은 그대로 유지됩니다. 서비스별 요금은 요금 페이지에서 확인할 수 있습니다.
자주 묻는 질문
가이아나 통신사 SIM 없이 앱의 가이아나 가입을 확인할 수 있나요?
네. OTP Gateway에서 서비스용 +592 번호를 주문해 흐름에 입력하면, 코드가 대시보드에 표시되거나 웹훅으로 전달됩니다. 가격은 코드당 $0.20부터 시작합니다.
API에서 가이아나의 국가 ID는 무엇인가요?
gy입니다. 가격 조회 쿼리와 활성화 요청 본문 모두에서 사용합니다.
가이아나 번호에서 앞자리 0을 제거해야 하나요?
아니요. 가이아나에는 트렁크 접두사가 없으므로 E.164 형식은 +592 뒤에 7자리 번호를 붙인 것입니다.
+592 인증 메시지는 어떤 언어로 오나요?
보통 공용어인 영어입니다. 다만 문구는 발신 서비스가 정하므로 앱의 언어 설정을 따를 수도 있습니다.
서비스가 SMS를 끝내 보내지 않으면 환불되나요?
네, 자동으로 환불됩니다. 코드 없이 20분이 지나거나 취소하면 전액이 지갑으로 돌아갑니다.
돈을 쓰지 않고 전체 연동을 테스트할 수 있나요?
지원팀에 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 모의 번호와 코드가 반환되므로 API 호출과 웹훅을 처음부터 끝까지 실행해 볼 수 있습니다.
장기 +592 번호를 쓸 수 있나요?
셀프서비스 상품으로는 제공되지 않습니다. 전용 번호는 미국과 캐나다에서만 판매되며, 가이아나는 [email protected]으로 문의하세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.