개발자센터
V1
V2
파트너 정산 릴리즈 노트 기술 블로그

스마트로(신모듈)

스마트로 연동 방법을 안내합니다.

1. 스마트로 채널 설정하기

결제대행사 채널 설정하기 페이지의 내용을 참고하여 채널 설정을 진행합니다.

2. 최신 JavaScript SDK로 업데이트하기

스마트로(신모듈) 결제는 최신 SDK에서만 지원되는 기능입니다.

JS SDK
<script src="https://cdn.iamport.kr/v1/iamport.js"></script>

스마트로 신모듈을 연동하기 위해서는 위에 안내된 JS SDK를 이용하셔야 합니다

JavaScript SDK문서를 통해 최신 SDK를 설치해주세요.

3.결제 요청하기

JavaScript SDK IMP.request_pay(param, callback)을 호출하여 스마트로 결제창을 호출할 수 있습니다. 결제결과는 PC의 경우 IMP.request_pay(param, callback) 호출 후 callback으로 수신되고 모바일의 경우 m_redirect_url 로 리디렉션됩니다.

Javascript SDK
IMP.request_pay( { pg: "smartro_v2.{상점 ID}", pay_method: "card", merchant_uid: "orderNo0001", // 상점에서 생성한 고유 주문번호 주의: 스마트로 일반결제시 주문 번호에 특수문자 사용 불가 name: "주문명:결제테스트", amount: 1004, buyer_email: "test@portone.io", buyer_name: "구매자이름", buyer_tel: "010-1234-5678", buyer_addr: "서울특별시 강남구 삼성동", buyer_postcode: "123-456", m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}", period: { from: "20230512", //YYYYMMDD to: "20230515", //YYYYMMDD }, }, function (rsp) { // callback 로직 /* ...중략... */ }, );

주요 파라미터 설명

pg *string

PG사 구분코드

smartro_v2 로 지정하면 됩니다.

pay_method * string

결제수단 구분코드

  • card (신용카드)
  • trans (실시간 계좌이체)
  • vbank(가상계좌)
  • phone (휴대폰소액결제)
  • lpay (LPAY)
  • kakaopay (카카오페이)
  • naverpay (네이버페이)
  • payco (페이코)
  • pinpay (핀페이)

merchant_uid * string

주문번호

매번 고유하게 채번되어야 합니다. 주의: 스마트로 일반결제시 주문 번호에 특수문자 사용 불가

amount * integer

결제금액

string 이 아닌점에 유의하세요

소수점 두번째 자리까지 허용합니다.

buyer_tel * string

구매자 전화번호

주의: 스마트로 일반 결제시 필수 입력

vbank_due * string

가상계좌 입금기한 (YYYY-MM-DD)

스마트로의 경우 필수 입력이며 날짜는 무조건 23:59:59로 설정 됨

escrow * boolean

에스크로 결제 여부

period * array

서비스 제공 기간

날짜만 입력이 가능하며(시간은 무시) 시작 날짜와 종료 날짜를 모두 입력해야 합니다.

from : YYYYMMDD

to : YYYYMMDD

결제 가능 결제수단

  • card + 에스크로, 다이렉트
  • vbank + 에스크로
  • trans + 에스크로
  • phone
  • lpay
  • naverpay
  • kakaopay
  • pinpay
  • payco

가능한 결제 환경

  • PC (iframe)
  • 모바일 (리디렉션)