Skip to main content
스텝페이는 구독매니저를 통해 고객이 직접 구독 관리를 할 수 있도록 SDK를 제공하고 있습니다. 상품 빌더를 통해 판매된 구독 상품에 대해 구독자가 직접 ‘구독 상태 변경’, ‘결제일 변경’, ‘상품 수량 및 옵션 변경’, ‘주기 변경’, ‘배송지 및 결제 수단 변경’에 대한 처리를 할 수 있습니다. 마이페이지에서 제공되고 있는 기능이지만 구독매니저 SDK 임베딩을 통해 다른 웹페이지에도 적용이 가능합니다. 구독 매니저의 인증을 위해서는 Session Key를 발급받아야 합니다. 발급 받은 구독매니저 세션은 5분간 유지되며 가맹점의 고객에게 스텝페이의 인증을 처리하는데 사용됩니다. Session Key 발급은 세션 생성 API를 사용하여 발급받을 수 있습니다. subscription_sdk_list.png

​
사전 준비 작업

  • Secret-Token 확인하기
  • 스텝페이 포탈 또는 API를 통해 상품이 생성되어 있어야 합니다.
  • 스텝페이 포탈 또는 API를 통해 가격 플랜이 생성되어 있어야 합니다.

​
API 사용 예시

기능MethodEndpoint
세션 생성GET/api/v1/session/

​
세션 생성

  • Request
curl --request GET \
     --url https://api.steppay.kr/api/v1/session/236948 \
     --header 'Secret-Token: ${Secret-Token}' \
     --header 'accept: */*'
  • Response
MRQVmDRTBLBcfTIW

​
SDK Embed 렌더링

​
STEP 1 Session Key 발급하기

  • 가맹점 백엔드에서 세션 생성 API를 호출하여 키를 발급받습니다. 이 때 가맹점의 고객이 스텝페이에도 등록되어 있어야 합니다.

​
STEP 2 구독 매니저 SDK Embed 코드 확인하기

  • 스텝페이 포탈에서 [설정 → 구독 매니저 → SDK]에서 Embed Code를 확인합니다. 구독매니저 SDK 적용 예시 이미지
STEP 3 브라우저에 렌더링하기
  • STEP 2에서 알게 된 SDK Embed 코드로 브라우저에서 렌더링 합니다. session엔 STEP 1에서 생성한 Session Key를 입력합니다.

​
SDK Embed 렌더링 예시

<script defer src='https://cdn.steppay.kr/production-loader.js'></script>
<div id='step-shop-embed' data-type='subscription'>
  <script type='application/json'>
    {
      "storeUuid": `${UUID}`,
      "session": `${Session Key}`
    }
  </script>
</div>