에콰도르(+593) 인증 코드를 테스트 실행에 연결하기

에콰도르 가입 흐름이 전화기를 기다리느라 멈춰 있는 이유는 무엇인가요?

흔한 패턴입니다. 제품 팀이 출시 목록에 에콰도르를 추가하고 가입 화면에서 +593 휴대폰 번호를 요구하는데, QA 팀에는 그 번호를 가진 사람이 없습니다. 누군가 선불 SIM을 주문했지만 다른 도시의 서랍 속에 있고, 모든 회귀 테스트는 동료가 채팅 스레드에서 코드를 불러 주는 것에 의존하게 됩니다.

이런 구성은 테스트를 밤에 돌리거나 병렬로 돌리는 순간 무너집니다. 코드가 있어서는 안 될 곳으로 새어 나가기도 합니다. OTP Route는 서랍 속 SIM을 API 기반의 OTP 라우팅으로 대체합니다. 테스트가 에콰도르 번호를 요청하면 인증 SMS가 우리 쪽에 도착하고, 코드가 요청한 작업에 돌려 전달됩니다. 깨어 있어야 하는 사람도, 누군가의 개인 휴대폰도 필요 없습니다.

에콰도르 인증 번호로 코드를 보낼 수 있는 앱은 무엇인가요?

에콰도르 경로는 현재 1,700개가 넘는 서비스를 지원합니다. 실시간 스냅샷에서 인기 있는 서비스로는 WhatsApp, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), LinkedIn, Microsoft & Outlook, Uber, Airbnb, Netflix, Discord, ChatGPT (OpenAI)가 있습니다.

재고는 통신사 파트너로부터 실시간으로 들어오기 때문에 이 목록은 하루 동안 바뀝니다. 약속이 아니라 참고로만 보세요. 특정 시점의 정확한 답은 사용하는 서비스와 에콰도르 국가 id ec에 대해 GET /api/v1/prices가 반환하는 값입니다. 전체 카탈로그는 서비스 페이지에서 둘러볼 수 있습니다.

코드로 보면 에콰도르 OTP API 호출 순서는 어떻게 되나요?

모든 요청은 https://otproute.com/api/v1 아래에 있으며 Developer console에서 생성한 or_live_ 접두사의 Bearer 키로 인증합니다. 일반적인 테스트 단계는 다음과 같습니다.

1. GET /api/v1/prices?country=ec&service=<id>로 가격과 실시간 가용 상태를 확인합니다.
2. {"service": "uber", "country": "ec"} 같은 본문으로 POST /api/v1/activations를 호출해 주문을 만듭니다. 응답으로 activation id와 +593 번호를 받습니다.
3. 그 번호를 자사 앱의 가입 양식에 입력하고 SMS를 발생시킵니다.
4. 에콰도르 작업이 activation.sms_received 이벤트를 기다리도록 하고, 대안으로 몇 초마다 GET /api/v1/activations/{id}를 호출합니다.
5. 테스트가 도중에 비정상 종료되면 POST /api/v1/activations/{id}/cancel로 +593 주문을 해제합니다.

웹훅 전달에는 X-OTPRoute-Signature 헤더가 포함됩니다. 엔드포인트 시크릿으로 타임스탬프, 점, 원본 본문에 대한 HMAC-SHA256을 다시 계산하고, 상수 시간으로 비교하고, 오래된 타임스탬프는 거부하세요. 연동 가이드에서 SMS 인증 API 클라이언트 전체를 단계별로 설명하며, 문서에 모든 필드가 나와 있습니다.

데이터베이스에 +593 휴대폰 번호는 어떻게 저장해야 하나요?

에콰도르 사람들은 보통 휴대폰 번호를 앞에 0을 붙여 09 다음에 8자리를 더하는 식으로 씁니다. 이 0은 국내 통화에만 쓰는 트렁크 접두사입니다. E.164에서는 이 0이 사라져서 +593과 9로 시작하는 9자리 국내 번호가 남습니다.

• 표준 형식 하나로 저장하세요: +5939XXXXXXXX. 입력 시 공백, 대시, 트렁크 0을 제거합니다.
• 현지 사람들이 두 형식 중 아무거나 입력하므로 양식 필드에서 09…와 +593 9…를 모두 허용하세요.
• 메시지 템플릿에서 영어를 가정하지 마세요. 에콰도르의 공용어는 스페인어이므로 대부분의 코드는 스페인어 문구와 함께 도착합니다. "코드" 같은 단어와 대조하지 말고 숫자를 추출하세요.

결제 테스트에 작은 편의가 하나 있습니다. 에콰도르는 미국 달러를 통화로 사용하므로 OTP Route에서 충전하는 USD 지갑과 일치합니다.

에콰도르에서 코드가 도착하지 않았습니다. 어떻게 해야 하나요?

번호에서 아무 반응이 없다면 대개 테스트 하네스의 버그가 아니라 경로나 수락 문제입니다. 다음 순서로 확인하세요.

• 20분 제한 시간이 끝날 때까지 기다리세요. 아무것도 오지 않으면 전액이 자동으로 지갑에 돌아오므로 일찍 취소할 이유가 없습니다.
• 에콰도르 대상 서비스가 애초에 가상 번호를 허용하는지 알아보세요. 일부는 정책상 거부하며, 바로 그 때문에 환불 규칙이 있습니다.
• 나중에 다시 시도하거나, 같은 서비스에 새 activation을 주문해 다른 번호가 쓰이게 하세요.
• 짧은 간격으로 재주문을 반복하지 마세요. 짧은 백오프가 지갑과 경로를 모두 보호합니다.

CI에서 에콰도르 SMS OTP 코드를 안정적으로 받아야 한다면 백오프를 하네스 자체에 넣으세요. OTP 전달 실패 줄이기 글에 재시도 로직의 다른 패턴이 더 있습니다.

다시 로그인하는 계정을 위해 에콰도르 번호를 계속 보유할 수 있나요?

셀프 서비스 상품으로는 불가능합니다. 장기 전용 번호(Dedicated Numbers)는 미국과 캐나다에서만 판매하며 월 $1.95부터이고, 수신 SMS, 웹훅 전달, 발신 문자, 브라우저 통화를 지원합니다. 에콰도르에는 현재 셀프 서비스 장기 회선이 없습니다. 사용 사례에 꼭 필요하다면 [email protected]으로 상황을 적어 문의하세요. 제공 가능 여부는 현지 규정에 따라 다르며 약속드릴 수 없습니다.

에콰도르 코드는 어떻게 결제하나요? 먼저 무료로 테스트할 수 있나요?

OTP Route는 월 이용료나 선택할 요금제 없이 선불 USD 지갑 하나로 운영됩니다. 카드 또는 USDT/USDC로 충전하며 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 각 activation은 코드가 전달될 때만 이 잔액에서 차감됩니다.

비용을 쓰기 전에 개발 계정의 샌드박스 모드를 요청하세요. 시뮬레이션된 번호와 코드가 반환되므로 CI 작업, 웹훅 검증기, 파서를 처음부터 끝까지 시험해 볼 수 있습니다. 이를 파이프라인에 연결하는 팀은 QA 테스트 개요에서 시작하는 경우가 많습니다. 항상 그렇듯 각 서비스의 약관과 이용 정책을 따르세요.

자주 묻는 질문

현지 SIM 없이 앱의 에콰도르 가입 흐름을 테스트할 수 있나요?

네. 국가 id ec로 activation을 주문하고, +593 번호를 앱에 입력한 다음 대시보드, 웹훅, 폴링 호출로 코드를 확인하세요.

에콰도르 인증 코드는 얼마인가요?

코드당 $0.20부터 시작하며 정확한 금액은 서비스에 따라 다릅니다. 주문 전에 대시보드에 표시되거나 가격 엔드포인트가 반환합니다.

+593 번호로 SMS가 오지 않아도 비용을 내야 하나요?

아니요. 메시지 없이 20분 제한 시간이 끝나거나 먼저 취소하면 전액이 지갑으로 돌아옵니다.

에콰도르 번호를 입력할 때 앞의 0을 보내야 하나요?

양식이 국내 형식을 기대하는 경우에만 필요합니다. 국제 형식에서는 트렁크 0을 생략하므로 번호는 +593 뒤에 9로 시작하는 9자리가 이어집니다.

에콰도르 OTP 메시지는 어떤 언어로 오나요?

대부분 스페인어이지만 일부 글로벌 앱은 영어로 보냅니다. 주변 문구에 의존하지 말고 숫자 코드를 파싱하세요.

몇 달 동안 유지할 수 있는 테스트용 +593 번호가 있나요?

에콰도르에는 셀프 서비스 옵션이 없으며 장기 회선은 미국·캐나다 상품입니다. 특별한 경우는 [email protected]으로 문의하세요.

API 대신 브라우저에서 에콰도르 번호를 주문할 수 있나요?

네. 로그인한 뒤 OTP Gateway에서 서비스와 에콰도르를 선택하고 표시된 가격을 확정하면, 코드가 도착했을 때 같은 화면에 나타납니다.

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