汇率查询

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/fx/rate

生产环境请求地址：POST https://api.futurepay.global/api/v1/fx/rate

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`direction`	O	int	查询方向 0：指定买入 1：指定卖出默认为0
`buyCcy`	M	string	买入币种
`sellCcy`	M	string	卖出币种

响应data参数

字段名	类型	说明
`sellCcy`	String	商户请求流水号
`buyCcy`	String	状态 0-待审核 1-审核通过 2-审核拒绝
`rate`	BigDecimal	汇率
`expireTime`	long	过期时间单位时间戳秒

集成

创建付款方调用输入

{
    "direction":1,
    "buyCcy":"USD",
    "sellCcy":"CNH"
}

创建付款方调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
        "sellCcy": "USD",
        "buyCcy": "CNH",
        "rate": 7.012345,
        "expireTime": 321382105521
    },
    "success": true
}

换汇汇率查询

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/fx/inquiry

生产环境请求地址：POST https://api.futurepay.global/api/v1/fx/inquiry

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`direction`	O	int	查询方向 0：指定买入 1：指定卖出默认为0
`buyCcy`	M	string	买入币种
`sellCcy`	M	string	卖出币种
`amount`	M	BigDecimal	交易金额

响应data参数

字段名	类型	说明
`selling`	Money	商户请求流水号
`buying`	Money	状态 0-待审核 1-审核通过 2-审核拒绝
`rate`	BigDecimal	汇率
`expireTime`	long	过期时间单位时间戳秒
`token`	String	询价token，发起换汇时需要携带发起
`direction`	int	汇率查询方向

Money

字段名	类型	说明
`amount`	Bigdecimal	金额
`currency`	String	币种
`accuracy`	int	精度

集成

换汇汇率查询调用输入

{
    "direction":1,
    "buyCcy":"USD",
  	"sellCcy":"CNH",
		"amount":100.00
}

换汇汇率查询调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
      "selling": {
        "currency":"CNH",
				 "amount":"100",
				"accuracy":2
      },
				"buying": {
        "currency":"USD",
				 "amount":"15.00",
				"accuracy":2
        },
				"direction":1,
        "token":"3213920195dsfksjq",
        "rate": 7.012345,
        "expireTime": 321382105521
    },
    "success": true
}

换汇申请

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/fx/apply

生产环境请求地址：POST https://api.futurepay.global/api/v1/fx/apply

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`reference`	M	string	商户请求流水号，不可重复
`token`	M	string	换汇汇率查询token

响应data参数

字段名	类型	说明
`tradeNo`	string	换汇订单号
`status`	int	状态 10：处理中，2000：成功，2500：失败，3000：取消

集成

换汇汇率查询调用输入

{
    "reference":"3213145131",
  "token":"23141242321sdsas"
}

换汇汇率查询调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
      "tradeNo":"23132167udds",
			"status":10
    },
    "success": true
}

换汇申请

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/fx/apply

生产环境请求地址：POST https://api.futurepay.global/api/v1/fx/apply

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`reference`	M	string	商户请求流水号，不可重复
`token`	M	string	换汇汇率查询token

响应data参数

字段名	类型	说明
`tradeNo`	string	换汇订单号
`status`	int	状态 10：处理中，2000：成功，2500：失败，3000：取消

集成

换汇申请调用输入

{
    "reference":"3213145131",
  "token":"23141242321sdsas"
}

换汇申请调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
      "tradeNo":"23132167udds",
      "status":10
}
	}

换汇订单详情查询

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/fx/query-detail

生产环境请求地址：POST https://api.futurepay.global/api/v1/fx/query-detail

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	O	string	商户请求流水号，不可重复
`tradeNo`	O	string	换汇订单号

响应data参数

字段名	类型	说明
`tradeNo`	string	换汇订单号
`status`	int	状态 10：处理中，2000：成功，2500：失败，3000：取消
`buyAmount`	Money	买入金额
`sellAmount`	Money	卖出金额
`rate`	BigDecimal	汇率
`direction`	int	换汇方向 0-买入 1-卖出
`createTime`	long	创建时间时间戳单位秒

集成

换汇汇率查询调用输入

{
    "merchantReference":"3213145131",
  "tradeNo":"23141242321sdsas"
}

换汇汇率查询调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
       
      "tradeNo":"23132167udds",
      "status":10,
			"buyAmount": {
        "currency":"CNH",
				 "amount":"100",
				"accuracy":2
      },
			"sellAmount": {
        "currency":"USD",
				 "amount":"15.00",
				"accuracy":2
      },
      "rate":7.012345,
      "direction":1, 
      "createTime":32132141321
    },
    "success": true
}