<![CDATA[[프론트 플러그인] 통합결제창 API 요청 시 할부 관련 문의]]>어떤 제품을 사용하나요?
  • 제품: 프론트 플러그인

무엇이 궁금한가요?

  • Payment API의 requestPayment()를 호출하여 통합결제 화면을 띄울 때 parameter 에 할부개월(installment) 이 포함되어 있습니다. 현재는 고려하지 않고 기본값으로 전달하고 있습니다.
  1. 고객이 아직 현금, 카드 등의 결제수단을 선택하지 않은 상황이라서 저 시점에 저 값을 넘겨주는게 이상한 것 같은데 저 param의 의미가 할부개월이 맞나요?
  2. 위의 1)이 맞다면 혹시 통합결제 화면에서 할부개월 설정할 수 있는 화면을 표시하도록 하는 옵션이 있나요? 자체적으로 구현하여 통합결제화면 호출 시 넘겨줘야 하나요?

답변 부탁드립니다.

]]>https://forum.tossplace.com/topic/53/프론트-플러그인-통합결제창-api-요청-시-할부-관련-문의RSS for NodeSat, 07 Nov 2026 16:36:02 GMTMon, 19 Oct 2026 02:42:07 GMT60<![CDATA[Reply to [프론트 플러그인] 통합결제창 API 요청 시 할부 관련 문의 on Mon, 19 Oct 2026 07:16:33 GMT]]>안녕하세요. 토스플레이스 개발자센터입니다.

통합결제창의 할부개월 설정과 선택 화면에 대해 안내 드립니다.

  1. installment의 의미

    카드 결제에 사용할 초기 할부개월 값이며, 0은 일시불입니다. 결제수단을 미리 선택하는 값은 아니며, 통합결제창에서 카드 결제를 진행할 때 사용됩니다.

  2. 프론트에서 할부개월 선택

    5만 원 이상 카드 결제 시 프론트의 서명 화면에서 할부개월을 선택할 수 있습니다. ‘할부’ 항목을 누르면 선택 화면이 열리고, 고객이 선택한 값으로 승인이 요청됩니다.

    따라서 별도 할부 입력 화면을 개발하거나 표시 옵션을 추가할 필요는 없습니다. installment를 생략하거나 0으로 전달해도, 위 조건에서는 고객이 할부개월을 변경할 수 있습니다.

    실제 할부 승인 가능 여부는 카드사·카드 조건에 따라 달라질 수 있습니다.

결제 API 가이드

]]>https://forum.tossplace.com/post/116https://forum.tossplace.com/post/116Mon, 19 Oct 2026 07:16:33 GMT