브랜드페이에 대해 문의 드립니다.
당사의에서 브랜드페이를 통한 비정기 자동 결제 시스템을 구축하고자 합니다.
영업팀에 전달 받기론 결제위젯(Basic Version)을 사용하여 자동결제(빌링) 카드 등록 과정을 통해 발급 받은 빌키로 브랜드페이 결제가 가능하다고 하던데, 맞는 이야기 인가요?
만약, 브랜드페이 결제위젯(Pro Version)을 사용해서 카드 등록 과정이 필수라고 한다면, 결제 비밀번호를 기입하던데 사용자가 비밀번호를 넣지 않고도 비정기 자동 결제를 할 수 있는지 문의 드립니다.
76 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
네 브랜드페이에 고객이 카드를 등록하면 자동결제가 가능합니다.
사용자가 비밀번호를 넣지 않고 비정기 결제를 하는 방식은 토스페이먼츠 정책적으로 허용하지 않고 있습니다.
확인 감사합니다. 영업팀에 다시 한번 문의 해보겠습니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
안녕하세요, 영업팀에 문의해본 결과 리스크팀과 협의하에 허가된 부분이라고 합니다.
브랜드페이 사용 시 카드 등록 과정을 토스에서 제공하는 UI를 사용하고자 합니다. (결제위젯은 아니라고 함) 관련된 창을 호출 할 수 있는 가이드를 받을 수 있을까요?
결제위젯 JavaScript SDK | 토스페이먼츠 개발자센터
결제위젯 JavaScript SDK를 추가하고 메서드를 사용하는 방법을 알아봅니다.
결제위젯 v1을 활용해서 연동해주시면 됩니다.
고객이 정기결제를 위해서 카드를 선택할텐데요.
https://docs.tosspayments.com/sdk/widget-js#getselectedpaymentmethod
- 위 method를 활용해서 methodId를 획득합니다.
- methodId를 가지고 methodKey를 획득합니다. (https://docs.tosspayments.com/reference/brandpay#secretkey로-결제수단-조회)
- methodKey를 가지고 정기결제를 합니다. (https://docs.tosspayments.com/reference/brandpay#자동결제-실행)
결제위젯 JavaScript SDK | 토스페이먼츠 개발자센터
결제위젯 JavaScript SDK를 추가하고 메서드를 사용하는 방법을 알아봅니다.
브랜드페이 API | 토스페이먼츠 개발자센터
브랜드페이에서 제공하는 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
답변 감사합니다. v1의 경우 일반 방식이고 v2의 경우 결제위젯 Pro 방식인 건가요?
아뇨 v1/v2단 단순연동방식 차이입니다. 모두 pro가 가능하고요
https://docs.tosspayments.com/sdk/widget-js#getselectedpaymentmethod
위 method가 v1에서만 지원해서 , v1으로 연동해주셔야해요
결제위젯 JavaScript SDK | 토스페이먼츠 개발자센터
결제위젯 JavaScript SDK를 추가하고 메서드를 사용하는 방법을 알아봅니다.
네, 이해 했습니다. 감사합니다. 🙂
브랜드페이 SDK v1 -> addPaymentMethod 호출 시 화면에 "customerToken이 존재하지 않습니다." 가 나오는데 어떤 값이 잘못 된건지 확인 부탁드립니다. (처음 카드 등록 완료하니 위 메세지가 나왔고 그 후부터 addPaymentMethod 호출 시 해당 메세지가 노출 됩니다.)
customerToken 에러가 발생하는건 redirectURL 구현을 안하신것 같습니다.
브랜드페이 연동하기(Version 1) | 토스페이먼츠 개발자센터
브랜드페이에서는 자체 간편결제에 사용할 수 있는 UI를 쉽게 가져다 쓸 수 있는 브랜드페이 JavaScript SDK 연동 가이드입니다.
브랜드페이 인증하기 | 토스페이먼츠 개발자센터
브랜드페이 인증은 OAuth 2.0 인증 프레임워크를 기반으로 구현되어 있습니다. 브랜드페이에서 Access Token을 발급하고 사용하는 방법을 안내합니다.
여기도 같이 확인 부탁드립니다.
확인해보겠습니다. 감사합니다.
/v1/brandpay/authorizations/access-token Request 시 code: 'UNAUTHORIZED_KEY' 응답이 오는데, 시크릿 키 클라이언트 키가 인증되지 않았다고 응답 됩니다. 테스트 시에도 브랜드페이에 대한 어떤 승인 과정이 있어야 하나요?
브랜드페이 MID 의 시크릿키로 Base64 Encoding 이 제대로 되지 않았을때 등에 응답되는 에러 입니다.
testsk... 로 시작하는 시크릿키를 Base64 인코딩 하여 헤더에 포함하여 전달한 거 같습니다.
헤더에 전달한 값을 디코딩 해보니 원본 데이터가 정상적으로 보입니다.
addPaymentMethod 에 사용한 클라이언트 키에 매핑되는
해당 테스트 키의 시크릿키 + : 로
base64 까지 해서
잘 인코딩 했다는 의미 맞으시지요?
시간이 언제쯤 인가요?
네 맞습니다.
시간 알려주세요
17:09:57
토스로 부터 응답 받은 시간 입니다.
access-token 쪽 구현한 소스코드 알려주시고,
사용한 키는 아래 정보제출을 통해 제출 해주세요
💡 정보 제출
민감 정보를 안전하게 제출해주세요
전달 드렸습니다
Header 에서 Authorization 은 원래 '' 로 안 묶어 주나요?
'Authorization'
이렇게 안묶어도 되는게 스펙이 맞나요? 이 부분 잘 몰라서요.
네 상관없습니다
헤더 이름에 '-'만 없으면 안묶어도 됩니다.
process.env.TOSSPAYMENT_SECRET_KEY 가
testsk 로 시작되는 값으로 설정된것 맞나요?
그리고, 저희측으로 정상 요청된 것은 맞나요?
말씀 하신 시간대로 인입 로그가 안보입니다.
네, 맞습니다. 그리고 첨부드린 로그에서 e : { 가 토스에서 응답 받은 내용 입니다.
addPaymentMethod 메소드 호출부터 다시 시도 해볼 수 있을까요?
서버에서 code, customerKey 받은것 로그 보시고
postman 등에서 호출 되는지도 따로 해보실 수 있다면 더 좋을것 같습니다.
코드 상에서 headers 선언에 문제가 있었습니다. 해결 되었습니다. 감사합니다.
네 감사합니다.
카드 등록 후에 오는 토큰과 본인인증 후에 오는 토큰의 차이점은 무엇인가요?
AccessToken 말씀하시는 건가요?
지정한 redirectUrl로 카드 등록 후, 본인 인증 후 이렇게 각각 두번이 오는데 정상적인거죠?
AccessToken 객체 맞습니다.
@냥과장 확인 부탁드립니다~
네 아마 redirectUrl 은 거의 화면 뜰때마다 호출되실겁니다.
그러면 최종적으로 온 Access Token 객체를 사용해야하는게 맞는거죠?
네 맞습니다. 그런데 그렇게 연속으로 호출되는 경우 토큰값은 동일할겁니다.
카드 등록 시 응답 받은 Access Token과 본인 인증 후 Access Token 객체가 다르더라구요..
customerkey 알려주실수 있을까요?
만약 다르다면 나중에 받으신 값을 쓰시는게 맞습니다.
네, 우선 customerKey를 임의 채번하여 다른 결과를 받은 customerKey는 알 수가 없습니다.
말씀 주신대로 후자를 반영하여 개발 진행하겠습니다.
패스워드 없이 브랜드페이로 결제를 하기 위해선 원터치결제를 활성화 해야만 하나요?
네 그렇습니다만 무조건 패스워드가 없어지는 건 아닙니다.
저희 FDS 에 의해 인증이 필요하다고 판단되면 비밀번호를 입력받습니다.
현재 SDK v1으로 카드등록까지 연동을 마쳐 결제를 하려고 보니 과정이 결제창을 띄운 후 결제요청을 해야하는거 같은데 바로 결제 요청을 할 수 있는 방법은 없나요?
이걸 사용하시면 되는데 별도로 사용 신청을 하셔야 합니다.
브랜드페이 API | 토스페이먼츠 개발자센터
브랜드페이에서 제공하는 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
1544-7772 로 브랜드페이 빌링 신청을 하신후에 사용하실수 있습니다.
토스페이먼츠 결제연동팀
테스트 키도 브랜드페이 빌링 신청을 해야하나요?
라이브에 신청이 안되어 있으면 테스트도 사용하실수가 없습니다.
저희는 SI 개발사여서 전자결제 신청을 하지 않을 예정입니다.. 테스트를 위해선 불가피 한가요?
아예 계약 안한 저희 테스트 전용상점 키를 사용하시는 건가요?
네 맞습니다.
개발자센터 회원가입만 한 상태입니다.
그럼 저 API 그냥 한번 ㅂ쏴보세요.
네 한번 해보겠습니다.
테스트 전용상점은 사용가능할겁니다.
혹시 addPaymentMethod를 통해 카드 등록을 하는 것만으로는 "/v1/brandpay/payments/methods" 여기서 응답을 받을 수 없나요?
최초 가입하시는 거라면 카드 정보 넣고 본인인증 하신후에 응답을 받을수 있습니다.
네 확인 했습니다~ 감사합니다~
안녕하세요, 결제수단 등록 시 redirectUrl 로 요청이 OPTIONS 메서드로 들어와 저희쪽 서버에서 204 response가 됐음에도 본 요청이 들어오지 않는데 어떻게 처리되야 할지 가이드 부탁드리겠습니다.
자바스크립트에서 오류는 아래와 같이 발생 합니다.
KnownError: customerToken이 존재하지 않습니다.
at card-6b37b2f1897b804d.js:1:1310
at async 8568-ef9b3c7fafd52730.js:1:22609Caused by: React ErrorBoundary Error: customerToken이 존재하지 않습니다.
CORS는 모두 허용되어 있습니다.
redirectURL 에서 accessToken 을 요청하셨는데, 요청하셨다면 정상 응답을 받으셨는지 확인해 주세요.
이게 서버 쪽과 무관하게 크롬에서 CORS 프리플라이트 요청을 하는거 같은데, 자사 서비스 API는 OPTIONS 요청 후 본 요청이 정상적으로 들어오는데
redirectURL은 OPTIONS 요청 후 본 요청이 오지 않고 있습니다.
MID 알려주실수 있을가요?
테스트 입니다.
사용하신 MID 말씀드리는 겁니다.
tvivarepublica 인거 같습니다.
클라이언트 키, 시크릿 키만 사용하는데 MID는 다른거죠?
그럼 사용하신 클라이언트키 알려주세요.
test_ck_yZqmkKeP8g2vbO9o90JkrbQRxB9l 입니다.
혹시 CORS 허용은 하신건가요? 콘솔쪽에 다른 오류는 없으실까요?
도메인이 달라서 요청이 막혔을것 같아 보여서요.
CORS는 전체 허용으로 되어 있습니다.
일단 저희 로그상으로는 redirectURL 호출을 했고, 토큰 요청이 안온것으로 확인됩니다.
저 에러는 발급된 토큰이 없어서 오류가 발생하는 것으로 보이구요.
redirectURL 호출 시 어떤 응답을 받은 상황인지 알 수 있을까요?
호출을 브라우저 통해서 하기 때문에 저희가 받지 않습니다.
브라우저내에 iframe 을 통해서 redirect 처리 하고 있어요.
이전에 요청드린 문제는 cors 전체 허용이 아닌 특정 도메인만 허용 후 credentials : true 설정으로 해결 했습니다.
SDK v1에서 브랜드페이 addPaymentMethod 시 카드 등록 후 본인 인증 과정을 하지 않으면 결제가 불가능 한가요?
본인 인증 전 accessToken, refreshToken이 발급 되던데, 본인 인증을 사용자가 수행 했는 지 확인 할 수 있는 방법이 있을까요?
본인인증이 완료되어야 카드등록도 되기 때문에 결제가 가능해요
본인인증이 안되면 결제수단조회에도 내려오는게 없을겁니다.
네 알겠습니다.