커뮤니티·지원/릴리즈 노트

토스페이먼츠 제품 및 API의 새로운 기능과 변경 사항을 알려드려요. API 버전 관리 및 릴리즈 정책은 API 버전 정책을 확인해 보세요.

2024년 9월

결제위젯 다크 테마 지원

결제위젯 어드민에 새로운 디자인 기능이 추가됐습니다. 기본 라이트 테마 외에 '다크 테마'를 선택할 수 있어요. 디바이스에서 다크모드를 활성화한 사용자에게 더욱더 매끄러운 결제 경험을 노코드로 제공해보세요.

결제위젯 다크 테마

2024년 8월

결제위젯 약관 UI 업데이트

이제 새로운 약관을 추가할 때 기본 동의 체크 여부를 결정할 수 있습니다. 새로 추가하는 약관은 기본적으로 "동의 체크 안 되어 있음"으로 설정됩니다. 기존 약관은 모두 "동의 체크되어 있음"입니다. 동의 체크 여부를 바꾸려면 상점관리자의 결제위젯 > 약관 설정 메뉴에서 약관 설정을 수정해주세요.

결제위젯 약관 UI 업데이트

결제위젯 어드민 업데이트

새롭게 추가된 결제위젯 어드민 기능을 만나보세요. 노코드로 더 다양한 설정을 변경할 수 있습니다.

  • 일시불만 제공: 신용카드 결제에서 할부 선택지를 제공하지 않고, 일시불만 제공하는 기능이 추가됐어요. 결제위젯 어드민의 할부 메뉴에서 '일시불만 제공' 옵션을 선택해주세요.
  • 결제위젯 배경색 변경: 많은 분들이 요청한 결제위젯 배경색 변경 기능이 추가됐습니다! 이제 결제위젯을 더욱더 내 상점의 스타일에 맞게 꾸밀 수 있어요.
결제위젯 어드민 바로가기

결제위젯 어드민 디자인 및 기능 설정 추가


2024년 7월

토스페이먼츠 SDK Version 2 출시

4년 만에 토스페이먼츠 SDK Version 2가 새롭게 출시됐습니다. Version 1에서 제공한 결제위젯, 결제창, 브랜드페이를 더 편리하게 하나의 SDK로 연동할 수 있어요.

토스페이먼츠 제품 설명


2024년 3월

개발자센터 API 로그 기능 출시

개발자센터에 API 호출 로그를 확인할 수 있는 API 로그 기능이 추가됐어요! 이제부터 개발 중 발생하는 API 호출 로그를 실시간으로 확인할 수 있어요. API 호출에 실패했을 때 문제가 뭔지, 어떤 데이터가 오고 갔는지 한눈에 볼 수 있어서 디버깅이 한결 쉬워질 거예요.

이 기능을 사용하시려면 개발자센터에 로그인해 보세요. 사용 방법은 간단해요. 로그인 후 내 개발정보에서 'API 호출 로그' 섹션으로 들어가면 모든 호출 로그와 관련 정보를 확인할 수 있어요.

API 로그 예시


2024년 1월

이용약관 UI 패딩 설정하기

결제위젯 어드민에서 결제 UI 패딩을 설정하면, 이용약관 UI에도 같은 패딩이 적용돼요. 결제위젯 어드민 > 결제 UI > 디자인 > 기본 설정 메뉴에서 패딩을 바꿔보세요.

결제위젯 패딩 설정

브랜드페이 로고 추가하기

결제위젯으로 브랜드페이를 사용하고 있다면 내 상점의 커스텀 로고를 추가할 수 있어요. 구매자에게 일관된 브랜드 경험을 제공해보세요. 상점관리자 > 결제 UI > 기능 > 브랜드페이 메뉴에서 사용해보세요.

브랜드페이 로고


2023년 11월

결제위젯 Flutter SDK 출시

Flutter에서도 결제위젯을 쉽게 연동할 수 있도록, SDK가 출시됐어요.

연동을 바로 시작하고 싶다면 Flutter SDK 레퍼런스결제 연동 가이드를 참고해주세요.


2023년 10월

결제 UI 복제하기

결제 UI의 스타일, 결제수단 등 모든 설정을 복제할 수 있는 기능이 추가됐어요. 결제 UI를 복제해서 멀티 결제 UI를 사용하세요. 결제 UI를 여러 개 만들고 상황에 따라 다르게 노출할 수 있어요.

결제 UI 복제 기능

React Native SDK로 주문서 개발하기

그동안 JavaScript, Android, iOS만 제공되던 결제위젯 SDK에 React Native가 추가됐어요. 곧 Flutter도 추가될 예정이에요.

연동을 바로 시작하고 싶다면 React Native SDK 레퍼런스결제 연동 가이드를 참고해주세요.

계좌 결제도 프로모션하기

지금까지 신용카드에만 프로모션 배지를 추가할 수 있었는데요. 이제 계좌 결제에도 배지를 붙이고 프로모션 텍스트를 보여줄 수 있어요. 어드민에서 코드 없이 설정할 수 있어요.

다음 예시에서는 퀵계좌이체 결제수단에 '즉시할인'이라는 배지 텍스트를 설정했네요. 노출 조건은 기간을 설정하는 기능이에요. '계약 기간 동안'으로 설정하면 내 상점에서 계약한 기간 동안에 보여주고 계약 기간이 넘어가면 자동으로 비활성화돼요. '항상'으로 설정하면 기간과 상관없이 계속 노출돼요.

이 기능을 사용하려면 Pro 플랜을 추가하세요. 상점관리자의 이용정보 > 결제·부가서비스 메뉴에서 신청하실 수 있어요.

퀵계좌 프로모션 배지 설정 어드민 화면

더욱 안전한 가상계좌 결제 서비스 제공하기

구매자가 가상계좌로 입금할 수 있는 금액을 제한하는 기능이 추가됐어요. 결제할 수 있는 최대 금액을 어드민에서 설정해서 가상계좌를 안전하게 사용하세요. 어드민에서 코드 없이 설정할 수 있어요.

가상계좌 설정에서 금액 제한 토글을 켜면 50만원이 기본 최대 입금 금액으로 설정돼요. 이 금액은 직접 바꿀 수 있어요.

가상계좌 결제 금액 제한 기능 어드민 화면

Native SDK에서도 구매자가 선택한 결제수단 확인, 에러 핸들링하기

Android, iOS SDK에도 getSelectedPaymentMethod()가 추가되어 구매자가 선택한 결제수단을 확인할 수 있어요. 구매자가 선택한 결제수단을 직접 확인할 수 있어요.

결제수단 확인할 수 있는 메서드가 문서에 추가된 화면


2023년 9월

결제수단 등록할 때 구매자가 보는 배경 바꾸기

브랜드페이를 사용하면 내 상점만의 간편결제인 OO페이 서비스를 쉽게 만들 수 있어요. 결제수단을 등록하는 버튼 배경에 커스텀 이미지를 넣을 수 있는 기능도 추가됐어요.

결제수단 등록 배경 어드민에서 설정하는 화면

아래 예시처럼 결제수단을 등록했을 때 제공되는 혜택, 브랜드 디자인을 직접 녹여보세요.

달라진 결제수단 등록 배경 예시 이미지


2023년 8월

위젯 UI에만 나타나던 경고를 직접 에러 핸들링하기

결제를 요청했을 때 사용자가 결제 정보를 입력하지 않으면 원래 위젯 UI에만 경고가 나타났는데요. 이제 Exception Error Throw 됩니다.

UI에 나타나던 에러 Exception Error Throw 되는 화면


2023년 7월

'할부 고급설정' 기능

카드사별로 무이자할부, 최대 할부기간 설정하기가 가능해요. 어드민에서 코드 없이 설정할 수 있어요.

할부 고급설정 기능 추가 상점관리자 이미지

원하는 색상으로 직접 강조하기

'강조색' 기능이 추가됐어요. 체크박스, 프로모션 배지, 브랜드페이의 강조색을 코드 없이 어드민에서 쉽게 바꿀 수 있어요.

강조색 기능 업데이트 상점관리자 이미지


2023년 6월

  • 결제수단에 PayPal을 추가했어요. 상점관리자에서 해외결제용 MID를 선택하면 PayPal을 사용할 수 있어요.

2023년 5월

  • 가상계좌 기능을 업데이트했어요. 입금기한을 설정할 때 상점관리자에서 기간 설정과 시점 설정 중 선택할 수 있어요.
  • 멀티 결제 UI를 추가했어요. 결제 UI를 여러 개 만들고 상황에 따라 다르게 노출할 수 있어요.
  • Native SDK에 약관, 커스텀 결제수단 기능을 추가했어요.

2023년 4월

  • 상점관리자 기능을 업데이트했어요.
  • 각 기능 별 플랜 정보를 추가했어요.
  • 프로모션 정보를 커스터마이징 할 수 있는 기능을 추가했어요.
  • 의견 보내기 기능을 추가했어요.
  • Pro 기능을 업데이트했어요.
  • Payment 객체에 cashReceipts 필드가 추가됐어요. 현금영수증 발급・취소 정보를 배열로 확인할 수 있어요.

2023년 3월

  • 결제 UI 설정을 추가했어요.
    • PC에서도 결제위젯의 모바일 뷰를 적용할 수 있어요.
    • 결제위젯의 기본 패딩 값을 없앨 수 있어요.
  • 가상계좌 기능을 업데이트했어요.
    • 상점관리자에서 가상계좌의 입금기한을 설정할 수 있어요.
    • 구매자의 환불 계좌 정보를 입력받을 수 있어요. 입력된 환불계좌 정보는 API 응답으로 확인하세요.
  • 에스크로 지원을 추가했어요.
    • 에스크로가 계약된 상점에서는 계좌이체·가상계좌 결제에 에스크로 체크박스가 자동으로 나타나요.
  • PC, 모바일 환경에 따라 결제위젯이 적용된 화면을 미리 볼 수 있어요.

2023년 2월

  • 결제위젯 체험하기 페이지에서 어드민 기능을 체험할 수 있어요.
  • 아래 에러 코드를 추가했어요.
    • NEED_AGREEMENT_WITH_REQUIRED_TERMS
    • INVALID_SELECTOR
    • UNAUTHORIZED_KEY
    • NOT_REGISTERED_PAYMENT_WIDGET
  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    실시간 문의|이메일 보내기