统一下单

POST

https://pay.cnyepay.com/api/pay/unifiedOrder

商户业务系统通过统一下单接口发起支付收款订单，粤收付支付网关会根据商户配置的支付通道路由支付通道完成支付下单。

请求参数

Body 参数application/json

示例

{
    "mchNo": "M1755581016",
    "appId": "68a40a59e4b0bf61830a5687",
    "reqTime": "1622016572190",
    "version": "1.0",
    "sign": "Base64编码的RSA2签名字符串",
    "signType": "RSA2",
    "mchOrderNo": "M1958086561207775233",
    "wayCode": "WEB_CASHIER",
    "amount": 100,
    "currency": "CNY",
    "clientIp": "175.0.227.20",
    "subject": "支付网关地址商品标题测试",
    "body": "支付网关地址商品描述测试",
    "notifyUrl": "https://www.cnyepay.com/notify.htm",
    "returnUrl": "https://www.cnyepay.com/return.htm",
    "channelExtra": {
        "authCode": "13920933111042",
        "buyerUserId": "2088702585070844",
        "openid": "o6BcIwvSiRpfS8e_UyfQNrYuk2LI",
        "subAppId": "wx08b5a41f7a27abf1",
        "payDataType": "codeUrl",
        "entryPageType": "h5"
    },
    "extParam": "134586944573118714"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://pay.cnyepay.com/api/pay/unifiedOrder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mchNo": "M1755581016",
    "appId": "68a40a59e4b0bf61830a5687",
    "reqTime": "1622016572190",
    "version": "1.0",
    "sign": "Base64编码的RSA2签名字符串",
    "signType": "RSA2",
    "mchOrderNo": "M1958086561207775233",
    "wayCode": "WEB_CASHIER",
    "amount": 100,
    "currency": "CNY",
    "clientIp": "175.0.227.20",
    "subject": "支付网关地址商品标题测试",
    "body": "支付网关地址商品描述测试",
    "notifyUrl": "https://www.cnyepay.com/notify.htm",
    "returnUrl": "https://www.cnyepay.com/return.htm",
    "channelExtra": {
        "authCode": "13920933111042",
        "buyerUserId": "2088702585070844",
        "openid": "o6BcIwvSiRpfS8e_UyfQNrYuk2LI",
        "subAppId": "wx08b5a41f7a27abf1",
        "payDataType": "codeUrl",
        "entryPageType": "h5"
    },
    "extParam": "134586944573118714"
}'

返回响应

🟢200成功

application/json

成功响应

Body

示例

{
    "code": 0,
    "msg": "SUCCESS",
    "sign": "string",
    "data": {
        "payOrderId": "string",
        "mchOrderNo": "string",
        "orderState": 0,
        "payDataType": "string",
        "payData": "string",
        "errCode": "string",
        "errMsg": "string"
    }
}

修改于 2025-10-27 11:41:53

支持的支付方式

关闭订单