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

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

X(트위터)를 팔로우하면 더욱 빠르게 업데이트 소식을 받아볼 수 있어요.

X(트위터) 팔로우하기
커버 이미지

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