接入文档
接口定义、字段说明、签名规则与错误码,按业务流程顺排,方便开发逐段对照。
查看接入开发从资料准备到应用创建,先把基础信息对齐。
需要提供营业执照、法人或经办人身份证明、企业对公账户信息,以及与业务类型相符的经营说明。资料由商务与合规同事分别核验,缺失项会一次性列出,减少来回补充的次数。
若主体名称近期发生变更,请在提交前同步更新证照与银行信息,否则会影响后续签约与结算。
查看资质与数据保护说明可以。同一主体下可按业务线、站点或环境分别创建应用,每个应用独立拥有密钥与回调地址,便于区分流量与权限边界。
应用数量与可用能力以合同和后台配置为准,新增前建议先与接入顾问确认是否需要单独开通结算配置。
查看应用创建流程建议先明确六项内容:收款场景、交易币种、是否需要分账、结算账户、退款规则与对账周期。这些信息决定接口参数和后台配置,提前确定能减少联调阶段的返工。
涉及特殊行业的,还需要补充对应资质材料,具体清单可与顾问逐项核对。
签名、回调与状态流转,是联调阶段最常见的三类问题。
沙箱使用独立的模拟数据,不产生真实资金流转,用于验证下单、回调、退款和分账等流程。生产环境使用真实商户号与密钥,所有请求都会计入正式订单。
两者的密钥与回调地址互不通用,上线前请分别配置,避免把测试流量带到生产环境。
查看上线切换清单若订单状态已经更新但业务侧始终没有收到通知,可主动调用订单查询接口做状态补偿,再回到日志定位原因。
常见原因包括参与签名的字段拼接顺序不一致、空值字段参与或未参与拼接、编码方式不统一、密钥误用了另一环境的版本。
建议先用固定参数在本地复现签名结果,与文档示例逐项比对,确认无误后再排查传输过程中是否被代理或网关修改。
查看签名规则资金相关的规则以合同约定为准,这里说明常规处理路径。
分账规则应在下单时或按预设规则确定。交易完成后再修改,会涉及已分账资金的追平处理,需按文档中的分账调整接口操作,并保留调整原因。
建议业务侧先确认最终金额再发起分账,减少后续调整次数。
退款会根据分账模式按约定顺序回退。若接收方资金已经结算,需要通过后续交易或双方约定方式补齐。
发起退款前建议先查询分账明细,确认各接收方的可用余额;涉及的金额与时限以合同条款和实际结算状态为准。
把每日比对做成固定任务,差异更容易被发现。
对账文件按约定周期生成,生成后可在后台下载,也可通过文件接口自动拉取。文件内容包含订单号、交易金额、手续费、结算状态等字段。
建议在业务侧建立每日拉取与比对任务,发现差异及时提交工单并附上订单号。
常见状态包括待支付、已支付、部分退款、已退款、已关闭,状态变更以支付渠道返回结果为准。
报表展示的是当前快照,历史轨迹可结合订单详情查看。若同一订单在本系统与渠道侧状态不一致,以渠道查询结果为准,并联系技术支持核对。
查看报表字段说明密钥、数据与材料,是安全同事最关心的三件事。
把商户号、应用标识与请求时间一并说明,多数问题可以在第一轮沟通中定位到具体环节。
请在邮件中避免直接粘贴完整密钥、银行卡号或身份证号等敏感信息。