调用 4 次 API
轻松完成流量奖励
生成优惠券码，展示给用户，用户使用即可。eSIM 生成、激活指南和充值均由 TripTok 处理。
- 1
生成优惠券码
确定作为奖励的 eSIM 商品与数量，通过 API 生成优惠券码。费用将按 TripTok 售价预先从积分中扣除。
- 2
向用户提供券码
通过应用界面、推送、短信、邮件等任意渠道展示优惠券码。用户无需注册 TripTok 即可使用。
- 3
用户申请使用
用户点击“立即使用”时，再次调用一次 API。可获取新 eSIM 激活链接，或直接为正在使用的 eSIM 充值相应流量。
- 4
用户自行激活
用户在出行前打开链接，亲自进行安装和激活。未使用的优惠券可退款并退回为积分。
推荐使用场景
比现金或积分更令人印象深刻，比礼品券更易于运营。
游戏与应用活动奖励
将旅游流量作为升级、签到或排行榜的奖励。还可以打造将游戏道具兑换为流量的兑换所。
会员与积分兑换
将累积的积分兑换为日本 1GB、美国 3GB 等流量优惠券。兑换数量与成本均可提前设定。
购物赠品与评价奖励
为购买机票、住宿或旅行用品的用户附赠当地流量。也非常适合用作撰写评价的奖励。
广告、问卷与邀请奖励
观看广告、参与问卷或邀请好友即可发放流量优惠券。每个券码的使用状态均可通过 API 查询确认。
深受运营者青睐的理由
成本预先锁定
生成优惠券时，将按 TripTok 售价从积分中扣除。即便之后价格发生变动，已生成的优惠券金额依然保持不变。
未用即退
用户未使用的优惠券即使过期，只需调用一次退款 API 即可恢复积分，完全没有库存损失。
无库存与配送负担
无实物商品，零库存与物流压力，eSIM安装与激活指引由TripTok以客户语言提供。
充值续享，提升复访
使用同一张优惠券即可为客户正在使用的eSIM追加流量。旅途中也能创造再次发放奖励的理由。
覆盖190+国家与地区，随心自选
可从TripTok目录中挑选日本、美国、欧洲、东南亚等地的奖励商品。国家/地区、流量及有效期均由运营方自定。
全程可追溯
每张优惠券均关联发放、使用、充值、退款状态及客户标识符，对账与客服核对更轻松。
仅需对接4个REST接口
可直接沿用现有的合作伙伴API密钥与积分。详细文档与Swagger将在合作伙伴审核通过后提供。
- 创建优惠券
POST /prepaid-data-coupons传入商品与数量即可生成优惠券号并扣除积分。同一请求ID不会被重复扣费。
- 兑换新eSIM
POST /prepaid-data-coupons/{code}/redeem传入优惠券号即可生成eSIM并返回客户激活链接。激活由客户在链接中自行操作。
- 为现有eSIM充值
POST /prepaid-data-coupons/{code}/topup传入优惠券号与ICCID，即可直接为同一运营商、同一国家/地区的eSIM充值对应流量。
- 未核销退款
POST /prepaid-data-coupons/{code}/refund作废未使用的优惠券，并将扣除的金额全额退回为积分。
# 1) issue a coupon (credit is charged now)
POST /api/v1/partner/prepaid-data-coupons
{ "requestId": "reward-000123", "packageId": "JP_1_7", "externalUserId": "user-98765" }
→ { "coupons": [ { "code": "VK7M2QXR9TAB", "priceUSD": 4.5 } ] }
# 2a) customer taps "use" → new eSIM + activation link
POST /api/v1/partner/prepaid-data-coupons/VK7M2QXR9TAB/redeem
{ "endCustomer": { "email": "user@example.com" } }
→ { "activationUrl": "https://ttok.im/Ab12", "order": { ... } }
# 2b) or top up the eSIM the customer already uses
POST /api/v1/partner/prepaid-data-coupons/VQ2N7XK4PRM9/topup
{ "iccid": "8901234567890123456" }
→ { "topup": { "dataMB": 1024, "validityDays": 7 } }请求/响应字段、错误码及幂等性规则，请参阅合作伙伴审核后发放的指南与Swagger。
计费流程说明
- 1充值积分（通过合作伙伴控制台或业务负责人）
- 2创建优惠券时，扣除对应金额（商品售价 × 数量）
- 3客户使用时无任何额外费用——无论是开通新eSIM还是充值
- 4退款未使用的优惠券，扣除金额将全数返还
常见问题
不需要。优惠券核销由合作伙伴服务器通过API处理，客户只需打开收到的激活链接即可。您也可以通过Kakao通知 talk、短信或邮件发送同一链接。