技术文档

接入前必读:三类合作模式

技术文档按合作类型拆分,先确认你的接入身份,再进入对应章节,避免在无关参数上消耗时间。

01

会员注册接入

面向需要将会员注册流程嵌入自有渠道的运营方。文档覆盖注册表单字段规范、短信验证码时序、账号安全策略与多端登录态同步机制。注册接口平均响应时间控制在 800ms 以内,失败重试策略与风控拦截码均已整理成表。

查看注册接口 →
02

现金代理商加盟

代理商加盟文档包含资质提交清单、分佣比例配置、结算周期说明与代理后台操作手册。重点章节为「分佣计算示例」与「对账差异排查」,帮助代理方在 30 分钟内完成首笔结算核对。

查看加盟文档 →
03

占股合作参数

面向参与占股合作的机构用户,文档说明股权份额映射规则、收益分配计算逻辑、季度结算报表字段与数据导出格式。所有参数以 JSON 模板给出,可直接用于内部系统对接。

查看参数配置 →

会员注册接口:四步完成对接

从申请密钥到联调上线,完整流程约需 2 个工作日。以下为关键步骤与对应文档章节。

STEP 01

申请 API 密钥

在代理后台「开发配置」页提交域名白名单与回调地址,系统自动生成 AppID 与 Secret。文档列出白名单通配规则与密钥轮换策略。

STEP 02

配置注册表单

按字段规范文档设置用户名、手机号、邀请码等必填项。文档给出前端校验正则表达式与错误码对照表,避免因格式问题触发风控。

STEP 03

联调测试环境

使用文档提供的测试账号池与模拟回调工具,覆盖注册成功、验证码过期、重复注册、风控拦截四类场景。测试环境数据每日重置。

STEP 04

上线与监控

切换生产环境后,按文档配置注册成功率、接口耗时与错误码分布监控。异常阈值与告警通知模板已内置,可直接启用。

现金代理加盟文档核心章节

加盟流程涉及资质、分佣与结算三个模块,文档按决策顺序编排,先看结论再看细节。

✓

资质提交清单

个人代理与机构代理所需材料分开列出,包括身份证明、银行账户信息与推广渠道说明。文档附材料模板与常见驳回原因。

%

分佣比例配置

按活跃会员数、月流水与推广渠道三个维度给出分佣阶梯表。文档以 6 组真实数据演示分佣计算过程,含四舍五入与税费处理规则。

¥

结算周期与对账

结算日为每月 5 日与 20 日,文档说明账单字段含义、对账差异排查路径与补发流程。代理后台支持导出 CSV 格式明细。

⚙

代理后台操作手册

从登录、查看数据面板到提交提现申请,共 24 个操作步骤配截图说明。新代理按手册操作一遍即可独立完成日常管理。

占股合作参数配置参考

以下为占股合作文档中常用的参数说明,完整字段与 JSON 模板见文档第四章。

股权份额映射

参数 equity_ratio 定义合作方占股比例,精度保留小数点后四位。文档说明份额变更的生效时间与历史版本回溯方式。

收益分配计算

参数 revenue_pool 与 payout_rule 控制收益池构成与分配顺序。文档以季度为周期演示计算过程,并标注税费扣除节点。

结算报表字段

季度结算报表包含 16 个字段,文档逐一解释字段来源与统计口径。支持按合作方、月份与项目维度导出。

API 接口速查

常用接口的请求方式、鉴权要求与限流规则汇总。完整参数说明与响应示例见各接口独立文档页。

POST /v1/member/register
会员注册接口限流:60 次/分钟 · 鉴权:AppID + 签名
GET /v1/agent/settlement
代理结算查询限流:30 次/分钟 · 鉴权:代理 Token
POST /v1/equity/payout
占股收益分配限流:10 次/分钟 · 鉴权:机构密钥

文档使用常见问题

新接入方最常遇到的几个问题,答案均可在对应文档章节中找到详细说明。

注册接口返回风控拦截码 4031 如何处理?

4031 表示手机号在 24 小时内触发验证码请求上限。文档「错误码对照表」章节列出完整处理建议,包括等待时长与人工申诉通道。

代理结算账单中的「调整项」指什么?

调整项包含退款、风控扣回与活动补贴三类。文档「账单字段说明」章节给出每类调整项的触发条件与计算方式。

占股合作参数修改后多久生效?

参数修改在下一个结算周期开始时生效,文档「参数生效规则」章节说明生效时间线,并提供历史版本对比工具。

移动端 App 下载的技术要求有哪些?

文档「移动端适配」章节列出 iOS 与 Android 的最低系统版本、下载包签名校验方式与更新推送策略。

技术文档更新与公告

文档随平台版本滚动更新,每周三推送小版本修订,赛季节点发布大版本。以下为最新文档条目。