커스텀 결제수단·직연동 추가하기

토스페이먼츠가 지원하지 않는 결제수단(평생교육바우처, 사내 포인트 등)을 이용하거나 간편결제를 결제위젯에 직연동하고 싶을 때 커스텀 결제수단·직연동 기능을 사용하세요.

커스텀 결제수단은 결제위젯 Pro 플랜 기능입니다. 결제위젯 Pro 플랜 계약은 상점관리자의 이용정보 > 결제·부가서비스 탭에서 문의해주세요.

설정하기

토스페이먼츠 상점관리자의 결제위젯 어드민에서 커스텀 결제수단을 추가하고 싶은 결제 UI를 선택하세요.
왼쪽 메뉴에서 기능 > 결제수단 목록 메뉴 하단에 있는 '+ 추가하기' 버튼을 눌러주세요.
그럼 아래와 같은 팝업창이 열려요. 간편결제 직연동을 하고 싶다면 간편결제 이름을 선택하세요. 토스페이, 네이버페이, 카카오페이를 지원합니다. 선택한 간편결제 로고가 결제위젯에 노출되지만 결제 연동은 직접해야 됩니다. 커스텀 결제수단을 추가하고 싶다면 결제수단의 이름과 연동할 때 사용할 키 값을 입력해주세요.

결제수단 키 값

결제수단의 키 값은 콜백 함수에서 사용합니다. 커스텀 결제수단은 상점관리자에서 원하는 키 값을 등록하면 됩니다. 간편결제 직연동은 미리 정의되어있는 아래 키 값을 사용하세요.

결제수단	키 값
네이버페이	`NAVERPAY`
카카오페이	`KAKAOPAY`
토스페이	`TOSSPAY`
커스텀 결제수단	상점관리자에서 등록

연동하기

먼저 주문서 페이지에 결제 UI를 렌더링하세요. 결제 UI 객체로 호출할 수 있는 on() 메서드로 paymentMethodSelect 이벤트를 구독하세요. 구매자가 선택한 결제수단 정보를 확인할 수 있는 이벤트에요. 구매자가 직연동 결제수단 또는 커스텀 결제수단을 선택하면 해당 결제수단의 결제 로직을 직접 구현해주세요.