支持 Android、iOS、HarmonyOS，轻松集成离线支付推送，告别多平台收入统计烦恼！

一、独立开发者的真实痛点

你是否也在经历这些？

  • 应用同时上架了App Store、Google Play、华为应用市场，每个平台的后台都要单独登录才能看到收入；

  • 用户通过支付宝、微信、银行卡等多种渠道付款，订单散落在不同支付网关，对账痛苦；

  • 想分析不同渠道、不同套餐、不同活动带来的收益，却只能手动拉 Excel 硬算；

  • 特别想实时收到每笔订单的通知，第一时间了解收入动态，却一直没找到轻量级的解决方案。

「开发者收入助手」 正是为了解决这些问题而诞生。它提供Android、iOS、HarmonyOS三大移动平台客户端，配合离线支付消息推送 API，让你只需一次接入，就能把所有应用的收入数据统一汇总到手机上，随时随地查看，且支持实时推送。

📌 本文基于官方 API 文档，手把手教你如何接入这套“离线支付消息推送”接口，快速搭建属于自己的统一收入中台。

二、为什么推荐「开发者收入助手」？

1. 全平台覆盖

  • 客户端支持 安卓、苹果、鸿蒙，无论你用什么手机，都能随时随地看收入。

  • 服务端 API 不限语言，任何后端（Java、Python、PHP、Node.js、Go）都可轻松调用。

2. 真正“离线”推送

开发者只需要在自己业务后端（支付回调、服务端验单逻辑中）调用一个 HTTP 接口，把订单信息上报给「开发者收入助手」，APP 就会立刻收到实时推送通知，同时自动更新统计报表。即便 APP 当时没有打开，下次进入时也会同步所有订单。

3. 丰富的数据维度

API 支持传递：

  • 支付渠道（微信/支付宝/银行卡/Apple Pay/Google Pay……）

  • 货币类型（USD/CNY/EUR 等，可自定义）

  • 分成比例 & 手续费（自动计算净收入）

  • 订阅套餐 ID、活动 ID、标签 ID

  • 系统平台、系统版本、软件版本、设备型号、地区、用户账号……

这些字段将被 APP 自动归类、统计，形成多维度的图表和报表，帮你精准定位哪个渠道、哪个活动、哪个套餐最赚钱。

4. 完整的订单生命周期

除了支付成功，还支持：

  • 取消订单

  • 申请退款

  • 支付失败

上报后，APP 会自动调整收入统计，保证数据准确无误。

三、API 接入全流程（保姆级教程）

第一步：在 APP 中完成基础配置

  1. 下载「开发者收入助手」
    在各大应用商店搜索“开发者收入助手”

  2. 注册账号，登录后进入“我的”页面，获取：

    • my_account：你的账号（如手机号/邮箱）

    • token：API 秘钥（在“API”→“API 秘钥管理”中生成）

  3. 添加应用
    在“应用”页面，点击添加应用，填写应用名称、包名等，生成 appid。

  4. 配置套餐、活动、标签、货币（非必须，但建议配置）

    • 套餐：例如“月度订阅”“永久买断”，每个套餐会获得 subscription_plan_id。

    • 活动：如“新年大促”，获得 activity_id。

    • 标签：用于自定义分组，获得 tag_id。

    • 货币：在“我的”→“货币设置”中添加，例如 USD、CNY，获得 currency_id。

⚠️ 这些 ID 将作为 API 请求的参数，上报后 APP 会自动按它们归类统计。

第二步：选择适合你的接口风格

官方提供了三种接口，可根据项目习惯任选：

方式 URL Content-Type
POST 表单 http://www.xunchang888.com.cn/dev/api/v1/pay.php multipart/form-data
POST JSON http://www.xunchang888.com.cn/dev/api/v1/pay3.php application/json
GET http://www.xunchang888.com.cn/dev/api/v1/pay2.php 查询参数（需 URL 编码）

推荐使用 POST JSON 方式，结构清晰，不易出错。

第三步：构造请求参数

下表列出最核心的参数（完整列表见官方文档或文末附录）：

参数名 必填 说明
my_account 是 你的账号
token 是 API 秘钥
appid 是 应用 ID
order_id 可选 订单号（建议传入，便于后续对账）
merchant_id 可选 商户号
pay_channel 是 0=微信 1=支付宝 2=银行卡 3=信用卡 4=苹果支付 5=谷歌支付 6=华为支付 …
currency_id 是 货币 ID（需提前在 APP 中添加）
payment_amount 是 金额（数字）
commission 可选 分成比例，如 App Store 70% 分成则填 0.7，默认 1
fee 可选 手续费费率，如支付宝 0.6% 则填 0.006，默认 0
subscription_plan_id 是 套餐 ID（无套餐可传 1，但建议真实配置）
activity_id 是 活动 ID，不参与活动传 0
tag_id 是 标签 ID，不打标签传 0
channel_type 是 分发渠道 0=App Store 1=Google Play 2=华为市场 …
system_plaform 是 系统平台 0=iOS 1=Android 2=HarmonyOS …
system_version 可选 系统版本（如 18.2）
software_version 可选 APP 版本（如 1.0.0）
pay_status 是 0=支付成功 1=取消订单 2=申请退款 3=支付失败
reason 可选 失败/取消原因
model 可选 设备型号（如 iPhone15,2）
location 可选 地区（如 CN、US）
user_account 可选 用户登录的账号（可做用户维度的 LTV 分析）

📌 commission 和 fee 组合使用，APP 会自动计算：
净收入 = payment_amount × commission - payment_amount × fee
退款时也需正确传入 commission，退款金额 = payment_amount × commission。

第四步：发送请求 & 处理响应

🔹 Python 示例（POST JSON）
import requests
import json

url = "http://www.xunchang888.com.cn/dev/api/v1/pay3.php"

payload = {
    "my_account": "your_account@example.com",
    "token": "your_api_token",
    "appid": 1001,
    "order_id": "ORDER_20250321_001",
    "merchant_id": "M123456",
    "pay_channel": 0,          # 微信支付
    "currency_id": 1,          # 假设 1 = CNY
    "payment_amount": 98.00,
    "commission": 0.7,         # 7 成分成
    "fee": 0.006,              # 0.6% 手续费
    "subscription_plan_id": 5,
    "activity_id": 2,
    "tag_id": 0,
    "channel_type": 0,         # App Store
    "system_plaform": 0,       # iOS
    "system_version": "17.4",
    "software_version": "2.3.1",
    "pay_status": 0,           # 支付成功
    "model": "iPhone15,2",
    "location": "CN",
    "user_account": "user_188****8888"
}

headers = {"Content-Type": "application/json"}
resp = requests.post(url, data=json.dumps(payload), headers=headers)

print(resp.status_code)
print(resp.json())
🔹 成功响应示例
{
    "code": "80000000",
    "msg": "Success"
}
🔹 错误码说明
code 含义
0 发送失败，网络原因或无效数据
100 参数格式不正确
200 API 秘钥和你的账号不对应
300 API 今日可用调用次数已用完

如果返回非 80000000，请对照错误码调整请求。

第五步：在 APP 中查看实时收入

上报成功后，打开「开发者收入助手」APP：

  • 首页会立刻显示今日收入、累计收入、订单趋势图。

  • 订单列表会展示刚刚上报的订单，并附有支付渠道、套餐、活动等标签。

  • 若开启了推送通知，手机通知栏会直接弹出“您有一笔新订单 +金额”的提醒。

💡 即使同一秒内上报 100 笔订单，APP 也能逐个推送并汇总统计，毫无压力。

四、典型使用场景

场景1：服务端支付回调上报

绝大多数应用都有自己的后端，当用户在 APP 内完成购买（内购、支付宝/微信支付），你的服务器会收到支付网关的异步回调。在回调逻辑里，加上一段调用「开发者收入助手」API 的代码，即可自动同步订单。

场景2：历史订单补录

你可以写一个脚本，批量读取以往订单数据（例如从旧数据库、Excel 导出），调用上述 API 一次性导入，从此所有历史收入都在 APP 里统一呈现。

场景3：多渠道分发效果对比

通过 channel_type 字段标记不同市场（App Store、Google Play、华为、小米、官网等），APP 会自动生成“不同分发渠道的收入贡献”图表，帮你评估哪个渠道最值得投入。

五、进阶技巧与注意事项

  1. URL 编码：
    如果使用 GET 方式，所有非数字参数（如 reason、model、location）都需进行 URL 编码，避免特殊字符导致请求失败。

  2. 安全性：
    token 是最高机密，永远不要放在客户端代码中，只应在你的后端服务器中使用。

  3. 测试环境：
    可以先在上报时将 pay_status 设为 3（支付失败）来测试接口连通性，确认无误后再改为 0 上线。

  4. 退款处理：
    当用户发起退款时，请重新调用该 API，order_id 保持不变，并将 pay_status 设为 2（申请退款），APP 会自动从总收入中扣除对应金额。

六、写在最后

独立开发者或小团队最宝贵的就是时间。「开发者收入助手」+ 离线支付消息推送 API 让你花半小时接入，就能永久告别多后台切换、手动记账的苦日子。

  • 三大移动平台客户端全覆盖，随时随地看收入。

  • 丰富的统计维度（渠道、套餐、活动、标签、系统、地区……）。

  • 实时推送，每笔订单第一时间知道。

  • 完全免费使用（当前阶段无任何收费计划）。

# 个人开发 # c5交付 # android # ios # harmonyos
Logo
openEuler 社区

openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目，面向数字基础设施四大核心场景（服务器、云计算、边缘计算、嵌入式），全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构

更多推荐

cover

DLOS AI OS v2.0：面向大模型可控性、可验证性与可执行性的双环AI操作系统平台

avatar openEuler 社区
cover

Day07_Node.js 深度解析：从模块系统到文件操作全指南

avatar openEuler 社区
cover

DLOS AI OS MVP 1.0：面向大语言模型的闭环操作系统内核设计与实现

avatar openEuler 社区