Developers
제휴사 연동

제휴사 연동 개요

제휴사 사이트에서 구매한 책·강의를 쏠브 앱에서 그대로 이용하게 하는 연동입니다.

제휴사 사이트에서 책이나 강의를 구매한 회원이 쏠브 앱에서 제휴사 계정으로 한 번 로그인하면, 구매한 콘텐츠가 쏠브 책장에 자동으로 들어옵니다. 이 문서는 그 연동을 제휴사 개발자가 직접 구현할 수 있도록 정리한 가이드입니다.

3줄 요약

  1. 제휴사는 API 2개(로그인, 구매내역)를 만듭니다. 쏠브가 이 API 를 호출합니다.
  2. 전자책을 쏠브 파트너 어드민에 등록할 때 연동코드(제휴사 상품코드)를 입력합니다. 어드민을 쓰지 않으면 상품 목록 파일로 대신합니다.
  3. 쏠브가 테스트 계정으로 앱 화면까지 확인한 뒤 출시합니다.

누가 무엇을 하나요?

로그인·구매내역은 쏠브가 호출하는 쪽, 제휴사가 구현하는 쪽입니다. 제휴사는 ⓑ 방식의 콜백과, 환불 판단에 필요한 경우 열람 여부 조회 API를, 회원별 열람 이력이 필요한 경우 열람 기록 조회 API를, 환불·취소·탈퇴를 바로 반영하려는 경우 회수 알림 API를 호출합니다.

구분제휴사쏠브
로그인로그인 API(ⓐ) 또는 로그인 페이지(ⓑ)를 구현앱에서 로그인 화면을 띄우고 user_key 저장
구매내역user_key 를 받아 현재 유효한 상품코드 목록을 반환필요할 때 호출해 책장 권한을 부여·회수
상품 연결파트너 어드민에 전자책 등록 + 연동코드 입력 (또는 상품 목록 파일 전달)연동코드로 상품을 매칭
열람 조회(선택)환불 판단 직전에 열람 여부 조회 API 호출다운로드를 포함한 최초 열람 시각 반환
테스트테스트 계정과 URL 전달실제 호출과 앱 화면으로 검증

한눈에 보기

회원의 로그인 방식에 따라 두 가지가 있습니다. 소셜 로그인(카카오·네이버·구글 등)을 함께 운영하면 로그인 페이지 방식입니다.

  1. 회원 → 제휴사: 책 구매. 회원이 제휴사 사이트에서 책을 삽니다. 여기까지는 지금과 같습니다.
  2. 회원 → 제휴사: 로그인 화면 열기. 쏠브 앱에서 "제휴사 연동하기"를 누르면, 앱 안에 제휴사 로그인 화면이 열립니다.
  3. 회원 → 제휴사: 평소처럼 로그인. 회원은 아이디나 카카오·네이버·구글 등 평소 쓰던 방법으로 로그인합니다.
  4. 제휴사 → 쏠브: "100023번 회원 로그인했어요". 로그인이 끝나면 제휴사 서버가 쏠브에 회원 번호를 알려 줍니다. 쏠브는 돌아갈 주소를 답해 줍니다.
  5. 제휴사 → 회원: 받은 주소로 이동. 제휴사가 회원 화면을 그 주소로 보내면 연동이 끝납니다. 같은 화면 안에서 이동해야 합니다.
  6. 쏠브 → 제휴사: "이 회원 뭐 샀어요?". 쏠브가 제휴사에 이 회원이 지금 볼 수 있는 상품을 물어봅니다.
  7. 제휴사 → 쏠브: 상품코드 목록. 제휴사는 구매한 상품의 코드 목록으로 답합니다. 환불된 상품은 빼고 보냅니다.
  8. 쏠브 → 회원: 책장에 책 추가. 쏠브가 상품코드로 전자책을 찾아 회원의 책장에 넣습니다. 상품코드는 파트너 어드민에 미리 등록해 둡니다.

회원

쏠브 앱

제휴사

사이트·서버

쏠브

서버

1

회원이 제휴사 사이트에서 책을 삽니다. 여기까지는 지금과 같습니다.

  1. 회원 → 제휴사: 책 구매. 회원이 제휴사 사이트에서 책을 삽니다. 여기까지는 지금과 같습니다.
  2. 회원 → 쏠브: 아이디·비밀번호 입력. 쏠브 앱에서 "제휴사 연동하기"를 누르고 제휴사 아이디와 비밀번호를 입력합니다.
  3. 쏠브 → 제휴사: "이 아이디 맞나요?". 쏠브 서버가 제휴사에 아이디와 비밀번호가 맞는지 물어봅니다.
  4. 제휴사 → 쏠브: "100023번 회원이에요". 맞으면 제휴사가 회원 번호로 답합니다. 틀리면 "비밀번호 불일치"로 답합니다.
  5. 쏠브 → 제휴사: "이 회원 뭐 샀어요?". 쏠브가 제휴사에 이 회원이 지금 볼 수 있는 상품을 물어봅니다.
  6. 제휴사 → 쏠브: 상품코드 목록. 제휴사는 구매한 상품의 코드 목록으로 답합니다. 환불된 상품은 빼고 보냅니다.
  7. 쏠브 → 회원: 책장에 책 추가. 쏠브가 상품코드로 전자책을 찾아 회원의 책장에 넣습니다. 상품코드는 파트너 어드민에 미리 등록해 둡니다.

전체 흐름 (시퀀스)

어디서부터 볼까요?

이 페이지 목차