가이드
목차

Version 1

결제위젯 SDK v1은 더 이상 업데이트되지 않습니다. 토스페이먼츠 SDK v2 연동을 추천합니다.

퀵계좌이체란?

계좌이체는 결제 수수료가 저렴하지만 구매자가 결제를 할 때 불편하다는 단점이 있어요. 보안프로그램・계좌이체 앱도 설치해야 하고, 계좌 등록을 위해 회원가입도 해야 해요. 보안카드나 OTP처럼 평소 잘 들고 다니지 않는 인증수단으로 인증절차를 마쳐야 하는 불편함도 있고요.

토스페이먼츠 ‘퀵계좌이체'는 앱설치나 공동인증서가 없어도 간편결제처럼 한 번만 계좌등록을 해두면 비밀번호만 입력하고 쉽게 결제를 마칠 수 있는 계좌이체 서비스예요.

퀵계좌이체 데모 체험하기

API 키 준비하기

토스페이먼츠와 퀵계좌이체 결제 계약을 완료했다면, 내 상점의 결제위젯 연동 키로 결제위젯을 연동하세요. 토스페이먼츠 계약 이후에만 키인 결제를 결제위젯으로 사용할 수 있어요.

상점관리자 > 매출·정산 관리 > 내 상점 이름 >'개발 정보' 에서 결제위젯 연동 키를 확인하세요. 아래 그림과 같이 왼쪽 상단에 상점 이름이 나와야 됩니다.

내 상점의 API 키

설정하기

상점관리자결제 UI 설정 메뉴로 들어가세요. 결제 수단 목록에서 '퀵계좌이체'를 선택해서 위젯에서 보이도록 설정해주세요.

퀵계좌이체 설정

연동하기

연동 방법은 결제위젯 연동하기를 참고해주세요. 계좌이체 서비스를 계약한 뒤 결제위젯을 연동하면 퀵계좌이체는 자동으로 추가됩니다.

만약 자동으로 추가 되지 않았다면 토스페이먼츠 고객센터(1544-7772, support@tosspayments.com)를 통해 계좌이체 서비스 계약을 먼저 진행해주세요.

결제 완료 후 응답 확인하기

결제 승인에 성공하면 HTTP 200 OKPayment 객체를 받습니다. 퀵계좌이체는 transfer 필드에 결제 정보가 담겨있습니다.

  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    실시간 문의|이메일 보내기