转账

发起转账

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`payeeId`	M	long	收款人商户号
`merchantReference`	M	string	商户请求流水号
`currency`	M	string	转账币种
`amount`	M	BigDecimal	金额
`paymentPurposeCode`	M	string	转账目的编码
`narration`	O	string	附言

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`pspReference`	String	futurepay平台流水号
`payAmount`	BigDecimal	扣款金额
`payeeAmount`	BigDecimal	到账金额
`currency`	String	币种
`fee`	BigDecimal	手续费
`payeeId`	String	收款人商户号
`resultCode`	String	订单状态,交易成功(SUCCESS)

集成

发起转账调用输入

{
  "payeeId": "1985189713480429568",
  "currency": "USD",
  "amount": "100",
  "paymentPurposeCode": "01",
  "paymentReference": "",
  "merchantReference": "asdzxczzxczxcxzxcc"
}

发起转账调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1773369598677,
    "data": {
        "merchantReference": "asdzxczzxczxcxzxcc",
        "pspReference": "TP800902342475801",
        "resultCode": "SUCCESS",
        "payAmount": 100.00,
        "payeeAmount": 100.00,
        "fee": 0.00,
        "currency": "USD",
        "payeeId": "1985189713480429568"
    },
    "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	商户请求流水号
`pspReference`	String	futurepay平台流水号
`payAmount`	BigDecimal	扣款金额
`payeeAmount`	BigDecimal	到账金额
`currency`	String	币种
`fee`	BigDecimal	手续费
`payeeId`	String	收款人商户号
`resultCode`	String	订单状态,交易成功(SUCCESS)

转账查询调用输入

{
  "merchantReference": "asdzxczzxczxcxzxcc"
}

查询调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1773370078006,
    "data": {
        "merchantReference": "asdzxczzxczxcxzxcc",
        "pspReference": "TP800902342475801",
        "resultCode": "SUCCESS",
        "payAmount": 100.000000,
        "payeeAmount": 100.000000,
        "fee": 0.000000,
        "currency": "USD",
        "payeeId": "1985189713480429568"
    },
    "success": true
}

Updated 20 days ago