执行付款

创建付款

端点目标 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
`paymentFeeType`	O	string	手续费分摊方式，枚举类型 SHA、OUR、BEN
`payerType`	M	string	付款方类型(企业-company 个人-individual)
`payerId`	M	string	该值为「商户—merchantId」或「创建的付款方——payerId」；
`amount`	M	Bigdecimal	付款金额
`debitCcy`	M	string	扣款币种
`paymentPurposeCode`	M	string	付款目的编码(付款目的参考)
`materialId`	M	string	付款文件材料id
`phoneAreaCode`	O	string	手机号区号
`phoneNumber`	O	string	手机号
`narration`	O	string	交易付言

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`pspReference`	String	futurePay平台流水号
`resultCode`	String	付款订单状态，创建(CREATE)、合规检查中（COMPLIANCE）、付款中(PENDING)、交易成功(SUCCESS)、交易失败(FAILED)、交易失败-已退回(RETURN)、交易失败-已召回(RECALL)
`paymentAmount.currency`	string	扣款币种
`paymentAmount.value`	string	扣款金额
`payeeAmount.currency`	string	付款币种
`payeeAmount.value`	string	付款金额
`feeAmount.currency`	string	手续费币种
`feeAmount.value`	string	手续费金额

集成

创建付款调用输入

{   
    "merchantReference":"000004c69635c0kcCCpp00ccdas",
    "payerId":"1864861460719644672",
    "payerType":"company",
    "paymentPurposeCode":"28",
    "amount":"200",
    "payeeId":"930",
    "narration":"test",
    "debitCcy":"USD",
    "phoneNumber":"987654321",
    "phoneAreaCode":"+123",
    "materialId":"174407936130263062796",
    "paymentFeeType":"SHA"
}

调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1744079376875,
    "data": {
        "merchantReference": "000004c69635c0kcCCpp00ccdas",
        "pspReference": "MP680929594109952",
        "resultCode": "CREATE",
        "paymentAmount": {
            "currency": "USD",
            "value": "204"
        },
        "payeeAmount": {
            "currency": "USD",
            "value": "200"
        },
        "feeAmount": {
            "currency": "USD",
            "value": "4"
        }
    },
    "success": true
}

查询付款状态

端点目标 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)、合规检查中（COMPLIANCE）、付款中(PENDING)、交易成功(SUCCESS)、交易失败(FAILED)、交易失败-已退回(RETURN)、交易失败-已召回(RECALL)
`paymentAmount.currency`	string	扣款币种
`paymentAmount.value`	string	扣款金额
`payeeAmount.currency`	string	付款币种
`payeeAmount.value`	string	付款金额
`feeAmount.currency`	string	手续费币种
`feeAmount.value`	string	手续费金额
`returnAmount.currency`	string	退回金额币种
`returnAmount.value`	string	退回金额
`discountFeeAmount.currency`	string	召回手续费金额币种
`discountFeeAmount.value`	string	召回手续费金额

集成

查询付款状态调用输入

{   
    "merchantReference":"000004c69635c0kcCCpp00ccdas"
}

调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1744079430062,
    "data": {
        "merchantReference": "000004c69635c0kcCCpp00ccdas",
        "pspReference": "MP680929594109952",
        "resultCode": "COMPLIANCE",
        "paymentAmount": {
            "currency": "USD",
            "value": "204"
        },
        "payeeAmount": {
            "currency": "USD",
            "value": "200"
        },
        "feeAmount": {
            "currency": "USD",
            "value": "4"
        },
        "returnAmount": {
            "currency": null,
            "value": null
        },
        "discountFeeAmount": {
            "currency": null,
            "value": null
        }
    },
    "success": true
}

WEBHOOK

{
    "appId":"1864861460728012800",
    "merchantId":"1864861460719644672",
    "notificationItems":[
        {
            "eventCode":"PAYMENT_ORDER_RESULT",
            "eventDate":1738834234129,
            "paymentAmount": {
                "currency": "USD",
                "value": "204"
            },
            "payeeAmount": {
                "currency": "USD",
                "value": "200"
            },
            "feeAmount": {
                "currency": "USD",
                "value": "4"
            },
            "returnAmount":{},
            "discountFeeAmount":{},
            "merchantReference": "000004c69635c0kcCCpp00ccdas",
            "pspReference":"MP659438116933632",
            "resultCode":"SUCCESS"
        }
    ]
}

Updated 19 days ago