제품 팀은 왜 테스트용 +60 번호가 필요할까요?
말레이시아는 동남아시아 시장 진출의 첫 번째 거점으로 자주 선택됩니다. 이용자는 마켓플레이스, 차량 호출, 메시징 앱을 넘나들고, 이런 서비스 대부분이 가장 먼저 전화번호부터 확인합니다. 베를린이나 벵갈루루에 있는 QA 엔지니어는 자국 SIM으로 이 단계를 재현할 수 없고, 쿠알라룸푸르의 동료에게 코드를 전달해 달라고 부탁하는 방식은 규모를 감당하지 못합니다. OTP Route는 한 번에 코드 하나를 받을 수 있는 말레이시아 번호를 제공하므로, OTP 라우팅 단계를 수작업이 아니라 테스트 스위트의 일부로 만들 수 있습니다.
말레이시아 OTP 연동을 위한 준비 체크리스트
첫 실제 주문 전에 아래 항목을 확인하세요.
- 개발자 콘솔에서
or_live_키를 만드세요. 환경마다 키를 하나씩 두면 감사 추적이 깔끔해집니다. - 웹훅 엔드포인트를 등록하고 서명 검증을 구현하세요. 아니면 분당 300건 요청 한도보다 훨씬 낮게 유지되는 폴링 간격을 정하세요.
- 아직 운영 번호가 필요한지 판단하세요. 개발 계정은 요청 시 샌드박스로 전환할 수 있으며, 샌드박스에서는 비용 없이 시뮬레이션된 번호와 코드가 반환됩니다.
012-345 6789같은 현지 형식을+60123456789로 바꿔 주는 전화번호 정규화 로직을 추가하세요.- 테스트 대상 앱이 가상 번호를 허용하는지 확인하세요. 허용하지 않는 앱은 어떤 라우트로도 해결할 수 없으며, 아무것도 도착하지 않으면 지갑으로 환불됩니다.
말레이시아 라우트에서 이용 가능한 서비스
말레이시아는 OTP Route에서 비교적 폭넓은 대상 국가 중 하나로, 현재 스냅샷 기준 2,700개 넘는 서비스가 제공됩니다. 지역 커머스가 두드러져서 Shopee, Lazada, Tokopedia가 WeChat, LINE, Telegram, WhatsApp 같은 메시징 앱과 함께 있습니다. Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, Amazon, ChatGPT (OpenAI), Discord 등 글로벌 플랫폼도 포함됩니다.
가용 여부는 계속 바뀌므로 목록을 코드에 고정하지 말고 실행 시점에 GET /api/v1/services와 GET /api/v1/countries를 조회하세요. 마켓플레이스 팀은 마켓플레이스 솔루션 페이지에서 더 자세한 내용을 볼 수 있습니다.
API로 말레이시아 코드를 주문하고 읽는 방법
모든 호출은 Bearer 키와 함께 https://otproute.com/api/v1로 보냅니다. 말레이시아의 국가 ID는 my입니다.
- 가격 확인:
GET /api/v1/prices?country=my&service=<id>. - 액티베이션 생성:
POST /api/v1/activations에{"service": "<id>", "country": "my"}를 전송합니다. - 반환된 +60 번호를 앱의 전화번호 입력란에 넣고 SMS 발송을 트리거합니다.
- 웹훅으로
activation.sms_received를 받으세요. 공개 엔드포인트가 없다면 일정한 간격으로GET /api/v1/activations/{id}를 폴링합니다. activation.expired와activation.cancelled도 처리해서, 테스트가 실패가 아니라 판단 불가로 표시되게 하세요.
서명 헤더는 X-OTPRoute-Signature: t=<unix>,v1=<hex> 형태입니다. 타임스탬프, 점, 원본 본문을 이어 붙여 HMAC-SHA256을 다시 계산한 뒤 비교하고, 오래된 타임스탬프는 거부하세요. 이유는 HMAC으로 OTP 웹훅 보호하기 글에 정리되어 있고, 레퍼런스는 개발자 허브에서 찾을 수 있습니다.
운영 및 그로스 담당자를 위한 대시보드 경로
출시 팀 모두가 코드를 쓰는 것은 아닙니다. 대시보드에서 말레이시아를 선택하고 서비스를 고른 뒤 실시간 가격을 확인하고 주문을 확정하세요. +60 번호를 앱에 붙여 넣고 SMS를 요청한 다음 액티베이션 카드를 지켜보면, 코드가 도착하는 즉시 그곳에 표시됩니다. 마음이 바뀌면 취소하세요. 보류된 금액은 잔액으로 돌아옵니다.
말레이시아 코드가 도착하지 않을 때
먼저 기다려 보세요. 액티베이션은 20분 동안 열려 있고, 앱 안에서 재전송만 해도 해결되는 경우가 많습니다. 그래도 도착하지 않으면 다음을 시도하세요.
- 나중에 다시 시도하거나, 테스트 케이스가 다른 시장을 허용한다면 싱가포르 같은 인근 라우트로 바꿔 보세요.
- 해당 서비스가 말레이시아 가입에 대해 가상 번호를 거부하기 시작했는지 확인하세요.
- 새 액티베이션을 빠른 루프로 연속 생성하지 마세요. 요청만 낭비되고 결과는 거의 달라지지 않습니다.
빈 윈도우는 비용이 들지 않습니다. 액티베이션이 만료되거나 취소되면 전액이 지갑으로 돌아옵니다.
번호 형식, 메시지 언어, 현지 사정
말레이시아는 국내 통화 시 트렁크 접두어 0을 사용하므로, 012-345 6789로 적힌 휴대폰 번호는 국제 형식으로 +60 12-345 6789가 됩니다. 휴대폰 번호는 국가 코드 뒤에 1로 시작하며 9~10자리입니다. 공백, 대시, 맨 앞의 0을 제거한 뒤 E.164 형식으로 저장하세요.
말레이어가 국어이고 비즈니스에서는 영어가 널리 쓰이며, 규모가 큰 중국어 및 타밀어 사용 커뮤니티가 앱 현지화에 영향을 줍니다. 인증 문자는 보통 영어나 말레이어로 도착하므로 문구가 아니라 숫자를 기준으로 추출하세요. 이런 언어 구성 때문에 많은 팀이 말레이시아 번호로 현지화 QA를 진행합니다.
요금 결제와 장기 번호
하나의 선불 USD 지갑으로 모든 것을 처리하며 월 요금이나 요금제는 없습니다. 카드 또는 USDT/USDC로 충전하면 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 자세한 내용은 요금을 참고하세요.
말레이시아에서는 셀프서비스 장기 번호를 제공하지 않습니다. Dedicated Numbers는 미국과 캐나다에서만 제공되며 월 $1.95부터 시작합니다($1.95/month). 장기적으로 쓸 +60 회선이 필요하면 [email protected]으로 문의하세요. 제공 여부는 현지 규정에 따르며 보장되지 않습니다.
자주 묻는 질문
API로 말레이시아 SMS OTP를 받을 수 있나요?
네. OTP Route의 API로 국가 ID my의 +60 액티베이션을 만들면 코드가 웹훅 또는 폴링으로 전달됩니다.
말레이시아 휴대폰 번호를 E.164로 어떻게 표기하나요?
국내용 맨 앞 0을 빼고 +60을 붙이면 됩니다. 012-345 6789는 +60123456789가 됩니다.
말레이시아 번호로 Shopee나 Lazada 가입을 테스트할 수 있나요?
두 서비스 모두 현재 말레이시아 스냅샷에 있지만 가용 여부는 바뀌므로, 먼저 실시간 서비스 목록을 확인하고 각 플랫폼의 약관을 따르세요.
말레이시아 인증 코드는 얼마인가요?
말레이시아 라우트는 코드당 $0.20 이상이며, 서비스별 정확한 금액은 주문 확정 전에 대시보드에 표시됩니다.
SMS가 끝내 오지 않으면 요금이 청구되나요?
아니요. 20분 윈도우가 코드 없이 끝나거나 직접 취소하면 전액이 지갑으로 돌아옵니다.
지갑을 충전하기 전에 말레이시아 연동을 사전 테스트할 수 있나요?
네. 지원팀에 요청해 개발 계정을 샌드박스로 전환하면, 엔드투엔드 테스트용으로 시뮬레이션된 번호와 코드가 반환됩니다.
말레이시아 번호를 몇 달 동안 유지할 수 있나요?
셀프서비스 제품으로는 불가능합니다. 장기 Dedicated Numbers는 미국과 캐나다만 대상이며, 말레이시아는 [email protected]으로 문의해 주세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.