易支付
首页 › 易支付使用指南 › 易支付接口报错怎么排查

易支付接口报错怎么排查

排查接口问题时,先记录请求时间、商户订单号、接口名称和返回的错误信息;不要在公开渠道贴出私钥、完整签名凭证或用户敏感数据。

签名失败

检查参与签名的非空字段是否齐全;确认已剔除 sign和 sign_type,参数按 ASCII 升序,连接格式为 key=value&...。

检查使用的是商户私钥签名、平台公钥验签,并确认算法为 SHA256WithRSA。可对照 RSA 签名指南。

参数错误或下单失败

逐项对照对应接口的必填项、类型、金额格式和时间戳要求;确认使用的是当前 V2 接口地址。阅读返回的 msg定位具体字段,再对照 统一下单参数表。

通知没有到达或没有更新状态

确认 notify_url是商户服务器端处理地址,而 return_url是用户页面跳转地址;二者不要混用。检查通知处理日志、验签结果以及业务代码是否返回文档要求的 success。

页面显示成功但系统订单未支付

不要仅根据浏览器跳回页面或前端提示记账。使用 订单查询核对状态;文档中的“已支付”状态值为 1。

排查时的安全做法

保存必要的错误摘要和订单号,遮盖密钥、签名和个人信息。若仍无法定位,带上接口名、时间和脱敏后的错误信息联系平台支持。

说明:账户权限、开通方式与实际支付能力以商户账户和平台最新文档为准。请勿在网页前端或公开代码中保存商户私钥。

相关文档