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

【公共模块】接入说明

1 环境#

沙箱环境:https://sandbox-gateway.pingpongx.com

2 登录步骤#

2.1 第一步 获取账号#

在【我的账户】后台页面点击申请【APP ID】和【密钥】。
注:
【APP ID】和【密钥】即为接口参数中的【app_id】和【app_secret】。
image.png

2.2 第二步 获取登录token#

使用【第一步】获取到的【app_id】和【app_secret】作为参数,请求【获取token】接口,得到【access_token】(后续请求所有接口都需要将【access_token】放入请求头)。
注:
【access_token】是有时效的(默认过期时间为7200秒),所以您需要编写程序定时请求【获取token】接口,以保证本地缓存的【access_token】有效。
获取token参考代码:
注:
access_token失效说明:
1,接入方使用 app_id + app_secret 获取 token,业务请求凭token访问资源;
2,每个token有效期2小时,以福鑫生成时间开始计时;
3,2小时内,接入方如果刷新获取一个新token2,则前一个token1有效期改为5分钟,即token1有效期5分钟,token2有效期2小时(以福鑫刷新时间开始计时)。如果在token1失效前,又刷新获取一个新token3,则token1立即失效,token2有效期改为5分钟,token3有效期2小时(以福鑫刷新时间开始);
4,无效token访问返回401。

3 请求时序#

image.png

4 异常码#

成功(0),
系统异常(999),
内部服务异常(500),
参数异常(400),
业务异常(417),
token失效(401),
请求过于频繁(429)
注:这个“异常码”是返回结果中的code码
如:
{
"code": 400,
"message": "卖出货币缺失"
}

5 金额限制#

单笔换汇最大金额:10,000,000USD或等值其他币种
单笔换汇最小金额:1USD或等值其他币种(目前没限制,后续会加上校验逻辑)

6 交易时间#

5 X 24h(周一早晨6:00 - 周六早晨5:00)
上一页
福鑫OpenApi v2版本介绍
下一页
【实时换汇】接入说明
Built with