# PitchBet 세일즈 원페이지 (Sales One-Pager)

**EN:** PitchBet is an Evolution-style B2B micro-market platform: league-separated products (MLB/NBA SKUs) + partner launch URL + seamless/transfer wallets + GGR prepaid/postpaid settlement. Season-stat skill tiers (no fake hash tiers). Staging uses LIVE=SIM; Asia leagues (KBO/NPB/KBL) stay empty until a licensed dump is loaded — we never invent athlete rows.

---

## 한 줄 요약

**풀 게임 클라이언트** + **파트너 런치 URL** + **Seamless / Transfer / Demo 월렛** + **GGR 선불·후불** — Evolution/Pragmatic 스타일 B2B 마이크로 마켓.

| 구성 | 설명 |
|------|------|
| 게임 클라이언트 | 로비 `/` → 리그별 `/play/mlb` · `/play/nba` (SKU `mlb_replay` / `nba_replay`) |
| 런치 | `POST /api/v1/partner/launch` → iframe/WebView용 `launchUrl` |
| 월렛 | `demo` (내부 크레딧) · `seamless` (파트너 balance/bet/win/rollback) · `transfer` (세션 잔액 in/out) |
| 정산 | 테넌트 GGR % · prepaid / postpaid · creditLimit |

## 스테이징 vs 미제공

| 항목 | 상태 |
|------|------|
| Staging URL | https://arena-soft.com |
| Admin / Partner | `/admin` · `/partner` |
| LIVE | **SIM** (실방송 피드 아님) |
| MLB / NBA 히스토리 | 스테이징 slim DB에 샘플·벌크 가능 |
| Asia (KBO/NPB/KBL) | **비어 있음** — 라이선스 덤프 전까지 fake 데이터 없음 |
| API 키 | **문서에 시크릿 없음** — Partner Settings 또는 Super `/admin/sandbox` 위자드에서 생성 후 **1회만** 평문 표시 |

## 파트너 런치 curl (3 모드)

키는 **직접 생성**하세요: Partner Settings → API Keys, 또는 Super Admin → Sandbox wizard.  
아래 `YOUR_API_KEY`를 교체. 호스트는 스테이징 기준.

```bash
# 1) demo
curl -s -X POST "https://arena-soft.com/api/v1/partner/launch" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{"userRef":"player-1","currency":"USDT","locale":"ko","walletMode":"demo","league":"MLB","gameCode":"mlb_replay"}'

# 2) seamless (파트너 walletBaseUrl 필요 — 없으면 demo로 폴백)
curl -s -X POST "https://arena-soft.com/api/v1/partner/launch" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{"userRef":"player-1","currency":"USDT","locale":"ko","walletMode":"seamless","returnUrl":"https://partner.example/lobby"}'

# 3) transfer
curl -s -X POST "https://arena-soft.com/api/v1/partner/launch" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{"userRef":"player-1","currency":"USDT","locale":"ko","walletMode":"transfer","transferAmount":100}'
```

응답의 `launchUrl`을 iframe/WebView에 넣습니다. 상세: [PARTNER-LAUNCH.md](./PARTNER-LAUNCH.md).

## 계약 체크리스트

- [ ] **GGR %** (`ggrSharePercent`) — 플랫폼 수수료
- [ ] **Billing mode** — `prepaid` | `postpaid`
- [ ] **creditLimit** (USDT) — 후불 노출 한도
- [ ] **Markets** — 허용 모드 목록
- [ ] **League SKU** — `league` / `gameCode` (`mlb_replay`, `nba_replay`, …)
- [ ] **walletMode** — demo / seamless / transfer (테넌트 기본값 + 런치 오버라이드)
- [ ] **Locales** — ko / en / zh / ja
- [ ] Webhook URL / HMAC (선택)
- [ ] Brand name · primaryColor

샌드박스 일괄 생성: Super Admin → [`/admin/sandbox`](https://arena-soft.com/admin/sandbox).

## 링크

- [PARTNER-LAUNCH.md](./PARTNER-LAUNCH.md) — 런치 · Seamless · Transfer
- [OPS-INCIDENT.md](./OPS-INCIDENT.md) — 장애 런북
- [OPS-POSTGRES.md](./OPS-POSTGRES.md) — Postgres 전환 (프로덕션 경로; 스테이징은 SQLite 유지 가능)
- Admin 매뉴얼: `/admin/manual` · Partner 매뉴얼: `/partner/manual`
- 이 문서 렌더: `/admin/sales` · `/sales` · `/docs/SALES-ONEPAGER.md`
