福鑫-OpenAPI v2
  1. 接入说明
福鑫-OpenAPI v2
  • 福鑫OpenApi v2版本介绍
  • 接入说明
    • 【公共模块】接入说明
    • 【实时换汇】接入说明
    • 【挂单换汇】接入说明
    • 【预约换汇】接入说明
    • 【webhook回调】接入说明
  • 接口文档
    • 登录
      • 获取token
    • 获取可履约日历
      • 预约换汇日历
      • 合约变更日历
    • 获取参考报价
      • 获取报价
      • 获取报价(bid\offer pingpong视角)
      • 获取合约变更报价
    • 创建换汇
      • 创建换汇合约
      • 创建挂单换汇订单
    • 查询合约
      • 分页查询换汇记录
      • 根据幂等单号查询换汇记录
      • 分页查询挂单记录
    • 修改合约
      • 取消挂单
      • 更改履约日期
      • 撤销
    • 履约
      • 手动发起履约
    • 账户
      • 账户余额查询
      • 实时换汇额度查询
      • 预约换汇额度查询
      • 查询银行卡接口
      • 账户出金
      • 出入金记录查询
    • 回调通知
      • 合约变更事件回调
      • 合约展期事件回调
  1. 接入说明

【webhook回调】接入说明

1 webhook回调介绍#

在您使用福鑫的过程中产生的事件(如合约创建、合约履约等事件),会以http回调的方式通知到您指定的地址。

2 开通步骤#

2.1 设置Webhook回调通知地址#

image.png

2.2 获取加密公钥#

image.png

2.3 福鑫配置开启回调#

2.4 回调数据验签、解密开发#

您需要开发回调消息验签、解密逻辑。
注:
1,验签功能可选;
2,如果您要验签,那么需要先做验签,再做解密(否则后进行验签可能会不通过);
3,建议您在接收到回调通知后,立刻响应福鑫,异步去处理业务逻辑,避免回调请求超时(超时时间5s);
4,福鑫在收到http返回200就认为本次回调已经成功;
5,web回调是不可靠的,可能会丢失(回调失败重试一定次数后不再重试),可能会重复;
6,回调请求方式POST;
7,接入方遇到不识别的事件请直接丢弃(福鑫会陆续新增其他的通知事件)。

3 回调通知接口#

【合约变更事件回调】
【合约展期事件回调】

4 请求时序#

image.png

5 参考代码#

验签参考代码:
解密参考代码:
上一页
【预约换汇】接入说明
下一页
获取token
Built with