1. 前置必读
FLUXA91-API文档
  • 默认模块
    • 前置必读
      • 卡片安全展示(Secure Iframe)
      • 请求签名算法说明
      • Webhook 签名校验文档
      • 端点响应状态码
      • WebHook通知事件
    • 持卡人
      • 持卡人列表-分页查询
      • 创建持卡人
    • 卡片操作
      • 卡片月费
        • 卡片月费列表
        • 正常/异常扣费记录
      • 卡片敏感信息-Iframe版
      • 卡片列表(分页查询)
      • 获取卡产品列表
      • 实体卡绑定
      • 激活实体卡
      • 卡片激活码(回调异常情况下主动获取)
      • 卡片详情
      • 卡片充值
      • 卡片敏感信息(卡片三要素)
      • 设置卡片状态
      • 卡片刷新
      • 设置PIN
      • 卡卡转账
      • 虚拟卡创建
      • 卡Iframe-获取真实卡片 ID
      • 卡Iframe-签发 PAN Token
    • WebHook
      • 获取WebHook信息
      • 设置WebHook
      • 通知记录
    • 模拟测试
      • API请求头模拟
    • 商户信息
      • 商户可用余额
      • 商户账单
    • 全球付
      • 支持国家列表
      • 汇款通道
      • 获取汇款/创建受益人参数说明
      • 创建受益人
      • 受益人列表
      • 获取货币汇率
      • 更新受益人
      • 汇款
      • 汇款订单
  • 默认模块
    • 全球付
      • 支持国家列表
      • 汇款通道
      • 获取汇款/创建受益人参数说明
      • 创建受益人
      • 受益人列表
      • 获取货币汇率
      • 更新受益人
      • 汇款
      • 汇款订单
  1. 前置必读

端点响应状态码

本文档用于指导代理商如何对每一次 API 请求响应码进行判断。

1. 通用成功响应#

{
"code": 200,
"msg": "success",
"data": {}
}

2. 失败错误码#

响应码描述
AGENT_AUTH_40001缺少必要请求头
AGENT_AUTH_40002请求已过期(时间戳超过允许范围,5分钟内有效)
AGENT_AUTH_40003AccessKey 无效或已禁用
AGENT_AUTH_40004SecretKey 无效
AGENT_AUTH_40005请求重复提交(Nonce 重放)
AGENT_AUTH_40006IP 不在白名单中
AGENT_AUTH_40007签名无效
AGENT_SCOPE_40001权限未授权给AccessKey
AGENT_SCOPE_40002API 应用已被禁用
AGENT_PARAM_40001缺少必要参数
AGENT_PARAM_40002参数格式错误
AGENT_PARAM_40003JSON 格式解析失败
AGENT_RISK_42901请求频率过高:已超过 10 QPS 限制
AGENT_RISK_40301被风控系统拒绝访问(黑名单)
AGENT_BIZ_30001持卡人不存在
AGENT_BIZ_30002卡片不存在
AGENT_BIZ_30003卡片状态异常
AGENT_BIZ_30004卡片余额不足
AGENT_BIZ_30005卡片充值失败
AGENT_BIZ_30006汇款失败
AGENT_SYS_50001系统错误
AGENT_SYS_50002数据库异常
AGENT_SYS_50003第三方服务异常

9. 最佳实践#

始终使用 HTTPS
所有请求都用 JSON
随机 nonce 不可重复
服务端时间至少每日同步一次(NTP)
secret 不要放在前端或日志中
敏感信息请脱敏处理

修改于 2026-01-24 05:58:21
上一页
Webhook 签名校验文档
下一页
WebHook通知事件
Built with