변경내용
휴면, 탈퇴 대상
•
마지막 브랜드페이 이용 시점으로부터 1년 지난 회원은 휴면 처리가 되며, 5년 이상 사용하지 않은 회원은 탈퇴처리됩니다. 이용의 기준은 결제가 아닌 Access Token이나 Customer Token으로 브랜드페이의 어떤 API라도 이용했던 회원을 의미합니다.
사용자 Token 삭제
•
휴면 처리가 되는 경우 회원의 Access Token, Refresh Token은 모두 삭제됩니다.
API 에러 추가
•
휴면 회원으로 Access Token을 발급하거나 Basic 인증(Secret Key 이용 방식)과 customerKey를 조합하여 인증하는 API의 경우 다음과 같은 에러 응답을 받게 됩니다.
◦
HTTP Code: 403
◦
에러 코드: REQUIRED_DORMANT_VERIFICATION
◦
에러 메시지: 장기간 서비스 미사용으로 인한 휴면 상태로 계정이 잠겼습니다. 본인 인증으로 휴면 해제 후 다시 시도해 주세요.
휴면 해제를 위한 API 추가
•
휴면처리된 회원은 본인 인증 API를 제외한 모든 API를 이용할 수 없으며, 휴대폰 본인 인증 과정을 다시 거쳐야 서비스를 이용할 수 있습니다.
•
본인휴면 처리를 위한 인증 SMS 관련 API가 두 개 추가되었습니다.
◦
Secret Key 인증을 이용한 본인 인증 SMS 코드 발급, 본인 인증 SMS 코드 확인 API가 그 두 가지입니다.
◦
API 스펙은 다음 링크에서 확인하실 수 있습니다. https://www.notion.so/tosspublic/API-ad43e5bb4b2349dfb6866177392962f9
JS SDK
•
브랜드페이 JS SDK를 이용하는 경우, SDK의 method를 호출할 때 휴면 회원은 자동으로 메시지를 보여주며 본인인증 과정을 실행합니다.
•
결제수단 위젯 메소드를 실행하는 경우 다음과 같은 화면이 렌더링됩니다.
확인해주셔야하는 내용 및 대응 방법
API 에러 추가
•
자동 결제 실행 API,와 같이 secret key를 이용하면서 사용자의 action 없이 실행되는 API를 휴면 회원에 대해 실행하는 경우REQUIRED_DORMANT_VERIFICATION 에러 처리가 필요합니다.
사용자 Token 삭제
•
Access Token을 이용한 서버 API를 사용하는 경우, 회원이 휴면 처리가 되면 Access Token, Refresh Token이 모두 삭제되기 때문에 토큰이 삭제된 경우에 대한 처리가 되어있는지 확인이 필요합니다.
휴면 해제
•
휴면 처리된 회원을 휴면 해제하고 싶은 경우, JS SDK의 어떤 메소드를 호출해도 휴면 해제 화면이 나타나기 때문에 JS SDK를 이용하시는 것을 권장합니다.
•
휴면 해제 화면이 아니라 서버 API를 이용해야하는 경우, 본인 인증 SMS 관련 API를 이용해야 합니다.
JS SDK
•
서버 API를 사용하지 않고 JS SDK만 이용하는 경우 SDK에서 휴면 해제 처리를 해주기 때문에 별 다른 고려사항이 필요하지 않습니다.