转账

发起转账

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`payeeId`	M	long	收款人商户号
`payeeName`	M	string	买入币种
`currency`	M	string	卖出币种
`amount`	M	BigDecimal	金额
`direction`	M	int	指定方向 0：指定扣款 1：指定付款
`paymentPurposeCode`	M	string	付款目的编码
`paymentReference`	M	string	付款附言
`materials`	M	Array	付款材料,内容见Material

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`status`	String	状态 0-待审核 1-审核通过 2-审核拒绝
`payAmount`	BigDecimal	汇率
`payeeAmount`	BigDecimal	过期时间单位时间戳秒
`payCurrency`	String	付款币种
`payeeCurrency`	String	收款币种
`rate`	BigDecimal	转换汇率
`fee`	BigDecimal	手续费
`feeCurrency`	String	手续费币种
`payeeBankAccount`	String	收款人账号
`payeeName`	String	收款人名称

Material

字段名	类型	说明
`path`	String	上传文件路径
`name`	String	文件名称

集成

发起转账调用输入

{
"payeeId": 2313213,
"payeeName": "张三",
"currency": "USD",
"amount": 100.00,
"direction": 1,
"paymentPurposeCode": "32131",
"paymentReference": "转账001",
  "materials":[ {
    "path":"xxx/xxx/xxx",
		"name":"xxx"
  }]
}

发起转账调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
    "merchantReference": "2313213",
    "status": 50,
    "payAmount": 100.00,
    "payeeAmount": 100.00,
    "payCurrency": "USD",
    "payeeCurrency": "USD",
    "rate": "1.00",
    "fee": 10.00,
    "feeCurrency": "USD",
    "payeeBankAccount": "2313131312",
    "payeeName": "张三"
},
    "success": true
}

转账查询

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	String	商户请求流水号，不可重复

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`status`	String	状态 0-待审核 1-审核通过 2-审核拒绝
`payAmount`	BigDecimal	汇率
`payeeAmount`	BigDecimal	过期时间单位时间戳秒
`payCurrency`	String	付款币种
`payeeCurrency`	String	收款币种
`rate`	BigDecimal	转换汇率
`fee`	BigDecimal	手续费
`feeCurrency`	String	手续费币种
`payeeBankAccount`	String	收款人账号
`payeeName`	String	收款人名称

转账查询调用输入

{
"merchantReference":"32132131"
}

查询调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
    "merchantReference": "2313213",
    "status": 50,
    "payAmount": 100.00,
    "payeeAmount": 100.00,
    "payCurrency": "USD",
    "payeeCurrency": "USD",
    "rate": "1.00",
    "fee": 10.00,
    "feeCurrency": "USD",
    "payeeBankAccount": "2313131312",
    "payeeName": "张三"
},
    "success": true
}

Updated about 5 hours ago