🎁 Bravo6 · Lucky Box
통합 파트너 안내서 · 연동형(API) + 배너형

럭키박스 통합 파트너 안내서

앱에 럭키박스를 더해 새로운 수익을 — 두 가지 연동 방식을 한 문서에서 비교·선택
서비스 럭키박스 (랜덤쇼핑) 운영 주식회사 브라보식스 연동 API 연동형 / 배너형 버전 v0.1 / 2026.07

1. 럭키박스란?

럭키박스는 1,000원(VAT 별도)에 랜덤박스 1개를 구매하면, 최소 1,000원부터 최고 100만원 이상(현재 최고가 160만원대)의 상품이 확률로 당첨되는 ‘랜덤쇼핑’ 서비스입니다. 어떤 박스든 판매가 1,000원 이상 상품 당첨을 보장하므로 사용자는 손해 없이 ‘한 번 더’ 하게 됩니다. 주식회사 브라보식스가 직접 개발·운영하며, 상품 소싱·결제·배송·CS·청약철회는 모두 브라보식스가 전담합니다.

핵심은 B2B2C 구조입니다. 파트너는 자사 앱/웹에 럭키박스를 ‘콘텐츠/수익 모듈’처럼 얹기만 하면 되고, 운영은 브라보식스가 처리합니다. 파트너 정산은 매출의 20%, 매월 15일 전월 실적 기준으로 지급됩니다.

2. 두 가지 연동 방식 — 한눈에 비교

파트너 채널의 성격에 따라 ① API 연동형 또는 ② 배너형을 선택하거나, 둘을 함께 운영할 수 있습니다.

구분① API 연동형② 배너형
대상회원 시스템이 있는 앱 (리워드·쇼핑·금융 등)회원 시스템이 없는 앱·웹·쇼핑몰·링크
연동 작업백엔드에서 getsite API 호출 + 해시(HMAC-SHA256) 생성배너/링크 1개 삽입 (개발 불필요)
개발 기간평균 1~2일당일 (즉시)
사용자 식별파트너 UID 전달 (회원 단위 정산)파트너 코드(appCode) + 쿠키 세션 (비회원)
유입 귀속UID 기준 실시간클릭 후 30일 쿠키 귀속
회원 전환이미 회원이탈 시 카카오/네이버 로그인 유도
확장 기능포인트 결제·랜덤쇼핑 캐시백 추가 가능추후 API 연동형으로 확장 가능
정산율매출의 20%매출의 20%
현황개발 완료개발 완료
🧭 선택 가이드 — 로그인 사용자를 UID로 넘길 수 있으면 API 연동형, 회원 시스템이 없거나 빠르게 시작하고 싶으면 배너형을 권장합니다. 웹·앱을 함께 운영하는 파트너는 두 방식을 병행해도 됩니다.

3. 공통 — 파트너에게 왜 좋은가

4. 공통 — 지금 바로 체험 (라이브 레퍼런스)

럭키박스는 이미 자사 리워드앱 머니팡에서 라이브로 운영 중이며, 배너형 데모 링크도 제공됩니다.

API 연동형 실서비스머니팡 (Google Play) · com.bravo6.cashpang → 하단 “🎁 랜덤박스” 탭
배너형 데모 링크https://luckybox.bravo6.kr/?appCode=0bf7b059becf3da0d2d16a0d02a4aae7

▶ 머니팡 다운로드 (API 실서비스)   ▶ 배너형 화면 열어보기

5. 공통 — 정산 & 정산 페이지

정산은 럭키박스에서 발생한 매출을 기준으로 하며, 파트너 정산은 매출의 20%입니다. 파트너는 전용 정산 페이지에 앱키(appKey)만 입력하면 바로 로그인되어 실시간으로 매출·정산금을 확인할 수 있습니다. (아이디·비밀번호 없음)

파트너 정산액총매출 × 20%
정산 주기매월 15일, 전월 실적 기준 지정 계좌 입금
정산 페이지(정식)https://partner.bravo6.co.kr/
정산 페이지(테스트)https://lbpart-git-test-bravo6s-projects.vercel.app/
PART A · 회원 시스템이 있는 앱
① API 연동형
getsite API로 접속 주소를 발급받아 브라우저로 여는 방식 — 백엔드 개발 필요

A-1. 작동 방식 (4단계)

01
파트너 백엔드 → 럭키박스 서버로 사용자 접속정보 요청 (UID만 전달)
02
럭키박스 서버가 검증 후 일회성 접속 주소(2분 유효)를 발급
03
파트너 백엔드 → 앱으로 접속 주소 전달
04
앱이 해당 주소를 브라우저로 오픈 → 사용자가 럭키박스 이용

앱키·시크릿은 발급받아 전달되며, 파트너는 앱 백엔드에서 아래 API를 호출해 일회성 접속 주소(siteUrl)를 받아 브라우저로 열면 됩니다.

A-2. 엔드포인트 · 파라미터

테스트 서버https://tboxapi.bravo6.kr:42011/rbox/getsite
실서비스https://boxapi.bravo6.kr/rbox/getsite
요청 / 형식POST · application/x-www-form-urlencoded; charset=UTF-8 · 응답 JSON
파라미터설명
appKey발급받은 앱키
userId파트너 이용자 식별자(UID)
userName(선택) 이용자 별명, 생략 시 임의 생성
requesttimeYYYYMMDDhhmmss (UTC 기준 요청 시각)
hashHMAC-SHA256( appSecret, appKey + userId + requesttime ) hex
응답 필드설명
ret결과 코드 (0 = 성공, 그 외 오류/점검)
siteUrl성공 시 발급되는 접속 주소. 2분간만 유효하며 1회용
hash = HMAC-SHA256( appSecret , appKey + userId + requesttime )

A-3. 예제 코드 (Node.js)

const Crypto = require('crypto');
const appKey    = '발급받은_앱키';
const appSecret = '발급받은_앱시크릿';
const userId    = '접속할_이용자_UID';
const now = new Date();
const requesttime = now.getUTCFullYear().toString()
  + String(now.getUTCMonth()+1).padStart(2,'0')
  + String(now.getUTCDate()).padStart(2,'0')
  + String(now.getUTCHours()).padStart(2,'0')
  + String(now.getUTCMinutes()).padStart(2,'0')
  + String(now.getUTCSeconds()).padStart(2,'0');
const hash = Crypto.createHmac('sha256', appSecret)
  .update(appKey + userId + requesttime, 'utf8').digest('hex');
// 위 5개 값을 POST(form-urlencoded)로 getsite에 전송
연동 주의
  • 백엔드 전용 — 인증·해시 생성은 반드시 백엔드에서. 시크릿을 앱/프론트에 넣지 마세요.
  • 주소 2분 유효 — siteUrl은 발급 후 2분·1회용. 접속 시마다 새로 발급.
  • 웹뷰 금지 — 외부 브라우저(Android Custom Tabs / iOS SFSafariViewController)로 오픈.

A-4. 확장 연동 (선택)

방식설명
포인트 결제 (리워드 앱)앱의 현금성 포인트로 럭키박스를 구매 결제. 포인트 결제분은 매체사 수수료(20%) 제외 후 브라보식스에 입금, 현금 매출과 상계(넷팅) 처리.
랜덤쇼핑 + 캐시백럭키박스를 앱의 ‘랜덤쇼핑’ 카테고리로 노출, 구매 시 매체사 수익 일정%를 사용자에게 포인트 캐시백(취소 시 회수).

A-5. API 연동형 예상 수익 — DAU 기준

가정: 유료박스 1,000원(VAT 제외), 월 30일, 파트너 지급 = 총매출 × 20%. 추정치이며 실제 실적을 보장하지 않습니다.

DAU시나리오ARPDAU월매출파트너 월수익파트너 연수익
10,000명보수적30원/일900만원180만원2,160만원
기본50원/일1,500만원300만원3,600만원
공격적80원/일2,400만원480만원5,760만원
30,000명보수적30원/일2,700만원540만원6,480만원
기본50원/일4,500만원900만원1.1억원
공격적80원/일7,200만원1,440만원1.7억원
100,000명보수적30원/일9,000만원1,800만원2.2억원
기본50원/일1.5억원3,000만원3.6억원
공격적80원/일2.4억원4,800만원5.8억원

MAU 기준(ARPMAU 435원)으로는 MAU 100만 → 월매출 4.35억, 파트너 월수익 8,700만원 수준입니다.

PART B · 회원 시스템이 없는 앱·웹·링크
② 배너형
배너/링크 1개만 삽입 — 개발·서버·회원가입 없이 즉시 시작

B-1. 작동 방식 (4단계)

01
파트너가 배너/링크에 발급받은 연동 링크(appCode 포함)를 삽입해 게시
02
사용자가 클릭 → luckybox.bravo6.kr 진입, 쿠키에 파트너 코드가 30일간 귀속
03
비회원 상태로 무료·유료박스 이용 → 구매 발생 (이탈 시 카카오/네이버 로그인 전환)
04
배송·CS는 브라보식스가 전담, 매출은 파트너 코드로 자동 집계·정산

B-2. 연동 방법 — 3단계, 개발 불필요

STEP 1
담당자(또는 에이전시)로부터 앱키(appCode)를 발급받습니다.
STEP 2
연동 링크 확인 → https://luckybox.bravo6.kr/?appCode={발급받은_앱키}
STEP 3
배너 이미지 또는 텍스트 링크에 위 주소를 연결해 게시합니다. 끝.
<!-- 럭키박스 배너: appCode를 발급받은 값으로 교체 -->
<a href="https://luckybox.bravo6.kr/?appCode=발급받은_앱키" target="_blank" rel="noopener">
  <img src="럭키박스_배너_300x250.png"
       alt="럭키박스 · 1,000원 랜덤박스">
</a>
✅ 이미지 없이 텍스트 버튼/배너 문구에 링크만 연결해도 즉시 작동합니다.

B-3. 배너 소재 · 유입 귀속

배너 크기형태추천 배치
300 × 250사각형 (레귤러)본문 중간, 사이드바, 상세 하단
336 × 280사각형 (라지)콘텐츠 사이, 리스트 상단
320 × 100가로 (라지 모바일)모바일 상·하단 띠배너
320 × 50가로 (모바일)모바일 하단 앵커
300 × 50가로 (스몰)인피드, 좁은 영역

디자인 연동 매뉴얼에서 총 8종 배너를 미리보고 내려받을 수 있습니다. (접속 링크는 담당자 안내)

유입 추적연동 링크의 appCode로 자동 추적 — 별도 태그·픽셀 불필요
귀속 기간클릭 후 30일 쿠키 귀속, 기간 내 구매는 파트너 매출로 인정
회원 전환비회원 쿠키 세션 → 이탈 시 카카오/네이버 로그인으로 회원 전환 유도

B-4. 배너형 예상 수익 — 월 유입(클릭) 기준

가정: 월 유입(클릭)수 × 방문당 매출(ARPV), 파트너 지급 = 총매출 × 20%. 추정치이며 실제 실적을 보장하지 않습니다.

월 유입수시나리오방문당 매출월매출파트너 월수익파트너 연수익
10,000보수적20원20만원4만원48만원
기본40원40만원8만원96만원
공격적70원70만원14만원168만원
100,000보수적20원200만원40만원480만원
기본40원400만원80만원960만원
공격적70원700만원140만원1,680만원
500,000보수적20원1,000만원200만원2,400만원
기본40원2,000만원400만원4,800만원
공격적70원3,500만원700만원8,400만원
💡 방문당 매출(ARPV)은 채널·타겟·배너 위치에 따라 달라집니다. 유입 데이터가 쌓이면 채널에 맞게 재산정해 드립니다.

6. 관련 문서 · 문의

문서내용
럭키박스 연동안내서API 연동형 상세 — getsite, 해시 생성, ret 코드
제휴포인트 연동 API 스펙포인트 결제 연동 — 조회/사용 API, 역정산 규칙
캐시백 포스트백 구현 스펙캐시백 연동 — 구매/취소 포스트백, 멱등성
디자인 연동 매뉴얼배너 8종 미리보기·다운로드 (담당자 안내)

앱키(appKey/appCode) 발급 및 연동 지원은 담당자에게 요청하시면 됩니다. 본 안내서의 예상수익 수치는 참고용 추정치이며, 실제 실적을 보장하지 않습니다.

검증된 운영 이력 — 럭키박스는 2024년 7월부터 자사 앱 내부 서비스로 시작해 약 2년간 안정적으로 운영 중이며, 2026년 6월부터 외부 앱/웹 연동 서비스를 제공하고 있습니다. 오랜 직접 운영으로 쌓은 상품 소싱·정산·CS 노하우를 그대로 파트너에게 제공합니다.