개발자센터

스마트로(구모듈)

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

이 문서는 V1(구 아임포트) 연동 고객사 대상입니다. 신규 연동의 경우 V2 버전 사용을 권장합니다.

스마트로(구모듈) 연동 방법에 관한 매뉴얼입니다.

신규 연동 고객사이시거나 스마트로 신모듈로의 업그레이드를 원하신다면 스마트로(신모듈) 연동 가이드를 참고하여 진행해주세요. 구모듈에 비해 신모듈에서 다양한 기능 및 결제수단을 지원하고 있습니다. 신규 고객사의 경우 가급적 신모듈로 연동하는 것을 권장드립니다.

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

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

2.결제 요청하기

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

Javascript SDK
IMP.request_pay(
  {
    channelKey: "{콘솔 내 연동 정보의 채널키}",
    pay_method: "card",
    merchant_uid: "order_no_0001", // 상점에서 생성한 고유 주문번호
    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}",
  },
  function (rsp) {
    // callback 로직
    /* ...중략... */
  },
);

주요 파라미터 설명

channelKey: string

채널키

결제를 진행할 채널을 지정합니다.

포트원 콘솔 내 [결제 연동] - [연동 정보] - [채널 관리] 에서 확인 가능합니다.

(최신 JavaScript SDK 버전부터 사용 가능합니다.)

pg(deprecated)?: string

PG사 구분코드

smartro 로 지정하면 됩니다.

pg 파라미터는 지원 중단 예정입니다.

JS SDK를 가장 최신 버전으로 업그레이드 후 channelKey 파라미터로 채널 설정(PG사 구분)을 대체해주세요.

pay_method: string

결제수단 구분코드

  • card (신용카드)
  • trans (실시간 계좌이체)
  • vbank(가상계좌)
merchant_uid: string

고객사 주문번호

매번 고유하게 채번되어야 합니다.

name: string

주문명

amount: number

결제금액

string 이 아닌점에 유의하세요

buyer_name?: string

구매자 이름

buyer_email?: string

구매자 이메일

buyer_tel?: string

구매자 연락처

buyer_addr?: string

구매자 주소

buyer_postcode?: string

구매자 우편번호

escrow?: boolean

에스크로 설정여부

digital?: boolean

디지털 컨텐츠 여부

  • true: 컨텐츠
  • false: 실물 상품
language?: string

결제창 언어

  • ko: 한국어 (기본값)
  • en: 영어
vbank_due?: string

가상계좌 입금마감일시

period?: object

서비스 제공기간

from?: string

시작일 (YYYYMMDD)

to?: string

종료일 (YYYYMMDD)

m_redirect_url?: string

모바일 결제 후 리디렉션 될 URL

app_scheme?: string

모바일 앱 URL scheme (모바일 전용)

notice_url?: string | string[]

웹훅 수신 URL

confirm_url?: string

Confirm process URL

custom_data?: object

가맹점 커스텀 데이터