发起换汇

换汇询价

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`direction`	M	int	指定买入卖出 0：指定买入 1：指定卖出
`buyCcy`	M	String	买入币种
`sellCcy`	M	String	卖出币种
`amount`	M	BigDecimal	交易金额

响应data参数

字段名	类型	说明
`token`	String	换汇汇率锁定token，发起换汇时需传参调用
`direction`	int	汇率查询方向 0：买入 1：卖出
`rate`	BigDecimal	汇率
`expireTime`	Long	过期时间单位时间戳秒
`selling`	Money	卖出金额
`buying`	Money	买入金额

Money

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

集成

换汇询价询调用输入

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

换汇询价查询调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
      "selling": {
        "currency":"USD",
        "amount":100.00,
				"accuracy":2
			},
      "buying":{
        "currency":"CNH",
        "amount":700.00,
				"accuracy":2
			},
      "rate": 7.0000000000,
      "expireTime":1763113556851,
			"token":"789sfmko23135lkldsah"
    },
    "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":"321315787ss",
	"token":"8239018321kk"
}

申请换汇调用输出

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

换汇订单查询

端点目标 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	换汇订单号
`direction`	int	汇率查询方向 0：买入 1：卖出
`rate`	BigDecimal	汇率
`createTime`	Long	创建时间单位时间戳秒
`buyAmount`	Money	卖出金额
`sellAmount`	Money	买入金额
`status`	int	换汇状态 10：处理中 2000：成功 2500：失败 3000：取消

Money

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

集成

换汇订单查询调用输入

{
 
  "tradeNo": "Fx238190384173291"
 
}

换汇订单查询调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
      "sellAmount": {
        "currency":"USD",
        "amount":100.00,
				"accuracy":2
			},
      "buyAmount":{
        "currency":"CNH",
        "amount":700.00,
				"accuracy":2
			},
      "rate": 7.0000000000,
      "createTime":1763113556851,
      "tradeNo":"Fx83290213809131",
      "direction":1,
			"status":2000

    },
    "success": true
}

WEBHOOK

{
    "appId": "1929723739684102144", 
    "merchantId": "1929723739654762496", 
    "notificationItems": [
        {
            "msg": "SUCCESS", 
            "reference": "ZXCZXCZXC", 
            "eventCode": "EXCHANGE_ORDER_RESULT", 
            "tradeNo": "FX805275403079772", 
            "status": 2000, 
            "eventDate": 1774438800740
        }
    ]
}

Updated about 1 month ago