릴리즈 노트

2025년 9월

토스페이먼츠 상점관리자에 테스트모드 기능이 공개됐어요. 상점관리자 화면 우측 상단의 토글 버튼을 켜면 테스트 상점관리자로 전환되며, 개발자센터에서 제공된 테스트키로 발생한 거래 건들을 확인하실 수 있어요.
기존 개발자센터에서 확인하실 수 있었던 제한적인 결제 내역보다, 더 실제 환경에 가까운 테스트를 진행할 수 있도록 라이브 상점관리자 수준의 결제 내역 및 정산 건별 내역을 지원해요.
실제 운영 환경과 동일한 결제·정산 플로우를 안전하게 검증하고, 연동 전 최종 점검을 빠르게 마칠 수 있어요.

2025년 6월

토스페이먼츠 결제 연동을 위한 MCP(Model Context Protocol) 서버가 공개됐어요.
AI Coding Agent 에 토스페이먼츠 결제연동 MCP 를 연동하면 더욱 빠르고 쉽게 결제 연동을 마칠 수 있어요.

2024년 10월

지급대행은 오픈마켓에서 발생한 매출을 토스페이먼츠가 오픈마켓을 대신하여 셀러(입점 판매자)에게 지급하는 서비스입니다. 직접 수많은 셀러에게 정산할 필요 없이, 정산 업무를 토스페이먼츠한테 맡기고 자금 흐름을 더 효율적으로 관리할 수 있어요. API를 사용하지 않아도 상점관리자에서 쉽게 지급 요청 및 관리를 편리하게 할 수 있도록 기능을 업데이트 했어요. 토스페이먼츠 상점관리자에서 지급요청서 작성/조회, 잔액관리, 셀러관리, 셀러KYC심사를 볼 수 있어요.

자세한 내용은 지급대행 서비스 이용 가이드를 참고해주세요.

2024년 9월

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

2024년 8월

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

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

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

2024년 7월

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

2024년 3월

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

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

2024년 1월

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

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

2023년 11월

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

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

2023년 10월

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

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

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

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

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

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

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

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

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

2023년 9월

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

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

2023년 8월

결제를 요청했을 때 사용자가 결제 정보를 입력하지 않으면 원래 위젯 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