텔레그램 스타·프리미엄용 Fragment API — 수수료 5%

가격: Fragment 가격 + 5%

USD 잔액으로 결제하는 모든 API 주문은 현재 Fragment 가격에 5%를 더하고 센트 단위로 올림한 금액입니다. 숨은 수수료는 없습니다.

• POST /api/v1/usd/quote — 정확한 가격을 미리 확인, 응답에 "markup_percent": 5 포함
• 그 금액을 max_usd로 보내면 가격이 오를 때 차감 없이 409 price_changed가 반환됩니다
• 가격은 주문 시점에 확정됩니다

예시: Fragment에서 100 스타가 $1.50이면 $1.575 → 올림하여 $1.58을 결제합니다.

Fragment를 직접 연동하지 않는 이유

• TON 지갑이나 Toncoin 구매가 필요 없음 — USDT만 충전
• Fragment 페이지 스크래핑이나 세션 갱신 없음 — 안정적인 HTTPS API
• 수신자 사전 확인: /check-username이 180초 유효 verification_token 발급
• Idempotency-Key로 재시도해도 이중 결제 없음
• 완료된 주문마다 공개 원장에 TxId 기록

4단계 연동

1. 대시보드에서 API 키를 만듭니다 (X-API-Key 헤더).
2. TON 또는 BEP20 USDT로 USD 잔액을 충전합니다 (1 USDT부터).
3. /check-username → /usd/quote → /stars/buy 또는 /premium/buy (currency: "USD", max_usd).
4. GET /order/{id}로 상태를 확인합니다.

이런 분께 맞습니다

텔레그램 봇·미니앱 개발자, 온라인 쇼핑몰, 자체 고객에게 스타와 프리미엄을 판매하는 리셀러. 요청 한도는 키당 초당 3회입니다.