单笔付款

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	string	商户请求流水号，不能重复
`reportReference`	M	string	申报主体请求号
`payAmt`	M	BigDecimal	付款金额
`beneficiaryName`	M	string	受益人名称
`benefitType`	M	int	受益人类型 1-企业 2-个人
`businessType`	M	string	交易类型
`note`	O	string	备注
`bankState`	O	string	银行所在省，受益人非申报主体时必填
`bankCity`	O	string	银行所在市，受益人非申报主体时必填
`depositBank`	O	string	支行名称，受益人非申报主体时必填
`bin`	O	string	联行号，受益人非申报主体时必填
`accountName`	O	string	账户名称，受益人非申报主体时必填
`bankAccountNo`	O	string	银行卡号，受益人非申报主体时必填

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`status`	String	状态 40-付款中 50-成功 60-校验失败
`tradeNo`	String	还原申报批次号

集成

单笔付款调用输入


{
	"merchantReference": "1234567",
  "reportReference": "1234567",
  "payAmt":"1000.00",
  "beneficiaryName": "zs",
  "benefitType",1,
  "businessType":"TRADEB2C",
  "note": "xxx",
  "bankState": "xx",
  "bankCity":"xx",
  "depositBank":"xx",
  "bin":"xxx",
  "accountName":"zhangsan",
  "bankAccountNo":"2313213"






}

单笔付款调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
        "merchantReference": "1234567",
      	"status":"0",
     	  "tradeNo":"xxxx"	 


    },
    "success": true
}

批量付款

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	string	商户请求流水号，不能重复
`reportReference`	M	string	申报主体请求号
`payAmt`	M	BigDecimal	付款金额
`businessType`	M	string	交易类型
`filePath`	M	string	批量付款文件上传地址
`note`	O	string	备注

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`status`	String	状态 40-付款中 50-成功 60-校验失败
`tradeNo`	String	还原申报批次号
`filePath`	String	文件上传地址
`errorFilePath`	String	错误文件上传地址
`errMsg`	String	错误信息
`status`	int	状态

集成

批量付款调用输入


{
	"merchantReference": "1234567",
  "reportReference": "1234567",
  "payAmt":"1000.00",
  "businessType":"TRADEB2C",
  "note": "xxx",
   "filePath":"xxx"

}

批量付款调用输出


{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
      "merchantReference": "1234567",
      "status":40,
      "filePath":"xx/xx/xx",
      "errFilePath":"xx/xx/xx",
      "errMsg":"付款金额于文件解析金额不一致",
			"tradeNo":"B12323413131"

    },
    "success": true
}

批次查询

端点目标 URL

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

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

字段说明

调用的特定输入参数

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

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`status`	int	状态 30-付款中 40-部分成功 50-成功 60-校验失败
`tradeNo`	String	还原申报批次号
`filePath`	String	文件上传地址
`errorFilePath`	String	错误文件上传地址
`currency`	String	币种
`payAmt`	BigDecimal	付款金额
`payFee`	BigDecimal	付款手续费
`detailTotal`	int	付款总笔数
`successTotal`	int	成功笔数
`failTotal`	int	失败笔数
`businessType`	String	交易类型
`reportEntityName`	String	申报主体名称

集成

批量查询调用输入


{
		"merchantReference":"xxxx"


}

批次查询调用输出


{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
      "merchantReference": "1234567",
      "status":30,
      "filePath":"xx/xx/xx",
      "errFilePath":"xx/xx/xx",
      "payAmt":1000.00,
      "payFee":100.00,
      "detailTotal":10,
      "successTotal":0,
      "failTotal":0,
      "businessType":"TRADEB2C",
      "reportEntityName":"xxx"

    },
    "success": true
}

单笔付款查询

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`tradeNo`	M	string	付款订单号

响应data参数

字段名	类型	说明
`tradeNo`	String	商户请求流水号
`status`	int	状态 40-付款中 50-成功 60-失败
`tradeNo`	String	付款订单号
`currency`	String	币种
`payAmt`	BigDecimal	付款金额
`feeAmt`	BigDecimal	付款手续费
`businessType`	String	交易类型
`benefitType`	int	受益人类型 1 企业 2 个人
`bankState`	String	银行所在省
`bankCity`	String	银行所在市
`benefitName`	String	受益人名称
`businessType`	String	交易类型
`accountNo`	String	受益人卡号
`depositBank`	String	受益人支行信息
`bin`	String	联行号
`currency`	String	币种
`remark`	String	备注

集成

单笔付款查询调用输入


{
		"tradeNo":"xxxx"


}

单笔付款查询调用输出


{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
      "tradeNo": "1234567",
      "status":40,
      "payAmt":1000.00,
      "payFee":100.00,
      "businessType":"TRADEB2C",
      "reportEntityName":"xxx",
      "bankState":"深圳",
      "bankCity":"广东",
      "benefitType":1,
      "benefitName":"张三",
      "accountNo":"23153211",
      "depositBank":"xxx",
      "bin":"2311231",
      "currency":"CNY",
			"remark":"11",
    },
    "success": true
}