개발자센터
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( { pg: "uplus.{MID}", 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}", appCard: true, // 설정시 신용카드 결제모듈에서 앱카드 결제만 활성화됩니다. }, function (rsp) { // callback 로직 //* ...중략... *// }, );

주요 파라미터 설명

pg *string

PG사 구분코드

uplus 로 지정하면 됩니다.

pay_method * string

결제수단 구분코드

  • card(신용카드)
  • trans(실시간 계좌이체)
  • vbank(가상계좌)
  • phone(휴대폰소액결제)
  • applepay(애플페이)
  • tosspay(토스페이)
  • naverpay(네이버페이)
  • kakaopay(카카오페이)
  • lpay(엘페이)
  • payco(페이코)
  • samsung(삼성페이)

merchant_uid * string

주문번호

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

amount *integer

결제금액

string 이 아닌점에 유의하세요

escrow boolean

에스크로 설정여부

토스페이먼츠 결제창 예제