안녕하세요. 토스페이먼츠입니다.
토스페이먼츠는 과거 유플러스 시절부터 현재까지XPay(구.결제모듈)연동을 위한 테스트 서버 주소를 여러개 운영하고 있습니다.
이로 인해 가맹점 지원에 원할하지 못한 부분들이 있어 이를 단일화하여 고품질의 서비스를 제공하기로 하였습니다.
이에 몇가지 변경 요청 사항이 있어 가맹점에 공유드립니다.
[가맹점 서버가 tls1.2 이상 지원하는 경우]
가맹점에서 변경해주셔야 할 작업은 크게 세가지 입니다.
1. crossplatform.js 파일의 주소를 https://js.tosspayments.com/xpay_crossplatform/sandbox/v1 로 변경합니다.
- PHP 예) payreq_crossplatform.php 파일에 https://pretest.tosspayments.com:9443/xpay/js/xpay_crossplatform.js 주소를 위 주소로 변경
- JSP 예) payreq_crossplatform.jsp 파일에 https://pretest.tosspayments.com:9443/xpay/js/xpay_crossplatform.js 주소를 위 주소로 변경
2.lgdacom.conf 를 수정하여 Gateway.do 호출시 사용되는 test_url 도메인을 https://xpay-gateway-sandbox.tosspayments.com/xpay/Gateway.do 로 변경합니다.
- PHP 예) /lgdacom/conf/lgdacom.conf 파일의 test_url에 https://pretestclient.tosspayments.com:9443/xpay/Gateway.do를 위 주소로 변경(*DNS는 예시와 다를 수 있음)
- JSP 예) /lgdacom/conf/lgdacom.conf 파일의 test_url에 https://pretestclient.tosspayments.com:9443/xpay/Gateway.do를 위 주소로 변경(*DNS는 예시와 다를 수 있음)
3. 방화벽을 운영하는 가맹점은 토스페이먼츠의 새로운 DNS(IP)를 허용합니다.
- 210.98.141.11:443/TCP
- 210.98.141.12:443/TCP
- 103.182.250.249:443/TCP
- 103.182.251.249:443/TCP
[가맹점 서버가 tls1.0, tls1.1을 사용하는 경우]
가맹점에서 변경해주셔야 할 작업은 크게 세가지 입니다.
1.crossplatform.js 파일의 주소를 https://js.tosspayments.com/xpay_crossplatform/sandbox/v1 로 변경합니다.
- PHP 예) payreq_crossplatform.php 파일에 https://pretest.tosspayments.com:7443/xpay/js/xpay_crossplatform.js 주소를 위 주소로 변경
- JSP 예) payreq_crossplatform.jsp 파일에 https://pretest.tosspayments.com:7443/xpay/js/xpay_crossplatform.js 주소를 위 주소로 변경
2.lgdacom.conf 를 수정하여 Gateway.do 호출시 사용되는 test_url 도메인을 https://xpay-gateway-old-and-unsafe-sandbox.tosspayments.com/xpay/Gateway.do 로 변경합니다.
- PHP 예) /lgdacom/conf/lgdacom.conf 파일의 test_url에 https://pretestclient.tosspayments.com:7443/xpay/Gateway.do를 위 주소로 변경 (*DNS는 예시와 다를 수 있음)
- JSP 예) /lgdacom/conf/lgdacom.conf 파일의 test_url에 https://pretestclient.tosspayments.com:7443/xpay/Gateway.do를 위 주소로 변경(*DNS는 예시와 다를 수 있음)
3. 방화벽을 운영하는 가맹점은 토스페이먼츠의 새로운 DNS(IP)를 허용합니다.
- 210.98.141.13:443/TCP
- 210.98.141.14:443/TCP
- 103.182.250.248:443/TCP
- 103.182.251.248:443/TCP
위 신규 주소 또한 가맹점의 오래된 TLS 버전(TLS1.0, TLS1.1)으로 통신하는 부분을 수정할 수 있도록 임시 제공하는 것으로 신규 생성된 도메인 지원종료 시점은 2025/01/06(월) 오전 10시까지 입니다.
가맹점의 보안과 고객의 소중한 데이터를 지키기 위해 TLS1.2 이상을 지원할 수 있는 버전으로 서버 업그레이드 요청드립니다.
TLS1.2 버전 이상으로 통신 가능한 경우 2번 항목 url은 https://xpay-gateway-sandbox.tosspayments.com/xpay/Gateway.do로 교체하여 계속 사용할 수 있습니다.
기존에 사용하셨던 사전연동(테스트) 도메인은 2024/06/03(월) 오전 10시에 종료되므로 그 전에 변경 작업 요청드립니다.
* 라이브 환경은 기존과 동일하게 운영하며 테스트 환경 주소만 변경됩니다.
감사합니다.