执行付款

创建付款

端点目标 URL

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

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

字段说明

请求参数

字段名称	必填	类型	描述
`merchantReference`	M	string	商户请求流水号，不能重复
`payeeId`	M	string	收款方id
`paymentType`	O	string	付款方式，由收款方带出
`paymentFeeType`	O	string	手续费分摊方式，当「收款方式」为「SWIFT」时，必填，固定SHA；
`payerType`	M	string	付款方类型(企业-company 个人-individual)
`payerId`	M	string	当「付款方式」为「LOCAL」时，固定为商户；——暂无当「付款方式」为「SWIFT」时，该值为「商户—merchantId」或「创建的付款方——payerId」；
`amount`	M	Bigdecimal	付款金额
`paymentPurpose`	M	string	付款目的编码(付款目的参考)
`narration`	O	string	交易付言

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`pspReference`	String	futurePay平台流水号
`resultCode`	String	付款订单状态，等待中(CREATE)、付款中(PENDING)、交易成功(SUCCESS)、交易失败(FAILED)
`paymentAmount.currency`	string	扣款币种
`paymentAmount.value`	string	扣款金额
`payeeAmount.currency`	string	付款币种
`payeeAmount.value`	string	付款金额
`feeAmount.currency`	string	手续费币种
`feeAmount.value`	string	手续费金额

集成

创建付款调用输入

{   
    "merchantReference":"wdasdd2520xdD11",
    "payerId":"1864861460719644672",
    "payerType":"company",
    "paymentPurpose":"28",
    "amount":"200",
    "payeeId":"595",
    "narration":"test"
}

调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": 1738832434027,
    "data": {
        "merchantReference": "wdasdd2520xdD11",
        "pspReference": "MP659438116933632",
        "resultCode": "CREATE",
        "paymentAmount": {
            "currency": "USD",
            "value": "200"
        },
        "payeeAmount": {
            "currency": "USD",
            "value": "183.81"
        },
        "feeAmount": {
            "currency": "USD",
            "value": "16.19"
        }
    },
    "success": true
}

在创建付款订单后，请及时调用文件上传接口上传付款材料( 文件上传 )；若超过30分钟后上传付款材料，该订单会被设置为交易失败；若重复上传付款材料则会覆盖之前的付款材料。

查询付款状态

端点目标 URL

沙盒环境请求地址：POST https://api.futurepay-develop.com/api/v1/payment/get-payment-status

生产环境请求地址：POST https://api.futurepay.global/api/v1/payment/get-payment-status

字段说明

请求参数

字段名称	必填	类型	描述
`merchantReference`	M	string	创建付款时商户提交的请求流水号

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`pspReference`	String	futurePay平台流水号
`resultCode`	String	付款订单状态，等待中(CREATE)、付款中(PENDING)、交易成功(SUCCESS)、交易失败(FAILED)
`paymentAmount.currency`	string	扣款币种
`paymentAmount.value`	string	扣款金额
`payeeAmount.currency`	string	付款币种
`payeeAmount.value`	string	付款金额
`feeAmount.currency`	string	手续费币种
`feeAmount.value`	string	手续费金额

集成

查询付款状态调用输入

{   
    "merchantReference":"wdasdd2520xdD11"
}

调用输出

{
    "appId":"1864861460728012800",
    "merchantId":"1864861460719644672",
    "notificationItems":[
        {
            "eventCode":"PAYMENT_ORDER_RESULT",
            "eventDate":1738834234129,
            "paymentAmount": {
                "currency": "USD",
                "value": "200"
            },
            "payeeAmount": {
                "currency": "USD",
                "value": "183.81"
            },
            "feeAmount": {
                "currency": "USD",
                "value": "16.19"
            },
            "merchantReference": "wdasdd2520xdD11",
            "pspReference":"MP659438116933632",
            "resultCode":"FAILED"
        }
    ]
}

WEBHOOK

{
    "appId":"1864861460728012800",
    "merchantId":"1864861460719644672",
    "notificationItems":[
        {
            "eventCode":"PAYMENT_ORDER_RESULT",
            "eventDate":1738834234129,
            "paymentAmount": {
                "currency": "USD",
                "value": "200"
            },
            "payeeAmount": {
                "currency": "USD",
                "value": "183.81"
            },
            "feeAmount": {
                "currency": "USD",
                "value": "16.19"
            },
            "merchantReference": "wdasdd2520xdD11",
            "pspReference":"MP659438116933632",
            "resultCode":"FAILED"
        }
    ]
}

Updated 6 days ago