发起转账

Endpoint

Sandbox

POST https://preapi.futurepay-develop.com/api/v1/transfer/apply

Production

POST https://api.futurepay.global/api/v1/transfer/apply

Request Parameters

Parameter	Required	Type	Description
`payeeId`	M	long	收款人商户号
`merchantReference`	M	string	商户请求流水号
`currency`	M	string	转账币种
`amount`	M	BigDecimal	金额
`paymentPurposeCode`	M	string	转账目的编码
`narration`	O	string	附言

Request Example

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

Response

Field	Type	Description
`merchantReference`	String	商户请求流水号
`pspReference`	String	FuturePay平台流水号
`payAmount`	BigDecimal	扣款金额
`payeeAmount`	BigDecimal	到账金额
`currency`	String	币种
`fee`	BigDecimal	手续费
`payeeId`	String	收款人商户号
`resultCode`	String	订单状态，交易成功（SUCCESS）

Response Example

{
    "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
}

转账查询

Endpoint

Sandbox

POST https://preapi.futurepay-develop.com/api/v1/transfer/query-detail

Production

POST https://api.futurepay.global/api/v1/transfer/query-detail

Request Parameters

Parameter	Required	Type	Description
`merchantReference`	M	String	商户请求流水号

Request Example

{
  "merchantReference": "asdzxczzxczxcxzxcc"
}

Response

Field	Type	Description
`merchantReference`	String	商户请求流水号
`pspReference`	String	FuturePay平台流水号
`payAmount`	BigDecimal	扣款金额
`payeeAmount`	BigDecimal	到账金额
`currency`	String	币种
`fee`	BigDecimal	手续费
`payeeId`	String	收款人商户号
`resultCode`	String	订单状态，交易成功（SUCCESS）

Response Example

{
    "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
}