제휴사 연동
제휴사 연동 개요
제휴사 사이트에서 구매한 책·강의를 쏠브 앱에서 그대로 이용하게 하는 연동입니다.
제휴사 사이트에서 책이나 강의를 구매한 회원이 쏠브 앱에서 제휴사 계정으로 한 번 로그인하면, 구매한 콘텐츠가 쏠브 책장에 자동으로 들어옵니다. 이 문서는 그 연동을 제휴사 개발자가 직접 구현할 수 있도록 정리한 가이드입니다.
3줄 요약
- 제휴사는 API 2개(로그인, 구매내역)를 만듭니다. 쏠브가 이 API 를 호출합니다.
- 전자책을 쏠브 파트너 어드민에 등록할 때 연동코드(제휴사 상품코드)를 입력합니다. 어드민을 쓰지 않으면 상품 목록 파일로 대신합니다.
- 쏠브가 테스트 계정으로 앱 화면까지 확인한 뒤 출시합니다.
누가 무엇을 하나요?
쏠브가 호출하는 쪽, 제휴사가 구현하는 쪽입니다. 제휴사가 쏠브 API 를 호출하는 일은 ⓑ 방식의 콜백 1건뿐입니다.
| 구분 | 제휴사 | 쏠브 |
|---|---|---|
| 로그인 | 로그인 API(ⓐ) 또는 로그인 페이지(ⓑ)를 구현 | 앱에서 로그인 화면을 띄우고 user_key 저장 |
| 구매내역 | user_key 를 받아 현재 유효한 상품코드 목록을 반환 | 필요할 때 호출해 책장 권한을 부여·회수 |
| 상품 연결 | 파트너 어드민에 전자책 등록 + 연동코드 입력 (또는 상품 목록 파일 전달) | 연동코드로 상품을 매칭 |
| 테스트 | 테스트 계정과 URL 전달 | 실제 호출과 앱 화면으로 검증 |
한눈에 보기
회원의 로그인 방식에 따라 두 가지가 있습니다. 소셜 로그인(카카오·네이버·구글 등)을 함께 운영하면 로그인 페이지 방식입니다.
회원
쏠브 앱
제휴사
사이트·서버
쏠브
서버
1
회원이 제휴사 사이트에서 책을 삽니다. 여기까지는 지금과 같습니다.
- 회원 → 제휴사: 책 구매. 회원이 제휴사 사이트에서 책을 삽니다. 여기까지는 지금과 같습니다.
- 회원 → 제휴사: 로그인 화면 열기. 쏠브 앱에서 "제휴사 연동하기"를 누르면, 앱 안에 제휴사 로그인 화면이 열립니다.
- 회원 → 제휴사: 평소처럼 로그인. 회원은 아이디나 카카오·네이버·구글 등 평소 쓰던 방법으로 로그인합니다.
- 제휴사 → 쏠브: "100023번 회원 로그인했어요". 로그인이 끝나면 제휴사 서버가 쏠브에 회원 번호를 알려 줍니다. 쏠브는 돌아갈 주소를 답해 줍니다.
- 제휴사 → 회원: 받은 주소로 이동. 제휴사가 회원 화면을 그 주소로 보내면 연동이 끝납니다. 같은 화면 안에서 이동해야 합니다.
- 쏠브 → 제휴사: "이 회원 뭐 샀어요?". 쏠브가 제휴사에 이 회원이 지금 볼 수 있는 상품을 물어봅니다.
- 제휴사 → 쏠브: 상품코드 목록. 제휴사는 구매한 상품의 코드 목록으로 답합니다. 환불된 상품은 빼고 보냅니다.
- 쏠브 → 회원: 책장에 책 추가. 쏠브가 상품코드로 전자책을 찾아 회원의 책장에 넣습니다. 상품코드는 파트너 어드민에 미리 등록해 둡니다.
회원
쏠브 앱
제휴사
사이트·서버
쏠브
서버
1
회원이 제휴사 사이트에서 책을 삽니다. 여기까지는 지금과 같습니다.
- 회원 → 제휴사: 책 구매. 회원이 제휴사 사이트에서 책을 삽니다. 여기까지는 지금과 같습니다.
- 회원 → 쏠브: 아이디·비밀번호 입력. 쏠브 앱에서 "제휴사 연동하기"를 누르고 제휴사 아이디와 비밀번호를 입력합니다.
- 쏠브 → 제휴사: "이 아이디 맞나요?". 쏠브 서버가 제휴사에 아이디와 비밀번호가 맞는지 물어봅니다.
- 제휴사 → 쏠브: "100023번 회원이에요". 맞으면 제휴사가 회원 번호로 답합니다. 틀리면 "비밀번호 불일치"로 답합니다.
- 쏠브 → 제휴사: "이 회원 뭐 샀어요?". 쏠브가 제휴사에 이 회원이 지금 볼 수 있는 상품을 물어봅니다.
- 제휴사 → 쏠브: 상품코드 목록. 제휴사는 구매한 상품의 코드 목록으로 답합니다. 환불된 상품은 빼고 보냅니다.
- 쏠브 → 회원: 책장에 책 추가. 쏠브가 상품코드로 전자책을 찾아 회원의 책장에 넣습니다. 상품코드는 파트너 어드민에 미리 등록해 둡니다.