Smartro manual

기존 PG모듈 사용자 안내

기존 스마트로페이 모듈과 신규 버전의 차이점 및 특징에 대한 안내사항입니다.

1. URL 변경

모듈 호출 시, 기존 도메인 smilepay.co.kr 에서 smartropay.co.kr 으로 변경되었습니다.
ex) 모바일 : https://smpay.smilepay.co.kr -> mpay.smartropay.co.kr
ex) PC : https://pay.smilepay.co.kr -> pay.smartropay.co.kr

2. 파라미터 규칙 변경

결제요청 및 결과 시 전달되는 파라미터의 대소문자 규칙이 추가되었습니다.
각 단어의 첫 글자는 대문자로, 나머지 단어는 소문자로 작명되도록 수정되었습니다.
이러한 규칙에 따라 아래와 같은 파라미터가 새롭게 변경되었으므로 참고 바랍니다.

기존(변경 전 파라미터)		신규(변경 후 파라미터)
파라미터	항목명	파라미터	항목명
MID	상점ID	Mid	상점ID
TID	거래번호	Tid	거래번호
ReturnURL	결제결과 전송 URL	ReturnUrl	인증결과 전송 URL
RetryURL	결제결과 재전송 URL	RetryUrl	가상계좌 입금통보 URL
MallUserID	회원사 고객 ID	MallUserId	회원사 고객 ID
UserIP	고객 IP	UserIp	고객 IP
MallIP	가맹점서버 IP	MallIp	가맹점서버 IP
ediDate	전문생성일시	EdiDate	전문생성일시
StopURL	결제중단 URL	StopUrl	결제중단 URL
fn_cd	카드사 코드	FnCd	카드사 코드
fn_name	카드사명	FnName	카드사명
EscrowCD	에스크로 거래구분	EscrowCd	에스크로 거래구분
SspMallID	결제MALL ID	SspMallId	결제MALL ID
VERIFY_V	위·변조 검증값	VerifyValue	위·변조 검증값
SUB_ID	서브아이디	SubId	서브아이디
CancleID	취소 ID	CancelId	취소 ID
Cancelpw	취소 패스워드	CancelPw	취소 패스워드
BL_Tid	Bill Key	BlTid	Bill Key

※ 부가세 관련 파라미터 수정 및 추가

기존(변경 전 파라미터)		신규(변경 후 파라미터)
파라미터	항목명	파라미터	항목명
Tax	부가세	VatAmt	부가세
		TaxAmt	과세
		TaxFreeAmt	비과세
		SvcAmt	봉사료

3. LayerPopup 지원 js파일 제공

SmartroPAY-1.0.min.js 파일을 코드에 삽입하여 간편하게 플러그인을 호출할 수 있습니다.

        
<html lang="ko">
<head>
    <title>SmartroPAY 연동가이드</title>

    <!-- PC 연동 시 script -->
    <!-- 운영 전환 시 "https://pay.smartropay.co.kr/asset/js/SmartroPAY-1.0.min.js" 로 변경 -->
    <script src="https://tpay.smartropay.co.kr/asset/js/SmartroPAY-1.0.min.js"></script>

    <!-- 모바일 연동 시 script -->
    <!-- 운영 전환 시 "https://mpay.smartropay.co.kr/asset/js/SmartroPAY-1.0.min.js" 로 변경 -->
    <script src="https://tmpay.smartropay.co.kr/asset/js/SmartroPAY-1.0.min.js"></script>

    <script type="text/javascript">
        function goPay() {
            // 결제 요청
            // 자세한 설명은 '모듈 연동 -> 일반 연동' 메뉴를 참고해 주세요.
        };
    </script>
</head>
</html>

4. Weblink 연동 시 인증/승인 분리

기존: 인증과 승인이 하나로 합쳐진 연동
신규: 인증요청 후 HTTP URL Call로 승인 요청