테스트와 운영 워크플로에서 Mercado Libre SMS 인증 처리하기

상황: 여러 사이트에 걸친 마켓플레이스 위에서 개발하기

Mercado Libre는 중남미 전역에서 지역별 사이트를 따로 운영하며, 판매자 연동, 물류 대시보드, 가격 모니터링 도구는 여러 사이트를 대상으로 테스트해야 하는 경우가 많습니다. 테스트 계정은 각각 한 국가에 묶여 있고, 결국 하나같이 휴대폰 번호를 요구합니다. 직원의 휴대폰에 의존하면 개인 번호가 업무 계정에 붙고, 테스트 실행은 깨어 있는 사람만 기다리게 됩니다.

OTP Route의 Mercado Libre용 가상 번호는 QA와 운영팀에 더 깔끔한 경로를 제공합니다. 알맞은 시장의 번호, API로 수신하는 코드, 개인 SIM이 필요 없는 구조입니다. 마켓플레이스 팀은 마켓플레이스에서 더 자세히 볼 수 있습니다.

Mercado Libre는 언제 휴대폰 번호를 요구하나요?

대부분의 대형 마켓플레이스와 마찬가지로 Mercado Libre는 예측 가능한 몇몇 지점에서 휴대폰 인증을 사용합니다. 계정을 만들 때, 낯선 기기에서 로그인할 때, 계정 복구 중, 보안 정보를 변경할 때입니다. SMS에는 짧은 숫자 코드가 담기며, 보통 스페인어로 오고 브라질 사이트인 Mercado Livre에서는 포르투갈어로 옵니다. 문구는 언제든 바뀔 수 있으므로 테스트는 메시지 텍스트를 매칭하지 말고 숫자를 추출하도록 작성하세요.

어느 국가에서 Mercado Libre 전화번호를 받을 수 있나요?

mercado 서비스는 현재 201개 국가의 경로에서 이용할 수 있습니다. 대부분의 팀이 선택하는 곳은 마켓플레이스의 실제 영업 지역과 일치합니다. 아르헨티나, 브라질, 멕시코, 콜롬비아, 칠레, 우루과이, 페루, 에콰도르, 볼리비아, 파라과이, 베네수엘라, 코스타리카, 파나마, 과테말라, 엘살바도르, 온두라스, 도미니카 공화국, 미국입니다.

국가 선택은 형식적인 것이 아닙니다. 한 지역 사이트에 등록된 계정은 일반적으로 해당 시장의 번호를 기대하므로 테스트 케이스에 맞는 경로를 고르세요. 가용성은 하루 중에도 달라지므로 실행 전마다 GET /api/v1/countries를 확인하세요.

Mercado Libre 인증 코드 API는 어떻게 동작하나요?

개발자 콘솔에서 발급한 Bearer 키(접두사 or_live_)로 https://otproute.com/api/v1에 요청합니다.

1. 가격을 확인합니다. 예: GET /api/v1/prices?country=ar&service=mercado.
2. POST /api/v1/activations와 {"service": "mercado", "country": "ar"}로 activation을 생성합니다.
3. 반환된 번호를 Mercado Libre 인증 화면에 입력합니다.
4. activation.sms_received 이벤트를 수신하거나 GET /api/v1/activations/{id}를 폴링합니다.

웹훅에서는 X-OTPRoute-Signature(엔드포인트 시크릿으로 <t>.<raw body>에 대한 HMAC-SHA256)를 검증하고, 오래된 타임스탬프를 거부하며, 핸들러를 멱등하게 만드세요. activation id를 키로 삼으면 재시도된 전송이 같은 코드를 두 번 제출하지 못합니다. 짧은 스크립트에는 폴링이, CI에는 웹훅이 맞습니다. 마켓플레이스 테스트 매트릭스는 계정별 한도인 키 10개, 웹훅 엔드포인트 5개, 분당 300건 요청을 기준으로 계획하세요. 문서와 웹훅 기반 OTP 수신을 참고하세요.

연동이 없다면? 대시보드에서 Mercado Libre와 국가를 선택해 주문하고, 번호를 붙여넣은 뒤 화면에서 코드를 기다리면 됩니다.

Mercado Libre 코드가 도착하지 않는 이유는 무엇일까요?

마켓플레이스는 가입과 로그인을 신중하게 보호하며, Mercado Libre도 일부 가상 번호를 거부할 수 있습니다. 전달 여부는 경로와 시점에도 좌우됩니다. 각 activation에는 20분의 창이 있으며, SMS가 오지 않거나 취소하면 전체 금액이 자동으로 지갑에 환불됩니다.

• 재시도 전에 창이 끝날 때까지 기다리세요.
• 나중에 다시 시도하거나, 테스트에 여전히 맞는 다른 국가 경로로 바꿔 보세요.
• 반복 루프로 재주문하지 말고 시도 간격을 두세요.

전달 실패 줄이기에서 더 깊이 다룹니다.

전용 번호가 더 적합한 경우는 언제인가요?

Gateway 번호는 인증 한 건씩만 처리합니다. 내부 계정이 몇 주 뒤에 다시 로그인해야 한다면, 예를 들어 새 기기에서 Mercado Libre가 다시 인증하는 운영 로그인 같은 경우, 유지되는 회선이 있어야 접근 권한을 잃지 않습니다. 전용 가상 번호는 미국과 캐나다에서만 제공되며 월 $1.95부터이고, 대시보드와 웹훅으로 SMS를 수신합니다. 미국 또는 캐나다 번호를 이미 허용하는 계정에 적합하며, 다른 시장은 [email protected]으로 가능한 방법을 문의하세요.

책임 있는 사용과 청구

OTP Route는 본인 제품을 테스트하고 정당한 계정을 운영하기 위한 서비스입니다. Mercado Libre의 약관을 따르고, 실제 개인 또는 사업자당 계정 하나를 유지하며, 번호로 중복 판매자 프로필을 만들거나 프로모션을 반복해서 받지 마세요. 이용 정책(Acceptable Use Policy)이 적용되며, Mercado Libre는 해당 소유자의 상표로 제휴 관계를 의미하지 않습니다.

결제는 월 이용료가 없는 선불 USD 지갑으로 이루어지며 카드 또는 USDT/USDC로 충전하고, 충전할 때마다 PDF 인보이스가 발급됩니다. 연동을 구성하는 동안 시뮬레이션된 Mercado Libre 코드가 필요하면 지원팀에 개발 계정의 샌드박스 전환을 요청하세요.

자주 묻는 질문

API로 Mercado Libre OTP를 받을 수 있나요?

네. 서비스 mercado와 국가 id로 activation을 생성한 뒤 폴링 또는 activation.sms_received 웹훅으로 코드를 읽으면 됩니다.

Mercado Libre 테스트 계정에는 어느 국가를 선택해야 하나요?

아르헨티나, 브라질, 멕시코처럼 계정이 등록된 시장을 고르세요. 그래야 번호가 해당 지역 사이트가 기대하는 형태와 맞습니다.

Mercado Libre는 가상 번호를 허용하나요?

항상 그렇지는 않습니다. 20분 안에 코드가 오지 않으면 금액이 환불되며 나중에 또는 다른 경로로 다시 시도할 수 있습니다.

테스트용 Mercado Libre SMS 인증은 비용이 얼마인가요?

코드당 $0.20부터이며, 정확한 가격은 국가에 따라 다르고 주문 전에 GET /api/v1/prices가 보여줍니다.

이후 Mercado Libre 로그인을 위해 같은 번호를 유지할 수 있나요?

Gateway 번호는 일회용입니다. 미국 또는 캐나다의 전용 번호는 계정이 그런 번호를 허용한다면 갱신되는 동안 유지할 수 있습니다.

웹훅이 같은 코드를 두 번 처리하지 않게 하려면 어떻게 하나요?

서명을 검증한 뒤 첫 이벤트가 도착했을 때 activation id를 저장하고, 같은 id의 반복 이벤트는 무시하세요.

OTP Route 번호로 Mercado Libre 계정을 여러 개 열 수 있나요?

각 계정이 실제 개인이나 사업자의 것이고 Mercado Libre의 약관이 허용하는 경우에만 가능합니다. 중복 계정이나 프로모션용 계정은 허용되지 않습니다.

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