唯一操作编号
它关联玩家、金额、货币、支付方式、支付提供商及完整处理历史。
文档 / 支付流程
支付 API 如何运作
查看完整支付路径：从创建存款和确认支付，到资金入账、提现、退款及财务对账。
存款
创建与入账
出款
验证与发送
状态
操作确认
对账
财务控制
支付流程
从请求到最终结果
01
创建操作
记录玩家、金额、货币、支付方式及唯一操作编号。
02
确认支付
将玩家重定向至支付页面、请求银行确认或直接处理支付。
03
接收最终状态
检查支付提供商响应并确认操作最终结果。
04
更新余额与账务
资金仅入账或扣除一次，同时记录手续费并将操作纳入对账。
概览
每笔支付均按受控阶段处理
平台分配自己的操作编号，将其与支付提供商响应关联，并仅在结果确认后改变财务状态。重复请求不得产生第二次扣款或入账。
清晰状态
操作只能按允许的阶段流转，已完成结果不会在没有单独调整的情况下发生变化。
独立财务记账
支付状态、余额变化、手续费及会计记录相互关联，但分别进行检查。
存款流程
典型存款流程
存款从内部操作开始，在支付提供商确认后以一次性入账结束。
01
验证请求并创建操作
平台检查玩家、KYC、限额、货币、金额及支付方式，然后分配内部操作编号。
02
将支付发送给提供商
提供商接收金额、货币、玩家数据、返回 URL、通知 URL 及所需支付信息。
03
确认支付
玩家在外部页面、通过 3-D Secure 或银行应用确认支付。
04
接收确认并将资金入账
验证签名和最终状态后，平台仅增加一次玩家余额并完成操作。
提现与退款
提现、取消与退款
出款操作需要验证玩家、可用余额、风险、支付信息及支付提供商最终响应。
玩家验证
KYC、年龄、账户状态、限额、自我排除及允许的提现方式。
风险检查
AML、欺诈指标、投注要求、资金来源及运营商审批。
预留金额
在收到最终出款结果前，该金额在余额中保持冻结。
发送给支付提供商
创建独立出款请求，包含唯一编号及已验证收款人信息。
等待结果
平台接受中间状态，不会再次扣除金额。
退款
退款作为单独操作创建，与原支付关联并拥有自身金额。
取消
取消仅可在不可逆阶段之前进行，对于已完成操作不能用取消替代退款。
最终对账
提供商报表、出款数据、手续费及余额变化必须显示一致结果。
操作状态
推荐状态模型
内部状态将不同支付提供商响应标准化为平台统一清晰的模型。
已创建
操作已在平台内创建，但尚未发送给提供商或被其接受。
需要操作
玩家需要确认支付、输入信息或在银行端完成操作。
处理中
提供商已接受操作，但最终结果尚未确认。
已完成
操作成功完成，此后余额仅变更一次。
已拒绝
操作以拒绝结束，保留原因，并且不再进行额外扣款或入账。
未确认
由于连接故障、响应延迟或数据冲突，操作结果未知。
未知结果不能视为拒绝
即使没有及时响应，支付也可能已被提供商接受。应先查询当前状态或等待确认，再决定是否需要创建其他操作。
可靠性与对账
防重复与财务对账
支付 API 的可靠性取决于能否安全处理重复请求、延迟确认及部分故障。
防止重复操作
每笔存款、提现和退款均获得唯一编号。
重复请求返回现有结果，不创建新的金融操作。
重复通知会根据事件编号及当前支付状态进行检查。
余额变动与支付编号绑定，仅应用一次。
财务记账与对账
分别保存金额、手续费、净额、货币及提供商引用。
不要追溯修改已完成记录，应创建单独调整。
对账 API 操作、提供商报表、余额变动及出款记录。
记录每项差异、原因、负责人及解决结果。
测试
上线前需要测试的内容
测试成功支付、拒绝、连接中断、重复确认、未知结果、退款及财务对账。
成功存款与提现
验证所有中间状态、确认、余额变动及最终报表。
操作拒绝
资金不足、信息无效、超出限额、银行拒绝、风险审核及支付方式不可用。
连接中断
请求发送后连接中断，确认稍后到达或需要单独查询。
重复请求
同一操作或确认在处理完成后再次到达。
退款与取消
全额和部分退款、处理前取消，以及禁止取消已完成操作。
对账
所有场景执行后，金额、手续费、最终状态、余额及提供商报表必须一致。
上线前检查清单
在验证状态、确认、防重复、余额及财务报表后，才启用生产支付。
测试与生产环境使用不同凭据、通知端点及账户。
用户返回网站不能作为支付成功的证明。
改变余额前必须验证签名和事件编号。
存款、提现及退款均受到防重复执行保护。
未知状态需向提供商确认，并在对账时检查。
已配置错误告警、PSP 报表及差异调查流程。