OTP Route 번호로 API를 통해 Zalo OTP 받기

Zalo 인증 코드 API 흐름은 어떤 모습인가요?

서비스 ID는 zalo입니다. 호출은 개발자 콘솔에서 발급받은 접두사 or_live_의 Bearer 키로 https://otproute.com/api/v1에 보냅니다.

1. GET /api/v1/countries에서 국가 ID를 가져옵니다. 예를 들어 베트남은 vn입니다.
2. GET /api/v1/prices?country=vn&service=zalo로 실시간 가격과 가용 여부를 확인합니다.
3. 활성화를 생성합니다. POST /api/v1/activations에 {"service": "zalo", "country": "vn"}를 보내고, 활성화 ID와 반환된 번호를 저장합니다.
4. 직접 관리하는 테스트 계정의 Zalo 전화번호 화면에 번호를 입력합니다.
5. 웹훅이나 폴링으로 코드를 수집하거나, POST /api/v1/activations/{id}/cancel로 주문을 종료합니다.

테스트 스위트를 시작할 때 GET /api/v1/balance로 잔액을 확인하면 실행 도중 낭패를 피할 수 있습니다. 요청 형식은 API 문서에서 자세히 볼 수 있습니다.

Zalo 코드를 위한 웹훅 수신기 만들기

개발자 콘솔에 엔드포인트를 등록하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요. 각 요청에는 t=<unix>,v1=<hex> 형태의 X-OTPRoute-Signature 헤더가 있습니다. 엔드포인트 시크릿으로 <t>.<raw body>에 대한 HMAC-SHA256을 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프는 거부하세요.

저장하는 결과를 활성화 ID로 키잉해서 핸들러를 멱등하게 만드세요. 같은 이벤트가 두 번 전달되면 두 번째 쓰기는 아무 일도 하지 않아야 합니다. 공개 엔드포인트가 없는 팀은 대신 GET /api/v1/activations/{id}를 폴링할 수 있으며, 분당 300건이라는 한도는 여러 병렬 테스트에서 짧은 폴링 간격을 두기에 충분합니다.

Zalo는 언제 전화번호를 요구하나요?

Zalo는 베트남의 메시징 및 소셜 앱이며, 전화번호가 계정의 주된 식별자 역할을 합니다. 코드는 보통 계정을 만들 때, 새 기기에서 로그인할 때, 접근 권한을 복구할 때 요청됩니다. 정확한 안내 화면은 Zalo가 정하며 바뀔 수 있으므로, 테스트 계획은 고정된 순서를 가정하지 말고 각 화면을 다뤄야 합니다.

QA 팀에게 이것이 중요한 이유는, Zalo를 중심으로 만든 메시징 연동, 미니 앱, 고객지원 채널은 다른 시나리오를 실행하기 전에 새로 인증된 테스트 계정이 필요한 경우가 많기 때문입니다.

OTP Route에서 어느 국가가 Zalo OTP를 받을 수 있나요?

Zalo 경로는 198개국에 등록되어 있습니다. 베트남, 미국, 일본, 대한민국, 대만, 호주, 캐나다, 캄보디아, 라오스, 태국, 말레이시아, 싱가포르, 독일, 프랑스, 영국 등이 포함됩니다.

테스트하는 계정에 맞는 국가를 고르세요. 베트남 출시에는 현지 사용자가 보는 것을 재현하기 위해 +84 번호가 필요하고, 해외 베트남 커뮤니티를 대상으로 하는 팀은 그 고객들이 사는 국가의 번호가 필요할 수 있습니다. 국가는 가격과 가용 상태에도 영향을 주므로 가격 엔드포인트부터 확인하는 것이 좋습니다.

Zalo SMS 인증 테스트를 위한 대시보드 단계

프로젝트의 모든 사람이 코드를 작성하는 것은 아닙니다. 대시보드에서 서비스로 Zalo를 고르고 국가를 선택한 뒤 표시된 가격을 확인하고 주문하세요. 번호를 Zalo에 복사하면 SMS가 도착했을 때 주문 옆에 코드가 나타납니다. 같은 화면에서 취소하면 전액이 환불됩니다. 대시보드 가입에는 이메일 주소와 6자리 이메일 코드 또는 Google 로그인이 필요하며, 팀 로그인은 TOTP 2단계 인증으로 보호할 수 있습니다.

Zalo 코드가 도착하지 않을 수 있는 이유는 무엇인가요?

전송은 서비스와 경로에 따라 달라지므로 정해진 대기 시간은 없습니다. Zalo가 일부 가상 번호를 거부할 수도 있으며, 환불 규칙이 있는 이유가 바로 그것입니다. 아무것도 나타나지 않는다면 다음과 같이 하세요.

• 20분의 제한 시간이 끝날 때까지 주문을 열어 두거나 취소하세요. 어느 쪽이든 지갑으로 돈이 돌아옵니다.
• 나중에 다시 시도하거나, 테스트에 맞는 다른 국가로 바꿔 보세요.
• 짧은 반복문으로 다시 주문하지 마세요. 자동화 작업에는 백오프를 추가하세요.
• 테스트 계정 자체가 Zalo 쪽에서 차단되거나 요청 제한에 걸리지 않았는지 확인하세요.

Zalo 테스트 계정에는 전용 번호를 써야 할까요?

OTP Gateway 번호는 코드 한 개만 처리합니다. 스테이징이나 지원 계정이 다음 달에 다시 로그인해야 한다면 전용 번호가 더 알맞습니다. 갱신되는 동안 계속 보유할 수 있는 미국 또는 캐나다 회선으로 월 $1.95부터이며, 수신 SMS는 대시보드와 number.sms_received 웹훅으로 받습니다. 자세한 내용은 가상 번호에서 확인하세요.

어느 쪽이든 책임 있게 사용하세요. Zalo의 약관을 따르고, 실제 개인 또는 사업체당 계정 하나만 유지하며, OTP Route는 정당한 자사 계정과 제품을 테스트하고 운영하는 용도로만 쓰세요. Zalo는 해당 소유자의 상표이며 OTP Route는 Zalo와 제휴 관계가 없습니다.

자주 묻는 질문

OTP Route API에서 Zalo의 서비스 ID는 무엇인가요?

zalo이며, POST /api/v1/activations의 본문에 국가 ID와 함께 보냅니다.

베트남 밖의 번호로도 Zalo OTP를 받을 수 있나요?

네. Zalo 경로는 198개국에 등록되어 있으며, 국가별 가용 상태는 가격 엔드포인트가 실시간으로 반환합니다.

Zalo가 가상 번호를 거부해도 요금이 부과되나요?

아니요. 20분 안에 번호로 코드가 도착하지 않거나 취소하면 전액이 지갑으로 환불됩니다.

장기간 필요한 계정에 Zalo용 가상 번호가 적합한가요?

일회용 번호는 적합하지 않습니다. 반복 로그인에는 갱신되는 동안 보유할 수 있는 미국 또는 캐나다 전용 번호가 더 안전한 선택입니다.

테스트용 Zalo SMS 인증 비용은 어떻게 결제하나요?

선불 USD 지갑을 카드 또는 USDT/USDC로 충전하세요. 월 요금은 없고, 충전할 때마다 PDF 인보이스가 제공됩니다.

돈을 쓰지 않고 Zalo 연동을 시험해 볼 수 있나요?

네. 지원팀이 개발 계정을 샌드박스로 전환하면 Zalo 주문이 시뮬레이션된 번호와 코드를 반환하므로, 실제 비용을 쓰기 전에 웹훅과 폴링 코드를 검증할 수 있습니다.

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