错误处理

API 使用统一响应结构，包含 success、code、message 和 data。客户端应同时判断 HTTP 状态码与 success，并记录响应中的业务错误码、错误信息和本次请求的 X-Request-Id。

状态码	含义	建议
400	参数或业务校验失败	修正请求后再提交
401	认证失败	重新获取令牌后重试一次
404	资源不存在	核对资源 ID 和环境
500	服务端处理失败	先查询操作结果，再按退避策略有限重试

幂等与超时

对创建卡片、充值、提现和汇款等会改变资金或资源状态的操作，不要进行无上限重试。网络超时或收到 500 后，应先调用对应的查询接口确认结果。

异步结果

创建或更新请求成功，只代表平台已接受当前操作时，不应直接视为业务终态。卡片、交易、持卡人 KYC 和汇款状态应结合查询接口与 Webhooks 确认，并按事件或资源 ID 去重处理。