Mercado Pago SMS 코드를 테스트 실행에 연결하기

Mercado Pago 전화번호 단계에서 팀이 해결하려는 문제는 무엇인가요?

Mercado Libre의 결제 및 디지털 지갑 플랫폼인 Mercado Pago는 중남미 전역의 일상적인 상거래에 자리 잡고 있습니다. 대부분의 금융 앱처럼 계정을 휴대폰 번호에 연결하며, 가입 시 SMS 코드로 번호를 확인하고 새 기기에서 로그인하거나 접근을 복구할 때 새 코드를 요구할 수 있습니다. 체크아웃을 연동하는 가맹점, 고객의 판매자 계정을 운영하는 에이전시, 결제 단계에서 Mercado Pago를 제공하는 마켓플레이스를 테스트하는 QA 엔지니어처럼 이를 기반으로 개발하는 팀에게 SMS 단계는 종종 까다로운 부분입니다. 직원이 업무 계정에 개인 번호를 등록하게 되거나, 맞는 SIM을 가진 한 사람이 자리를 비우면 테스트 케이스가 멈춥니다.

OTP Route는 이 단계를 도구가 처리할 수 있는 작업으로 바꿔 줍니다. 필요한 시장의 번호를 요청 즉시 받고, 코드는 시스템으로 전달됩니다. 이것이 테스트용 Mercado Pago SMS 인증의 핵심입니다.

Mercado Pago 인증 코드 API 플로우는 어떻게 동작하나요?

모든 요청은 개발자 콘솔에서 발급한 Bearer 키(접두사 or_live_)와 함께 https://otproute.com/api/v1로 보냅니다. 서비스 id는 mercado_pago이고, 국가 id는 해당 시장의 api_country 값입니다. 예를 들어 브라질은 br, 멕시코는 mx입니다.

1. GET /api/v1/prices?country=br&service=mercado_pago는 해당 조합의 실시간 가격과 가용성을 반환합니다.
2. {"service": "mercado_pago", "country": "br"}를 담은 POST /api/v1/activations는 activation id와 번호를 반환합니다.
3. 설정하거나 테스트하는 계정의 전화번호 단계에 번호를 입력합니다.
4. activation.sms_received가 엔드포인트에 도착하면 코드를 가져오거나, GET /api/v1/activations/{id}를 폴링합니다.
5. 실행이 일찍 끝나면 POST /api/v1/activations/{id}/cancel을 호출합니다.

사전 점검으로 GET /api/v1/balance를 사용하세요. 계정당 키 10개, 웹훅 엔드포인트 5개, 분당 300건 요청이 제공되며, 나머지 내용은 문서에 있습니다.

웹훅 핸들러는 Mercado Pago 코드를 어떻게 처리해야 하나요?

푸시 전달을 사용하면 테스트 러너가 폴링 루프를 돌 필요가 없습니다. 모든 이벤트에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프의 요청은 버리세요. 그다음 핸들러를 멱등하게 만드세요. 재전송이 발생하므로 activation id를 저장하고 같은 이벤트의 두 번째 전달은 무시합니다. activation.expired와 activation.cancelled도 구독하면 러너가 슬롯을 반납하고 테스트를 재시도 대상으로 표시할 수 있습니다. 엔드포인트를 직접 운영하고 싶지 않다면 몇 초마다 activation을 폴링해도 요청 제한 안에 충분히 들어갑니다. OTP 웹훅 보안에 더 자세한 체크리스트가 있습니다.

Mercado Pago 번호는 어느 국가에서 받아야 하나요?

mercado_pago 서비스는 OTP Route에서 201개 국가에 올라와 있지만, 유용한 선택은 거의 언제나 계정이 속한 시장입니다. Mercado Pago는 브라질, 아르헨티나, 멕시코, 칠레, 콜롬비아, 우루과이, 페루에서 가장 잘 알려져 있어 대부분의 테스트 케이스가 그곳에 있습니다. 카탈로그에는 그 밖에도 에콰도르, 볼리비아, 파라과이, 코스타리카, 파나마, 도미니카 공화국, 스페인, 포르투갈, 미국 등이 있습니다.

잘못된 국가의 번호는 검증에 실패하거나 추가 확인을 유발할 수 있고, 해당 시장의 실제 사용자가 겪는 플로우에 대해서도 알려 주는 바가 없습니다. 테스트 케이스에 맞추세요. 브라질 온보딩에는 브라질 번호, 칠레 온보딩에는 칠레 번호를 씁니다.

대시보드에서는 무엇을 할 수 있나요?

비개발자도 코드 없이 같은 결과를 얻을 수 있습니다. OTP Gateway를 열고 서비스로 Mercado Pago를, 국가를 선택한 뒤 주문 전에 표시되는 가격을 확인하세요. 번호를 앱에 복사하고 SMS를 요청하면, 코드가 전달되는 즉시 activation 카드에 나타납니다. 번호는 20분간 유지되며, 아무것도 도착하지 않으면 금액이 지갑으로 자동 반환되므로 비용은 청구되지 않습니다.

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

결제 플랫폼은 전화번호에 신중하며, Mercado Pago용 가상 번호는 일부 또는 모든 플로우에서 거부될 수 있습니다. 경로도 하루 중 달라집니다. 코드가 보이지 않으면 다음을 확인하세요.

• 20분 창이 끝날 때까지 기다리세요. 환불은 자동입니다.
• 짧은 간격으로 재주문하지 마세요. 시도 간격을 두거나 나중에 다시 오세요.
• 한 경로가 계속 만료되면 같은 시장의 다른 경로를 시도하세요.
• 전화번호 입력란에 앱이 기대하는 형식으로 번호가 입력되었는지 확인하세요.

어떤 플로우가 가상 번호를 계속 거부한다면 그 결과를 받아들이고, 해당 계정에는 실제 회선을 사용하세요. 전달 실패 줄이기에서 더 폭넓은 진단을 다룹니다.

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

일회용 번호는 코드 하나를 처리합니다. 몇 달 뒤 새 코드를 다시 요구할 비즈니스 계정에는 계속 관리하는 번호가 필요합니다. OTP Route의 전용 번호(Dedicated Number)가 미국과 캐나다에서 이 역할을 하며 월 $1.95부터입니다. 대시보드와 웹훅(number.sms_received)으로 SMS를 받고, 발신 SMS와 브라우저 통화도 가능하며, 회선을 해지할 때까지 지갑에서 갱신됩니다. 이 두 나라 밖에는 셀프서비스 장기 회선이 없으므로 [email protected]으로 문의하세요. 제공 여부는 현지 규정에 따라 달라집니다. 자세한 내용은 가상 번호를 참고하세요.

Mercado Pago와 이 번호를 함께 쓸 때 어떤 규칙이 적용되나요?

Mercado Pago는 실제 돈을 다루며, 신원 확인에는 그만한 이유가 있습니다. OTP Route의 전화번호는 그 확인을 대체하지 않으며 우회하는 데 써서도 안 됩니다. 실제 정보로 신원 인증을 완료하고, 실제 개인 또는 사업자당 계정 하나를 유지하며, OTP Route의 이용 정책(Acceptable Use Policy)과 함께 Mercado Pago의 약관을 따르세요. 이 플랫폼은 본인 제품을 테스트하고 본인의 정당한 계정을 운영하기 위한 것이며, 대량으로 계정을 열거나 프로모션을 받기 위한 것이 아닙니다. 청구는 선불 USD 지갑에서 사용한 만큼 지불하는 방식이고(카드 또는 USDT/USDC, 충전마다 PDF 인보이스), 연동 테스트를 위한 시뮬레이션 코드 샌드박스는 요청 시 제공됩니다. Mercado Pago는 해당 소유자의 상표이며 OTP Route는 이와 제휴 관계가 없습니다.

자주 묻는 질문

브라질이나 멕시코의 현지 SIM 없이 Mercado Pago OTP를 받을 수 있나요?

네, 본인 계정을 테스트하거나 운영하는 경우입니다. 알맞은 국가의 mercado_pago 번호를 주문하고 대시보드, API 또는 웹훅에서 코드를 읽으세요.

API에서 Mercado Pago의 서비스 id는 무엇인가요?

mercado_pago입니다. POST /api/v1/activations의 본문에서 국가 id와 함께 사용합니다.

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

항상 그렇지는 않습니다. 일부 플로우에서 거부할 수 있으며, 그래서 20분 안에 코드가 도착하지 않으면 전체 금액이 환불됩니다.

인증용 Mercado Pago 전화번호는 비용이 얼마인가요?

코드당 $0.20부터입니다. 정확한 가격은 국가에 따라 다르며 주문 전에 API와 대시보드에 표시됩니다.

다음 달에 다시 로그인하려고 같은 일회용 번호를 쓸 수 있나요?

아니요. 일회용 번호는 코드 하나만 받습니다. 반복 로그인이 필요한 계정에는 미국 또는 캐나다 전용 번호가 더 적합합니다.

실제 비용 없이 CI 파이프라인에서 Mercado Pago 플로우를 실행할 수 있나요?

네. 개발 계정에 샌드박스 모드를 요청하세요. 같은 엔드포인트를 통해 시뮬레이션된 번호와 코드를 반환합니다.

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