🎁 Bravo6 · Lucky Box
앱 파트너 안내서 · Partner Guide

럭키박스 앱 파트너 안내서

앱에 럭키박스를 더해 새로운 수익을 — 소개 · 예상수익 · 정산 · 연동을 한 문서로
서비스 럭키박스 (랜덤쇼핑) 운영 주식회사 브라보식스 버전 v0.3 (초안) / 2026.07

1. 럭키박스란?

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

핵심은 B2B2C 구조입니다. 파트너는 자사 앱에 럭키박스를 ‘콘텐츠/수익 모듈’처럼 얹기만 하면 되고, 상품 소싱·결제·배송·CS는 모두 브라보식스가 처리합니다.

운영 중인 상품 (2026.07 기준)

총 상품배송 상품디지털 상품가격대
635개 511개 124개 1,000원 ~ 160만원대

상품은 내부적으로 20개 가격 등급으로 구성해 운영하며, 지속적으로 추가·교체됩니다.

이런 상품이 들어 있습니다 (예시)

가격대대표 상품 예시
100만원 이상허먼밀러 에어론 의자, 삼성 비스포크 냉장고, LG 스타일러, 맥북에어 M5, 로보락 로봇청소기 S9
수십만원대프리미엄 가전·디지털 기기, 백화점·마트 상품권
수만원대신세계·스타벅스·네이버페이 상품권, 도서 구독권 등
1천~1만원대편의점·카페 기프티콘, 생활용품 등
🎁 디지털 상품(기프티콘·상품권)은 즉시 발송, 실물은 택배로 배송됩니다. “최소 1,000원 보장 + 고가 상품 기대감”이 재구매를 만드는 핵심입니다.

당첨 확률 구간 (약식)

내부 20개 가격 등급을 가격대별로 묶은 약식 당첨 확률입니다. 어떤 박스든 판매가 1,000원 이상 상품 당첨을 보장하며, 확률은 상품 구성에 따라 조정될 수 있습니다.

구간가격대당첨 확률 (합계)
프리미엄 (최상위 등급)40,000원 ~ 160만원대약 0.86%
고가11,000 ~ 40,000원약 8.1%
중가5,000 ~ 11,000원약 10.5%
일반3,000 ~ 5,000원약 36.5%
실속2,000 ~ 3,000원약 24.5%
기본 (최소 보장)1,000 ~ 2,000원약 19.6%
개인정보 부담 없음 — 파트너는 비식별 UID만 전달합니다. 이름·주소 등 개인정보는 사용자가 실물 배송을 신청하는 시점에 럭키박스가 직접 수집·처리합니다.

2. 파트너 앱에 왜 좋은가

3. 지금 바로 체험 — 머니팡 실서비스 (라이브 레퍼런스)

럭키박스는 이미 자사 리워드앱 머니팡에서 라이브로 운영 중입니다. 아래 앱을 설치해 실제 동작하는 럭키박스를 직접 확인하실 수 있습니다.

📱 QR 스캔으로
즉시 다운로드
머니팡 — 럭키박스 실서비스 운영 앱
Google Play  play.google.com/store/apps/details?id=com.bravo6.cashpang
패키지명  com.bravo6.cashpang
운영사  주식회사 브라보식스
▶ Google Play 다운로드

3-1. 5초 체험 가이드 — 화면 흐름

앱 설치 후 럭키박스 실서비스 진입까지 단 1번의 탭으로 도달합니다. 파트너 앱에서도 동일한 사용자 경험을 그대로 제공할 수 있도록 설계되어 있습니다.

STEP 1
머니팡 앱 실행 — 메인 홈 상단 “공지팡 랜덤박스 개편 및 신규 ‘럭키박스’ 오픈” 배너 확인
STEP 2
하단 네비게이션 바의 “🎁 랜덤박스” 메뉴 탭 (홈 / 미션 / 복권 / 랜덤박스 / 마이 중 4번째)
STEP 3
럭키박스 실서비스 페이지로 즉시 이동 — 1,000원(VAT 별도) 결제 → 박스 오픈 → 실제 상품 당첨 흐름 그대로 체험
STEP 4
마일리지 결제 옵션도 동일 화면에서 확인 가능 (머니팡은 Option B로 운영 중)
★ 파트너가 럭키박스를 연동하면 사용자는 머니팡 “랜덤박스” 탭을 누른 것과 동일한 페이지로 진입합니다. 다른 점은 진입 트리거(파트너 앱 메뉴)와 정산 대상(파트너 매출)뿐입니다.

3-2. 대표님께 권해드리는 검증 순서

4. 정산 구조

정산은 럭키박스에서 발생한 매출을 기준으로 하며, 파트너 정산은 매출의 20%입니다.

총매출럭키박스에서 발생한 결제 매출 합계
파트너 정산액총매출 × 20%
정산 주기매월 15일, 전월 실적 기준 지정 계좌로 입금

5. 파트너 예상 수익 — DAU 기준

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

DAU시나리오ARPDAU월매출파트너 월수익 (20%)파트너 연수익
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억원
50,000명보수적30원/일4,500만원900만원1.1억원
기본50원/일7,500만원1,500만원1.8억원
공격적80원/일1.2억원2,400만원2.9억원
100,000명보수적30원/일9,000만원1,800만원2.2억원
기본50원/일1.5억원3,000만원3.6억원
공격적80원/일2.4억원4,800만원5.8억원

6. 파트너 예상 수익 — MAU 기준

리워드앱 업계 관행인 MAU 기준으로 재환산한 예상 수익입니다. 머니팡 실측 ARPMAU 435원을 적용합니다.

파트너 MAU월매출 (ARPMAU 435원)파트너 월수익 (20%)파트너 연수익
100,000명4,350만원870만원1.0억원
500,000명2.2억원4,350만원5.2억원
1,000,000명4.3억원8,700만원10.4억원
5,000,000명21.8억원4.35억원52.2억원
★ MAU 1명당 월 435원 신규 매출 → 그 중 87원이 파트너 수익. 배너/동영상 광고 eCPM 대비 약 3~5배 높은 단가입니다.

7. 정산은 전용 페이지에서 앱키로 확인

파트너는 전용 정산 페이지에 접속해 발급받은 앱키(appKey)를 입력하면 바로 로그인됩니다. 별도 아이디·비밀번호는 없습니다.

정산 페이지(정식)https://partner.bravo6.co.kr/
정산 페이지(테스트)https://lbpart-git-test-bravo6s-projects.vercel.app/
로그인앱키(appKey)만 입력 (아이디·비밀번호 없음)

▶ 정산 페이지 열기 (테스트)

샘플(테스트) 앱키

테스트 앱키ff7d1dfaa511ae62e214f7633ce57ea6

위 앱키는 화면 확인용 테스트 값입니다. 실제로는 파트너별로 발급된 고유 앱키를 사용합니다.

로그인 단계

STEP 1
정산 페이지 주소로 접속
STEP 2
발급받은 앱키(appKey)를 입력란에 붙여넣기 (앞뒤 공백 없이 전체)
STEP 3
로그인 → 우측 상단 “○○님 환영합니다” 표시, 자사 정산·통계 확인

8. 정산 통계 화면 보는 법

로그인하면 화면은 (1) 조회 월 선택, (2) 월간 수익발생내역, (3) 일별 정산 발생 내역 3개 영역으로 구성됩니다.

① 조회 월 선택

상단에서 조회 월을 고르고 [조회]를 누르면 해당 월 데이터가 표시됩니다. (‹ › 로 월 이동) ※ 통계 반영에 일정 시간 지연이 있을 수 있습니다.

② 월간 수익발생내역

선택한 정산월의 파트너 정산금 합계가 큰 숫자로 표시되고, 아래 4개 지표가 함께 나옵니다.

정산월 합계해당 월 파트너 정산금 총액 (예: 2026년 07월 · 30,000,000원)
일반결제건수주문건수 / 판매개수 (예: 120,000 / 150,000)
일반결제취소건수취소건수 / 취소개수 (예: 1,200 / 1,500)
일반결제수익해당 월 파트너 정산 수익 (예: 30,000,000원)
이용자수기간 내 이용자 수 (예: 30,000)

※ 예시는 DAU 10만 · 기본 시나리오(ARPDAU 50원/일) 가정 기준입니다.

③ 일별 정산 발생 내역

선택한 월의 날짜별 정산 내역이 표로 표시되고, 맨 아래 합계가 나옵니다. 우측 [판매/취소 내역] 버튼으로 상세도 볼 수 있습니다.

일자정산금일반결제건수
주문/판매
일반결제취소
취소/취소개수
일반결제수익이용자수
07.01 (화)980,000원3,600 / 4,90030 / 38980,000원1,020
07.15 (화)1,050,000원4,000 / 5,2500 / 01,050,000원1,180
07.30 (수)1,120,000원4,300 / 5,60040 / 441,120,000원1,240
… 그 외 일자 …
합계 (7월)30,000,000원30,000,000원

※ DAU 10만 · 기본 시나리오 가정의 예시이며, 일부 일자만 표시했습니다. 화면의 ‘일반결제수익’이 곧 지급되는 파트너 정산 수익입니다.

9. 앱 연동

럭키박스는 앱 특성에 맞게 3가지 연동 방식을 제공합니다. 가장 기본은 ①이며, 리워드·쇼핑 앱은 ②·③을 더해 결제 전환율과 리텐션을 함께 높일 수 있습니다.

연동 방식 (선택·조합)

방식설명참고 문서
① 기본 연동 (API)getsite API로 럭키박스에 진입해 현금(카드·가상계좌)으로 박스를 구매. 가장 기본이며 아래 절차대로 구현합니다.연동안내서
② 포인트 결제
(리워드 앱)
앱의 현금성 포인트로 럭키박스를 구매 결제. 포인트 조회·사용 API를 구현하면 사용자가 적립 포인트로 박스를 살 수 있습니다. (API 연동 앱만, 현금성 포인트만 가능)제휴포인트 연동 API 스펙
③ 랜덤쇼핑 + 캐시백럭키박스를 앱의 ‘랜덤쇼핑’ 카테고리로 노출하고, 구매 시 매체사 수익의 일정%를 사용자에게 포인트로 캐시백(구매취소 시 회수). PG·포인트 결제 모두 지원. (API 연동 앱만)캐시백 포스트백 구현 스펙
💰 ② 포인트 결제 정산 방식 — 포인트로 결제된 매출은 매체사 수수료(20%)를 제외한 금액을 브라보식스에 입금하며, 매체사의 현금(PG) 매출 정산과 시스템상 상계(넷팅) 처리됩니다. (현금성 포인트만 연동 가능하며, 포인트 결제분이 현금 결제분보다 많으면 정산금이 마이너스가 되어 역정산이 발생할 수 있습니다.)

②·③의 상세 API 규격은 아래 10장의 문서 링크를 참고하세요.

한눈에 보는 작동 방식 (4단계) — 기본 연동

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

정산이 발생하려면 파트너 앱에 럭키박스가 연동되어 있어야 합니다. 앱키·시크릿은 발급받아 전달되며, 파트너는 앱 백엔드에서 아래 API를 호출해 일회성 접속 주소(siteUrl)를 받아 브라우저로 열면 됩니다.

엔드포인트

테스트 서버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 )

예제 코드 (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)로 오픈. 부득이 웹뷰가 필요하면 KICC 웹뷰 연동 가이드 참고.

Android/iOS 클라이언트 예제, ret 코드 상세, 실서비스 전환 체크리스트 등 전체 연동 절차는 아래 연동안내서를 참고하세요. 연동 지원은 담당자에게 요청하시면 됩니다.

10. 관련 문서 · 디자인 가이드

문서내용
럭키박스 연동안내서기본(API) 연동 — getsite 접속주소 획득, 해시(HMAC-SHA256) 생성, ret 코드 등
제휴포인트 연동 API 스펙포인트 결제 연동 — 포인트 조회/사용 API, 정산(역정산) 규칙, IP 화이트리스트
캐시백 포스트백 구현 스펙캐시백 연동 — 구매/취소 포스트백(지급·회수), pbId 멱등성, 재시도 정책

디자인 가이드

배너·아이콘 등 디자인 소스를 미리보고 내려받을 수 있는 디자인 연동 매뉴얼이 제공됩니다. 배너는 8종, 크기 300×250 / 336×280 / 320×100 / 320×50 / 300×50 등을 지원하며, 쇼핑·리워드·금융 등 앱 유형별 배치 미리보기를 제공합니다. (접속 링크는 담당자 안내)

본 안내서의 예상수익 수치는 참고용 추정치이며, 실제 실적을 보장하지 않습니다.

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