FreeByte 手机号钱包、流量包与代币目录

1GB APP COMPANY DMCC · 电信 4.3 ★

FreeByte 是 1GB APP COMPANY DMCC 推出的 Kazan Kazan 手机奖励应用。用户使用手机号和短信验证码登录，完成任务、签到、参与转盘活动或邀请好友，即可积累奖励，兑换手机流量包和购物券。应用还提供代币包、合作伙伴网站入口及按手机号转账功能。其兑换目录既有 Turkcell 专属流量包，也有品牌购物券，与 Kim GB İster / Kazan Kazan 的土耳其品牌定位相呼应。FreeByte 在 Google Play 的评分为 4.32 分，共有 224,094 条评价。

GB 流量奖励余额与转盘代币分别记录：amount 表示钱包内的流量余额，tokenBalance 记录代币数量，pointLimit 和 dataLimit 则说明剩余兑换额度。商品目录将 productId、value 和 price 与运营商资格标记 onlyTurkcell 关联。电信运营团队可在规划流量包兑换时，将这些商品属性与剩余额度进行比对。

兑换结果包含 purchaseId、transactionId、state、deliverable 和 code；钱包流水则补充 partner、reason、created、value 和 type。这些记录可共同支持购物券合作伙伴结算与奖励账本对账。手机号收款目标通过 toMsisdn 标识用户间转账，通过 msisdn 标识慈善收款方。openData Studio 将这些奖励、商品目录与交易记录转为可调用的开放数据，供获授权的系统集成使用。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

发送 MSISDN 登录验证码
POST /v1/subscriber-access/challenges osint
向用户的 msisdn 发送登录用一次性验证码，并返回 code 和 timerValue；后者表示可再次发送验证码前的倒计时。
认证方式：无需认证。提供用户的 msisdn 以请求短信验证码。
- msisdn
- code
- timerValue
```
POST /v1/subscriber-access/challenges HTTP/1.1
Accept: application/json
Content-Type: application/json

{
  "msisdn": "<subscriber-msisdn>"
}
```
```
{
  "code": "OK",
  "timerValue": 120
}
```
检查 MSISDN 账户状态
POST /v1/subscriber-access/eligibility osint
在验证码登录前检查用户是否为已有账户（existingUser），以及是否已在 etkAccepted 中记录电子通信授权。
认证方式：无需认证。在验证码登录前提供用户的 msisdn。
- msisdn
- etkAccepted
- existingUser
```
POST /v1/subscriber-access/eligibility HTTP/1.1
Accept: application/json
Content-Type: application/json

{
  "msisdn": "<subscriber-msisdn>"
}
```
```
{
  "etkAccepted": true,
  "existingUser": true
}
```
用验证码换取会话令牌
POST /v1/subscriber-access/sessions osint
完成用户验证码登录，返回会话令牌 token 和 code，用于后续需要 Bearer 认证的请求。
认证方式：无需认证。提供 msisdn、otp 和 osType。返回的 token 用于后续认证请求的 Authorization: Bearer <session-token> 请求头。
- msisdn
- otp
- osType
- token
- code
```
POST /v1/subscriber-access/sessions HTTP/1.1
Accept: application/json
Content-Type: application/json

{
  "msisdn": "<subscriber-msisdn>",
  "otp": "<sms-code>",
  "osType": "ANDROID"
}
```
```
{
  "token": "<session-token>",
  "code": "OK"
}
```
读取 GB 流量钱包余额
GET /v1/rewards-wallet/data-balance openbanking
读取 amount，即已登录用户在首页看到的 GB 流量钱包余额。
认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。
- amount
```
GET /v1/rewards-wallet/data-balance HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json
```
```
{
  "amount": 3500
}
```
读取代币余额
GET /v1/rewards-wallet/token-balance openbanking
读取 tokenBalance，即购买或赚取、可用于转盘和代币商品目录的代币数量。
认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。
- tokenBalance
```
GET /v1/rewards-wallet/token-balance HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json
```
```
{
  "tokenBalance": 12
}
```
读取积分与流量兑换额度
GET /v1/rewards-wallet/redemption-caps openbanking
返回已登录用户的 pointLimit 和 dataLimit，分别表示剩余积分兑换额度与手机流量兑换额度。
认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。
- pointLimit
- dataLimit
```
GET /v1/rewards-wallet/redemption-caps HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json
```
```
{
  "pointLimit": 5000,
  "dataLimit": 10240
}
```
列出钱包交易流水
GET /v1/rewards-wallet/ledger-entries openbanking
列出钱包流水，通过 partner、reason、created、value、type 和 date 记录 GB 流量或积分的收入与支出。
认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。
- partner
- reason
- created
- value
- type
- date
```
GET /v1/rewards-wallet/ledger-entries HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json
```
```
[
  {
    "partner": "FreeByte",
    "reason": "TASK_REWARD",
    "created": "2026-10-21T09:14:03Z",
    "value": "250",
    "type": "CREDIT",
    "date": "2026-10-21"
  }
]
```

列出商城流量包与购物券

GET /v1/reward-market/offerings opendata

列出商城中的流量包和购物券，包括 productId、以钱包单位计价的 price、onlyTurkcell 兑换资格，以及 deliverable、code 和 type 等兑换信息。

认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。

id
productId
name
value
price
onlyTurkcell
promoted
pinned
filterable
internal
deliverable
code
type
title
header
desc
buttonText
buttonUrl
deeplink
badge
image
fake

GET /v1/reward-market/offerings HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json

[
  {
    "id": 101,
    "productId": 201,
    "name": "Example 1 GB pack",
    "value": "1024",
    "price": 1000,
    "onlyTurkcell": true,
    "promoted": true,
    "pinned": false,
    "filterable": true,
    "internal": true,
    "deliverable": null,
    "code": null,
    "type": "DATA",
    "title": "1 GB internet",
    "header": "Turkcell",
    "desc": "Illustrative prepaid data pack",
    "buttonText": "Redeem",
    "buttonUrl": null,
    "deeplink": null,
    "badge": null,
    "image": "<catalog-image>",
    "fake": false
  }
]

兑换目录商品

POST /v1/reward-market/redemption-orders openbanking

通过 pinOtp 确认后，使用钱包余额为 receiver 兑换 itemId 对应的商品，返回 purchaseId、transactionId、state、deliverable 和 code。

认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。提供 itemId、receiver 和 pinOtp。

itemId
receiver
pinOtp
purchaseId
transactionId
state
deliverable
code

POST /v1/reward-market/redemption-orders HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json
Content-Type: application/json

{
  "itemId": 201,
  "receiver": "<subscriber-msisdn>",
  "pinOtp": "<confirmation-code>"
}

{
  "purchaseId": "purchase-example-001",
  "transactionId": "transaction-example-001",
  "state": "DELIVERED",
  "deliverable": "<voucher-delivery-reference>",
  "code": "<voucher-code>"
}

按 MSISDN 转送钱包余额
POST /v1/rewards-wallet/peer-sends openbanking
通过 pinOtp 确认后，将 amount 指定数量的 GB 流量或积分转给 toMsisdn 标识的用户。
认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。提供 toMsisdn、amount 和 pinOtp。
- toMsisdn
- amount
- pinOtp
```
POST /v1/rewards-wallet/peer-sends HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json
Content-Type: application/json

{
  "toMsisdn": "<recipient-msisdn>",
  "amount": 500,
  "pinOtp": "<confirmation-code>"
}
```
```
{}
```
列出慈善收款手机号
GET /v1/reward-giving/recipients opendata
按 msisdn 和 name 列出慈善捐赠收款方，方便将钱包余额转给慈善机构而非其他用户。
认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。
- msisdn
- name
```
GET /v1/reward-giving/recipients HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json
```
```
[
  {
    "msisdn": "<charity-msisdn>",
    "name": "Example charity"
  }
]
```

列出合作伙伴网站

GET /v1/reward-market/partner-directory opendata

列出合作伙伴网站的 title、url、featured 和 enabled 标记，以及奖励信息流中使用的图片和故事素材字段。

认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。

id
title
description
details
image
buttonText
url
featured
internal
enabled
showTt
imageUrl
imageHeight
imageWidth
storyImageUrl
storyButtonName
storyOrder
storyOnly

GET /v1/reward-market/partner-directory HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json

[
  {
    "id": 42,
    "title": "Example partner shop",
    "description": "Earn on partner checkout",
    "details": "Open the partner site from the catalog",
    "image": "<partner-image>",
    "buttonText": "Visit",
    "url": "<partner-url>",
    "featured": true,
    "internal": false,
    "enabled": true,
    "showTt": false,
    "imageUrl": "<partner-image-url>",
    "imageHeight": 600,
    "imageWidth": 1000,
    "storyImageUrl": "<partner-story-image-url>",
    "storyButtonName": "Shop",
    "storyOrder": 1,
    "storyOnly": false
  }
]

列出可购买的代币包
GET /v1/reward-market/token-bundles opendata
列出 tokenProductList 中可购买的代币包，包括 googleProductId、tokenAmount、pointAmount、price 和 tokenProductType，并通过 tokenProductIdWithBadge 标识重点展示的商品。
认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。
- tokenProductList
- tokenProductIdWithBadge
- id
- googleProductId
- name
- tokenAmount
- imageUrl
- pointAmount
- price
- tokenProductType
```
GET /v1/reward-market/token-bundles HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json
```
```
{
  "tokenProductList": [
    {
      "id": 3,
      "googleProductId": "example_token_pack_50",
      "name": "50 tokens",
      "tokenAmount": 50,
      "imageUrl": "<token-bundle-image-url>",
      "pointAmount": 0,
      "price": 2999,
      "tokenProductType": "IAP"
    }
  ],
  "tokenProductIdWithBadge": 3
}
```

为代币创建 Stripe 支付意向

POST /v1/token-checkout/payment-drafts openfinance

为 tokenProductId 创建 Stripe 支付意向，返回支付状态、付款用户的 msisdn、amount、currency，以及结账所需的 clientSecret、publishableKey、ephemeralKey 和 customerId。

认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。提供 tokenProductId。

tokenProductId
msisdn
intentId
amount
currency
status
response
clientSecret
publishableKey
ephemeralKey
customerId

POST /v1/token-checkout/payment-drafts HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json
Content-Type: application/json

{
  "tokenProductId": 3
}

{
  "tokenProductId": 3,
  "msisdn": "<subscriber-msisdn>",
  "intentId": "<payment-intent-id>",
  "amount": 2999,
  "currency": "try",
  "status": "requires_payment_method",
  "response": "ok",
  "clientSecret": "<payment-client-secret>",
  "publishableKey": "<publishable-key>",
  "ephemeralKey": "<ephemeral-key>",
  "customerId": "<payment-customer-id>"
}

读取游戏化任务进度
GET /v1/reward-journey/mission-status opendata
通过 completedMission、totalMissionCount、missionActive、milestoneCategory 和 rewardGainedAmount 读取已登录用户的任务进度。
认证方式：使用 Authorization: Bearer <session-token> 认证；Accept: application/json。
- completedMission
- rewardGainedAmount
- milestoneCategory
- missionActive
- totalMissionCount
```
GET /v1/reward-journey/mission-status HTTP/1.1
Authorization: Bearer <session-token>
Accept: application/json
```
```
{
  "completedMission": 4,
  "rewardGainedAmount": 750,
  "milestoneCategory": 2,
  "missionActive": true,
  "totalMissionCount": 8
}
```

数据类别

余额
交易
身份信息
商品目录
支付
任务

数据使用场景与案例

预付费流量兑换额度核对
运营任务将 LimitResponse.dataLimit 和 pointLimit 与已兑换的 MarketProductsResponse 记录进行比对，结合 onlyTurkcell、productId 和 value，避免流量包兑换超出剩余额度。
奖励账本 ETL
财务机器人提取 HistoryItem 中的 partner、reason、created、value 和 type，并结合 BalanceResponse.amount 与 TokenBalance.tokenBalance，在应用之外重建 GB 流量和代币账本。
购物券合作伙伴结算
通过 pinOtp 确认兑换后，合作伙伴运营团队将 BuyResponse 中的 purchaseId、transactionId、state、deliverable 和 code 与 PartnerWebsiteItem.url 记录进行匹配，用于结算核对。
手机号点对点转账监测
风控团队监测 TransferRequest.toMsisdn、amount 和 pinOtp，并参照 CharitiesResponse.msisdn 中的慈善收款号码，区分用户间转账与捐赠。

常见问题

FreeByte 如何识别用户？

用户使用 MSISDN 手机号和短信一次性验证码登录。账户检查会返回 existingUser，以及表示电子通信授权状态的 etkAccepted。验证码确认成功后，系统返回会话令牌，用于后续的 Bearer 认证请求。

可查看哪些钱包余额与商品目录字段？

GB 流量钱包余额使用 amount，购买或赚取的代币使用 tokenBalance。pointLimit 和 dataLimit 分别表示剩余积分兑换额度与手机流量兑换额度。目录条目使用 onlyTurkcell 标明运营商专属兑换资格，并提供 productId、value、price 和 type。deliverable 与 code 描述兑换后的交付内容，使流量包和购物券能够在同一目录中呈现。

哪些字段可用于兑换与转账对账？

兑换请求传入 itemId、receiver 和 pinOtp，随后返回 purchaseId、transactionId、state、deliverable 和 code。用户间转账使用 toMsisdn、amount 和 pinOtp；钱包流水则包含 partner、reason、created、value 和 type。

页面展示的 API 路径是否为线上服务地址？

不是。这些路径以及请求、响应示例仅用于说明应用数据流的示意模型，并非生产服务地址。示例中的用户手机号、令牌和支付密钥均为占位值。

与 FreeByte 相似的应用

Google Opinion Rewards — Google Opinion Rewards 是 Google 的问卷应用，用户完成推送到手机上的短问卷后可获得 Google Play 积分。
KazandıRio — KazandıRio 是百事土耳其的奖励应用，用户输入百事、Doritos、Lay's 等相关品牌产品上的密码，可兑换含免费流量、游戏兑换码和购物券在内的礼品。
Daha Daha — Daha Daha 是可口可乐在土耳其的奖励应用，用户输入瓶盖上的代码即可领取流量包、餐饮优惠、游戏兑换码等奖励。
Hopi — Hopi 是 Boyner 集团的土耳其购物奖励应用，用户在线上和门店消费时可获得 Paracık 积分，以及服装、电子产品、出行和商超等品类的品牌优惠。
Freecash: Earn Money — Freecash 是一款有奖任务应用，用户通过玩游戏、填问卷和试用产品赚取奖励，再经银行转账、PayPal 或礼品卡提现。
Testerup: Test & Earn Rewards — Testerup 是一款奖励应用，会员玩游戏、完成优惠任务和填写问卷，再从应用内余额发起转账。
Bounty — Bounty 是土耳其问卷应用，用户完成简单问卷后，可以把已审核的收益提出。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

FreeByte 手机号钱包、流量包与代币目录

应用截图

API 端点一览

发送 MSISDN 登录验证码

检查 MSISDN 账户状态

用验证码换取会话令牌

读取 GB 流量钱包余额

读取代币余额

读取积分与流量兑换额度

列出钱包交易流水

列出商城流量包与购物券

兑换目录商品

按 MSISDN 转送钱包余额

列出慈善收款手机号

列出合作伙伴网站

列出可购买的代币包

为代币创建 Stripe 支付意向

读取游戏化任务进度

数据类别

数据使用场景与案例

预付费流量兑换额度核对

奖励账本 ETL

购物券合作伙伴结算

手机号点对点转账监测

常见问题

与 FreeByte 相似的应用

更多电信类应用

hambi (Beeline Uzbekistan)

Hathway Broadband

Minha Vero

Mitra

相关主题

需要集成这个 App 的数据 API？

FreeByte 手机号钱包、流量包与代币目录

应用截图

API 端点一览

发送 MSISDN 登录验证码

检查 MSISDN 账户状态

用验证码换取会话令牌

读取 GB 流量钱包余额

读取代币余额

读取积分与流量兑换额度

列出钱包交易流水

列出商城流量包与购物券

兑换目录商品

按 MSISDN 转送钱包余额

列出慈善收款手机号

列出合作伙伴网站

列出可购买的代币包

为代币创建 Stripe 支付意向

读取游戏化任务进度

数据类别

数据使用场景与案例

预付费流量兑换额度核对

奖励账本 ETL

购物券合作伙伴结算

手机号点对点转账监测

常见问题

相关应用

与 FreeByte 相似的应用

更多电信类应用

hambi (Beeline Uzbekistan)

Hathway Broadband

Minha Vero

Mitra

相关主题

需要集成这个 App 的数据 API？