브랜드페이 - 자동결제 연동 관련 문의
브랜드페이 카드 자동결제 계약 완료 후 브랜드페이 sdk를 이용한 연동 개발 중에 몇가지 문의사항이 있습니다.
1. openSettings() 메서드를 실행해서 나오는 UI의 변경이 가능한가요? 예를 들어 등록 가능한 결제 수단을 카드로 제한하고 싶은데 카드만 등록이 가능한 UI 로 적용이 가능한가요?
2. 브랜드페이 - 카드 자동 결제 기능을 이용해 결제를 진행할 때 유저가 필수적으로 동의해야 하는 이용약관은 무엇인가요? 카드/회원가입/빌링 이렇게 3가지 인가요?
3. 결제 수단 조회(getPaymentMethods()) 메서드는 실행 시 UI를 그려주지 않더라구요. 혹시 등록한 결제 수단을 조회할 수 있는 화면으로 연결되도록 하는 방식이 있나요? renderPaymentMethods 이 메서드가 그 방식인가요?
4. createPaymentMethodsWidget() 이라는 메서드가 있던데 이 메서드는 requestPayment 를 할 때만 적용되는 메서드라고 보면 될까요?
각 항목들에 대한 답변 부탁드립니다.
16 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
문의 주시는 내용이 브랜드페이 SDK와 위젯이 섞여 있는 것으로 보이네요.
위젯 통해서도 브랜드페이를 사용하실 수는 있어요.
브랜드페이와 위젯을 각각 사용하시려는건가요?
브랜드페이 sdk 만 사용하고 있습니다.
전에 문의드렸을 때 결제 위젯 sdk 를 사용하는 경우엔 특정 결제 화면을 통해서만 '설정', '결제등록' 페이지 등 모든 페이지로 접근이 가능하다고 해서요.
저희 서비스는 카드를 결제 수단으로 등록하고 추후 어느 시점에 자동으로 결제 되는 방식이에요.
따라서 결제수단을 조회하고 등록하는 페이지에 독립적으로 접근이 필요한 상황입니다.
1) 이용가능한 결제수단을 카드 만으로 제한은 가능하지만, 이용가능 결제수단이 카드 / 계좌일때, 등록가능한 수단을 openSettings() 를 통해서 카드만 제한하는 기능은 제공하고 있지 않습니다. addPaymentMethod() 를 이용 해주시기 바랍니다.
https://docs.tosspayments.com/reference/brandpay-sdk#addpaymentmethod%EC%B9%B4%EB%93%9C%EA%B3%84%EC%A2%8C
2) 네, 맞습니다.
3) openSettings() 를 이용해주시면 됩니다. renderPaymentMethods 는 결제위젯 메서드 입니다.
4) createPaymentMethodsWidget() 는 어디에서 보셨나요?
브랜드페이 JavaScript SDK | 토스페이먼츠 개발자센터
브랜드페이 JavaScript SDK를 추가하고 메서드를 사용하는 방법을 알아봅니다.
1) openSettings() 메서드를 통한 화면 구성에 대한 변경은 절대적으로 불가능하다는 말씀이신가요? 만약에 카드 결제만 지원하고 있다면 openSettings() 화면에서 계좌 등록을 시도할 시 어떻게 되나요?
2) 카드/회원가입/빌링 3가지가 모두 AND 조건으로 필수라는 말씀이신가요? 그렇다면 brandpay.requestAgreement(['빌링', '회원가입', '카드']) 이렇게 array로 요청하면 되나요?
3) 등록한 결제 수단을 조회할 수 있는 화면이 필요한 상황에서 openSettings() 메서드를 사용하면 결제수단 관리 뿐만 아니라 결제 비밀번호 설정, 이메일 관리 메뉴까지 한번에 뜨니까 완벽하게 대체되는건 아닌거죠?
4) "https://docs.tosspayments.com/guides/brandpay/widget#createpaymentmethodswidget%EA%B2%B0%EC%A0%9C-%EA%B8%88%EC%95%A1" 이 링크에서 발견했습니다.
브랜드페이 위젯 연동하기 | 토스페이먼츠 개발자센터
브랜드페이 JavaScript SDK를 이용해 브랜드페이 위젯을 사용해보세요.
1) 네, 화면 구성에 대한 변경은 절대적으로 불가 합니다.
개발자센터 - 브랜드페이에서 제공하는 결제수단 토글로 관리할 수 있고
카드만 선택 했을때, 카드만 등록 할 수 있습니다.
테스트 환경에서도 확인 해볼수 있으니, 직접 시도해보시면 이해 되실 겁니다.
2) 보통 브랜드페이 서비스 이용하게 되면, 별도 약관 요청 할 필요 없이 브랜드페이 SDK 내에서 약관을 다 받습니다. 이때 회원가입, 카드 약관은 고객이 다 동의하게 될거고
빌링만 별도로 받으면 되는것으로 이해해 주시면 됩니다.
그 전에, 브랜드페이 빌링 이용은 리스크 심사 승인이 완료 되어야 사용할 수 있습니다. 리스크 심사를 먼저 완료하시고 빌링 스펙을 살펴 보시기 바랍니다.
3) "완벽하게 대체" 라는게 단순히 등록한 결제수단만 보게 하고 싶으신것 같은데, 그러면 getPaymentMethod() 로 등록된 결제수단 불러와서 직접 화면을 구성 해주시기 바랍니다.
4) 이건 브랜드페이 위젯 입니다. 프론트엔드에 렌더링할때 사용하는 용도 입니다. 결제위젯 연동 방식을 이해하면 이 역시 연동 방식을 이해 할 수있습니다. 역시 테스트 환경에서 시도 해볼수 있으니, 직접 렌더링 해보시면 어떤 화면인지 더 쉽게 이해하실 수 있으실 겁니다.
1) 개발자센터 - 브랜드페이에서 제공하는 결제수단을 "카드"로만 설정하니 계좌 등록 탭이 사라졌네요ㅎㅎ 이 부분은 해결이 된 것 같습니다. 다만 그럼에도 불구하고 "결제 비밀번호 설정" / "이메일 관리" 부분은 없앨 수 없다는 말씀이시죠? 그렇다면 직접 화면단을 개발해야 겠군요.
2) 브랜드페이 sdk에서 약관을 다 받는다는게 유저들이 어느 시점에서 받는 것인가요? 따로 구현할 필요가 없다는 말씀인가요? 브랜드페이 빌링이 자동결제(카드)를 의미하는 건가요? 그렇다면 이미 계약이 체결되었고 시스템 세팅이 완료되었다는 안내를 받았습니다. 별도로 리스크 심사 승인이 필요한 부분인가요?
3) 네 이해했습니다.
4) 브랜드페이 위젯과 브랜드페이 sdk 개념에 혼동이 있습니다. 브랜드페이 sdk 에서도 프론트엔드에서 화면을 띄울 수 있던데 이건 브랜드페이 위젯과는 다른건가요? 브랜드페이 위젯과 결제 위젯은 또 어떻게 다른건가요? 브랜드페이 sdk, 브랜드페이 위젯 sdk, 결제 sdk, 결제 위젯 sdk 이렇게 크게 4가지가 각각 다른 것이라고 보면 될까요?
1) 네 맞습니다.
2) 브랜드페이 계약과, 브랜드페이 "빌링" 리스크 심사는 별개 입니다. 브랜드페이 "빌링" 리스크 심사까지 완료 되었는지 확인 부탁 드려요.
3) Done
4) 아래 3개 이고
결제위젯 SDK
일반결제 SDK
브랜드페이 SDK
브랜드페이 SDK 로 브랜드페이 위젯 렌더까지 커버 합니다.
확인 감사합니다.
문서에는 "브랜드페이 위젯은 브랜드페이 SDK에서 제공하는 기능으로 결제수단을 등록하고 선택하는 UI, 결제수단마다 달라지는 프로모션 정보를 보여주는 UI를 제공합니다." 라고 되어있는데,
그럼 브랜드페이 위젯을 연동한다면 화면을 직접 개발하지 않아도 토스에서 제공하는 UI를 가져다 쓸 수 있나요?
만약 그렇다면 브랜드페이 위젯을 통해 제공되는 모든 UI(화면) 정보를 확인할 수 있는 문서가 있을까요?
결제위젯내 브랜드페이가 브랜드페이 위젯과 동일하기때문에
https://docs.tosspayments.com/guides/payment-widget/integration-brandpay
이 문서 보시면 됩니다.
브랜드페이 연동하기 | 토스페이먼츠 개발자센터
일반 결제와 내 상점만의 자체 간편결제 시스템 브랜드페이를 한 번에 연동하고 싶다면 결제위젯에 브랜드페이를 추가하세요.
네 감사합니다.
방금 고객센터 통해서 확인했는데 브랜드페이 "빌링" 리스크 심사까지 완료된 상태라고 전달 받았습니다.
다시 질문으로 돌아와서 유저가 브랜드페이-자동결제 기능을 이용하기 위해서 약관 동의를 받아야 하는 것이 어느 시점에서 받는 것인가요? brandpay.requestAgreement(['빌링', '회원가입', '카드']) 이렇게 array로 요청하면 되나요?
브랜드페이 빌링 이용하기 위해서, 카드 등록을 먼저 하게 될텐데,
이때
1) 휴대폰 본인 인증을 통한 가입 절차를 마무리 하고
2) 카드 정보를 입력해서 등록을 하게 됩니다.
1, 2번에서 회원가입, 카드 약관동의가 완료 된 겁니다.
그렇기에 회원가입, 카드를 보내지 마시고요
빌링 약관 동의를 별도로 받으시면 되는데, 약관동의 방법이 두가지가 있습니다.
1) 지금 이야기 하는 SDK 메소드 이고요
2) API 가 있습니다.
최종 정리 할게요.
1) 회원가입, 카드 등록으로 회원가입, 카드 약관 동의가 완료 된 겁니다.
2) 빌링 약관 동의를 별도로 받으면 됩니다.
2-1) 토스페이먼츠 SDK 메소드 통해서 받으시거나
2-2) API 로 scope billing 조회해서, API 로 동의 진행 할 수 있습니다. (화면 구성은 직접 하셔야 겠지요)
브랜드페이 API 를 보시면 미동의 약관 조회 API 가 있는데,
어떤 단계에서 어떤 scope 의 약관이 완료 되는지 확인 하실 수 있으니,
이 API 활용해서 보셔도 좋습니다.
https://docs.tosspayments.com/reference/brandpay#%EB%AF%B8%EB%8F%99%EC%9D%98-%EC%95%BD%EA%B4%80-%EC%A1%B0%ED%9A%8C
브랜드페이 API | 토스페이먼츠 개발자센터
브랜드페이에서 제공하는 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
상세한 답변 감사합니다.
명확하게 이해되었습니다!
👍
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.