Skip to main content

响应码

Waffo API 响应格式:
  • code"0" 表示成功
  • 失败时,code 为错误码字符串(例如 "A0003""E0001"
  • 响应字段名为 msg(不是 message

错误码分类

完整错误码列表请参阅 错误码速查

E0001 Unknown Status 处理

这是最关键的异常场景。 当你遇到网络超时、连接中断,或服务端返回 E0001 时,支付状态未知。

原则

  • 不要假设失败:网络超时不代表支付没有成功
  • 不要自动关闭订单:支付可能已在 Channel 侧完成
  • 不要创建新订单:使用原始 paymentRequestId 进行查询

SDK 中的错误类型

SDK 只有两类错误。WaffoUnknownStatusError/Exception 表示支付可能已成功,而 WaffoError/Exception 表示客户端侧错误(配置、签名等)。

SDK 错误码

处理流程

代码示例