브랜드페이 할부 및 조회 UI 관련 문의
1. 현재 브랜드페이 계약 후, 고객이 브랜드페이를 통해 결제 수단을 등록하면 저희가 해당 정보로 필요한 시점에 결제를 요청하는 방식으로 구현하여 이용 중입니다. 고객의 payment key를 통해 결제를 진행할 때, 결제 금액을 일시불이 아닌 할부로 결제가 가능한가요? 가능하다면 payments API에 어떻게 요청해야 하나요?
2. 브랜드페이로 등록한 결제수단을 조회하는 화면을 구현하려고 할 때, 결제 위젯의 renderPaymentMethods() 메서드를 이용하니, 첨부한 이미지처럼 하단에 "일시불/할부 선택"과 "결제 혜택"이 함께 보이더라구요. 이 영역을 제외하고 브랜드페이에 등록된 결제 수단만 화면에 노출되도록 하려면 어떻게 해야 할까요? 그리고 이 화면에서 "일시불"을 "할부"로 전환할 경우에는 이 결제 수단으로 결제 진행 시 계속 할부가 적용되는건가요?
19 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
현재 브랜드페이 연동을 어떤 js sdk 로 하고 계신지 확인부탁드립니다.
버전별로 가이드가 달라서요.
현재 사용 중인 sdk 버전 정보는 아래와 같아요.
"@tosspayments/brandpay-sdk": "^1.5.2",
"@tosspayments/payment-widget-sdk": "^0.10.2",
"@tosspayments/tosspayments-sdk": "^2.4.0",
결제위젯에 브랜드페이를 같이 사용하시는 건 아니죠?
사용하시는 브랜드페이 SDK 가 이것이실것 같은데요.
브랜드페이 위젯 연동하기 | 토스페이먼츠 개발자...
브랜드페이 JavaScript SDK를 이용해 브랜드페이 위젯을 사용해보세요.
getpaymentparams 을 이용하면 현재 UI 에 선택된 각종 파라미터값을 가지고 올수 있어요.
이걸 가져다가 requestPayment 할때 넘기시면 됩니다.
2, 이부분은 어쩔수 없는데 가능하면 그냥 API 로 결제 수단 가져와서 UI 를 직접 그리시는게 좋고,
그게 아니라면 amount 를 0으로 렌더링 하셔서 할부개월 선택이 불가능하도록 하셔도 될것 같습니다.
네 그럼 브랜드페이로 등록된 결제수단으로 할부가 가능한건가요? 만약 가능하다면 할부 여부를 유저가 최초 등록 시 설정했다면, 앞으로 그 결제수단으로 저희가 결제 요청할 때마다 최초에 설정한 할부 개월로 계속 결제가 되는건가요?
브랜드페이 자동결제를 말씀하시는 거죠?
브랜드페이로 등록된 결제수단으로 단건 걸제는 할부가 가능합니다.
네 저희가 필요한 때에 직접 요청하고 있어요
저희가 직접 요청(빌링)하는 경우엔 할부가 안되는건가요?
자동결제도 할부는 가능한데, 어차피 API 로 할부개월수를 보내실거라 그걸 고객이 선택한걸 보내실지, 아니면 일시불로 보내실지는 알아서 정해 주시면 되요.
자동 결제도 할부가 가능하군요. 그럼 현재 'https://api.tosspayments.com/v1/brandpay/payments' API를 이용하여 자동 결제 요청을 하는데 이 때, 어떤 파라미터가 할부 개월을 의미하는건가요?
그리고 유저가 브랜드페이에 결제 수단을 등록할 때에 "일시불/할부 개월"을 선택하는 건가요? 선택한다면 그렇게 설정된 값이 디폴트로 설정되어, 해당 결제 수단으로 결제 요청시 자동 적용되는건가요?
'https://api.tosspayments.com/v1/brandpay/payments' API를 이용하여 자동 결제 요청을 하는데 이 때, 어떤 파라미터가 할부 개월을 의미하는건가요?네 맞습니다. 결제수단 등록할때 할부정보는 아무 의미 없습니다. 자동 적용되지 않고 api 로 요청하실때 할부개월을 보내면 그게 적용됩니다.
그럼 할부 여부는 결제 수단에 매핑되는게 아니라, 결제 시점에 payment 객체에 매핑되는 정보라고 이해하면 될까요?
그럼 결제 위젯에서 브랜드페이를 통해 단건 결제할 때, 선택한 "일시불/할부" 여부가 적용되는 것이고, 자동 결제(빌링) 시 저희가 유저측으로부터 "일시불/할부" 여부를 전달받아서 결제 승인 API를 호출할 때 해당 내용이 적용된다는 말씀이시죠?
네 맞습니다. 그렇게 처리해 주셔야 해요. 결제 건별로 지정하셔야 합니다.
확인 감사합니다. 그리고 위에 적은 것 처럼 현재 'https://api.tosspayments.com/v1/brandpay/payments' API를 통해 자동 결제(빌링) 요청을 하고 있는데 이 API는 이전 버전인가요? API 문서를 찾아봐도 없어서요. 혹시 해당 API 스펙 문서 정보를 알 수 있을까요?
아뇨 RM 심사가 된 가맹점만 사용할수 있는 API 여서 숨겨두었습니다.
브랜드페이 자동결제 | 토스페이먼츠 개발자센터
브랜드페이에서 제공하는 자동결제 SDK 와 API 엔드포인트(Endpoint)의 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
여기 참고하세요.
아 확인했습니다. 감사합니다!