개발자센터
V1
V2

(신) 토스페이

(신) 토스페이 결제창 연동 방법을 안내합니다.

1. (신) 토스페이 PG 설정하기

(신) 토스페이 설정 페이지의 내용을 참고하여 PG 설정을 진행합니다.

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: "tosspay_v2.{MID}", pay_method: "tosspay", // 'tosspay_card', 'tosspay_money' 도 지원됩니다. merchant_uid: "orderMonthly0001", // 상점에서 관리하는 주문 번호 name: "최초인증결제", buyer_email: "test@portone.io", buyer_name: "포트원", buyer_tel: "02-1234-1234", m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}", amount: 1004, card: { useInstallment: false, } bypass: { expiredTime: "2023-12-02 11:00:00", //결제 만료시간 cashReceiptTradeOption: 'CULTURE' //현금영수증 발급타입 } }, function (rsp) { // callback 로직 });

주요 파라미터 설명

pg *string

PG사 구분코드

tosspay_v2 로 지정하면 됩니다.

pay_method * string

결제수단 구분코드

  • tosspay_money : 계좌결제만 허용합니다.
  • tosspay_card : 카드결제만 허용합니다.
  • tosspay : 모든 결제수단을 허용합니다.

merchant_uid * string

주문번호

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

amount * integer

결제금액

string 이 아닌점에 유의하세요

card.useInstallment * boolean

할부 사용 가능 여부

bypass.expiredTime * string

결제 만료 기한

yyyy-MM-dd HH:mm:ss 의 형식입니다.

입력하지 않을 경우, 기본값인 15분으로 설정됩니다. 최대 60분까지 설정할 수 있습니다.

bypass.cashReceiptTradeOption * string

현금영수증 발급 대상 타입

전달하지 않을경우, 기본값은 GENERAL 입니다.

  • GENERAL: 일반 (default)
  • CULTURE: 문화비
  • PUBLIC_TP: 교통비