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

【预约换汇】接入说明

1 创建预约换汇#

1.1 第一步 获取参考报价#

使用【获取token】接口得到的【access_token】放入请求头,并加入买卖货币参数和履约日参数,请求【获取报价】接口,得到参考报价【ref_price】。
注:
【履约日】参数可自行指定,也可请求【预约换汇日历】接口获取可履约日列表。若选择自行指定有可能为非交易日,福鑫会返回”不是交易日“的报错提示。

1.2 第二步 创建预约换汇合约#

使用【第一步】获取到的参考报价【ref_price】和【第一步】您使用的【履约日】参数,并加入其他参数,请求【创建换汇合约】接口,创建完成。

2 分页查询换汇记录#

使用【source_type_list = "lock"】请求【分页查询换汇记录】接口查询预约换汇记录。

3 单笔查询换汇记录#

使用幂等单号【target_c_order_id】请求【根据幂等单号查询换汇记录】接口查询换汇记录。

4 手动发起履约#

使用幂等单号【target_c_order_id】请求【手动发起履约】接口,通知福鑫进行履约。
注:
1,履约日当日才能手动发起履约;
2,在客户没有手动发起履约的情况下,福鑫系统会在履约日晚上23点自动发起履约。

履约说明#

手动发起履约
在履约日(且在23点之前)可以选择【手动发起履约】。手动发起履约时福鑫会判断您的余额是否充足,如果余额充足则发起履约,否则返回"余额不足",不进行履约操作。
自动发起履约
福鑫在履约日晚上23点会自动发起履约。此时如果您的账户余额不足无法履约,余额模式创建的合约会把预收的费用扣掉作为违约金,额度模式创建的合约会从您的余额账户扣除对应预收授信额度的金额。

5 更改履约日期#

使用原幂等单号【target_c_order_id】、新幂等单号【c_order_id】和新履约日参数,请求【更改履约日期】接口,通知福鑫进行更改。
注:
1,【新履约日】参数可自行指定,也可请求【合约变更日历】接口获取可变更的日期列表。若选择自行指定有可能为非交易日或超过3M的改期限制,福鑫会返回”不是交易日“的报错提示;
2,更改履约日期的参考价格可以通过【获取合约变更报价】接口获取,这个价格只能用来参考,不用来成交;
3,部分更改履约更多信息可以参考《福鑫OpenApi v2版本介绍》中“新的部分更改履约日期介绍”。

6 撤销#

使用幂等单号【target_c_order_id】请求【撤销】接口,通知福鑫进行撤销。
注:
在您进行撤销操作时,福鑫为了弥补和银行的换汇亏损,会扣除违约金。请谨慎操作!

7 请求时序#

image.png

8 合约状态#

reject("已拒绝") , waitSettle("待履约") , settle("已履约") ,revoke("已撤销")

9 服务时间#

5 X 24h(周一早晨6:00 - 周六早晨5:00)

10 可用履约日#

除您指定的买卖货币和美元的货币假期之外的工作日都是可用履约日(可通过请求【预约换汇日历】接口获取可履约日列表)
上一页
【挂单换汇】接入说明
下一页
【webhook回调】接入说明
Built with