Webhook

Field	Type	Description
`transactionStatus`	String	收款状态 PENDING(待入账)、SUCCESS(入账成功)、RETURN(入账失败-退回)、RECALL(入账失败-召回)
`tradeNo`	String	收款订单号
`bankAccountNo`	String	收款银行账号
`remitAccNo`	String	汇款方银行账号
`remitAccName`	String	汇款方名称
`remitCountry`	String	汇款方国家
`remitAccAddress`	String	汇款方地址
`remitBankCountry`	String	汇款方银行国家
`remitBankAddress`	String	汇款方银行地址
`remitSwiftCode`	String	汇款方 Swift Code
`remitBankName`	String	汇款方银行名称
`inTime`	String	成功入账时间
`createTime`	String	到账时间
`narration`	String	附言
`arrivalAmt.currency`	String	到账金额币种
`arrivalAmt.value`	String	到账金额
`entryAmt.currency`	String	入账金额币种
`entryAmt.value`	String	入账金额
`totalFeeAmt.currency`	String	手续费金额币种
`totalFeeAmt.value`	String	手续费金额
`returnFeeAmt.currency`	String	退回手续费金额币种
`returnFeeAmt.value`	String	退回手续费金额
`recallFeeAmt.currency`	String	召回手续费金额币种
`recallFeeAmt.value`	String	召回手续费金额

Payload Example

{
    "appId": "1929723739684102144",
    "merchantId": "1929723739654762496",
    "notificationItems": [
        {
            "entryAmt": {
                "currency": "GBP",
                "value": "147.75"
            },
            "totalFeeAmt": {
                "currency": "GBP",
                "value": "2.25"
            },
            "arrivalAmt": {
                "currency": "GBP",
                "value": "150"
            },
            "remitBankAddress": "1 CHURCHILL PLACE",
            "tradeNo": "RO767372195905537",
            "remitBankCountry": "GB",
            "transactionStatus": "SUCCESS",
            "remitAccAddress": "10 Downing Street, London",
            "bankAccountNo": "00092378",
            "remitAccNo": "FR29NWBK60161331926819",
            "inTime": "2025-12-08T10:04:18",
            "eventCode": "TRANSACTION_ORDER_RESULT",
            "remitSwiftCode": "BUKBGB22",
            "remitBankName": "BARCLAYS BANK UK PLC",
            "remitCountry": "GB",
            "narration": "",
            "createTime": "2025-12-08T08:45:27",
            "remitAccName": "GUANG ZHOU LING YANG KE JI YOU X",
            "eventDate": 1765188258343
        }
    ]
}

查询收款订单详情

Endpoint

Sandbox

POST https://preapi.futurepay-develop.com/api/v1/transaction/get-detail

Production

POST https://api.futurepay.global/api/v1/transaction/get-detail

Request Parameters

Parameter	Required	Type	Description
`tradeNo`	M	string	收款订单流水号

Request Example

{
    "tradeNo": "RO772364583952388"
}

Response

Field	Type	Description
`arrivalAmt.currency`	String	到账金额币种
`arrivalAmt.value`	String	到账金额
`entryAmt.currency`	String	入账金额币种
`entryAmt.value`	String	入账金额
`totalFeeAmt.currency`	String	手续费金额币种
`totalFeeAmt.value`	String	手续费金额
`transactionStatus`	String	收款状态
`bankAccountNo`	String	收款银行账号
`remitAccName`	String	汇款方名称
`remitAccNo`	String	汇款方银行账号
`remitCountry`	String	汇款方国家
`remitAccAddress`	String	汇款方地址
`remitBankName`	String	汇款方银行名称
`remitBankCountry`	String	汇款方银行国家
`remitBankAddress`	String	汇款方银行地址
`remitSwiftCode`	String	汇款方 Swift Code
`remitBankCode`	String	汇款方银行编码
`tradeNo`	String	收款订单号
`narration`	String	附言
`inTime`	String	成功入账时间
`createTime`	String	到账时间

Response Example

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1766402448416,
    "data": {
        "arrivalAmt": {
            "currency": "NGN",
            "value": "10000"
        },
        "entryAmt": {
            "currency": "NGN",
            "value": "8525.77"
        },
        "totalFeeAmt": {
            "currency": "NGN",
            "value": "1474.23"
        },
        "transactionStatus": "PENDING",
        "bankAccountNo": "3155338586",
        "remitAccName": "lebron jameszo",
        "remitAccNo": "08100000000",
        "remitCountry": "NG",
        "remitAccAddress": "",
        "remitBankName": null,
        "remitBankCountry": "",
        "remitBankAddress": null,
        "remitSwiftCode": "",
        "remitBankCode": null,
        "tradeNo": "RO772364583952388",
        "narration": "zzz",
        "inTime": null,
        "createTime": "2025-12-22 11:19:33"
    },
    "success": true
}