发起支付接口

提供获取西月订单支付相关信息的能力，支持批量查询多个订单的支付详情，包括订单数量、商品数量、总金额、支付方式等信息。

适用场景

查询订单的支付信息

批量获取多个订单的支付相关详情

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/pay/pay
测试环境：https://testing.westmonth.com/openapi/pay/pay

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
type	integer	是	-	-	支付类型需授权获取支付方式
orderNumberList	array	是	-	-	西月订单号，一维数组形式传递
password	string	是	-	-	加密后的支付密码
card_id	int	否	-	-	充值卡ID（余额支付、充值卡支付必填）

注：支付密码需要RSA公钥加密后BASE64的字符串

公钥

代码示例

PHP代码：

// 传入密码
function RSAPublicKeyEncryption($data)
{
    $publicKey = config('rsa.publicKey');// 公钥
    $encryptedData = '';
    if (openssl_public_encrypt($data, $encryptedData, $publicKey, OPENSSL_PKCS1_PADDING) === FALSE) {
        return Base64_encode($encryptedData);
    } else {
        return Base64_encode($encryptedData);
    }
}

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功）
msg	string	提示信息（成功时为空）
data	object	业务数据

data对象字段

字段	类型	说明

不同的支付方式，返回的数据结构不同

// 万里汇
{
	"code": 0,
	"msg": "",
	"data": {
		"actionFormType": "RedirectActionForm",
		"method": "GET",
		"redirectUrl": "https://icashierprod-qk-sim.alipay.com/m/business/cashier/checkout?partnerId=2188140386674455&cashierOrderId=09280160951680d1dfb03b8731eb6247"
	}
}

// 支付宝
{
	"code": 0,
	"msg": "",
	"data": {
		"result": "<form id='alipay_submit' name='alipay_submit' action='https://openapi.alipay.com/gateway.do?charset=utf-8' method='POST'><input type='hidden' name='app_id' value='2021004138650630'/><input type='hidden' name='method' value='alipay.trade.page.pay'/><input type='hidden' name='format' value='JSON'/><input type='hidden' name='return_url' value='http://a.westmonth.com:8801/shop_api/alipay/sync'/><input type='hidden' name='charset' value='utf-8'/><input type='hidden' name='sign_type' value='RSA2'/><input type='hidden' name='timestamp' value='2024-09-28 10:53:38'/><input type='hidden' name='version' value='1.0'/><input type='hidden' name='notify_url' value='http://a.westmonth.com:8801/shop_api/alipay/notify'/><input type='hidden' name='app_cert_sn' value='65cfe538d303fad822f67f89339ba0d8'/><input type='hidden' name='alipay_root_cert_sn' value='687b59193f3f462dd5336e5abf83c5d8_02941eef3187dddf3d3b83462e1dfcf6'/><input type='hidden' name='biz_content' value='{\"product_code\":\"FAST_INSTANT_TRADE_PAY\",\"out_trade_no\":\"2024092876363\",\"total_amount\":\"8.00\",\"subject\":\"\\u897f\\u6708\\u9009\\u54c1\\u7f51\\u8ba2\\u5355\\u652f\\u4ed8\"}'/><input type='hidden' name='sign' value='al8bqZTURSOQ6RqWAvUAtxbILB0pRTUTNoRGKzRZ0O5gmbUWghDCR0UbrbNput1Swc+zooJyF5qSwGuY2fZFCc4BfAl67YAXC1F2YMJ2JCaUnz3nXfSpWhyjaiHAy5bjU9Fsgt8n7B9MNHT8sYsIDmcwnfpxC6jjaR2pupSeZQsg8KZ1rtbyHpZ9k/P0njIpUdnlaD6VR5qYNaQaiYxlxkLey4nSYT11VAh6PQ4/TMurUPY+aJ+G1eSVZU1SDIsiCJ6ScwT5lhY2B6RVibyJmye6jabxYspnVd720D1xaD7Xk/wq3BsdmGemH5K+PnEemOL5GFiIuPpFdT1FK5UpgQ=='/><input type='submit' value='ok' style='display:none;'></form><script>document.forms['alipay_submit'].submit();</script>"
	}
}

// 额度或货到付款
{
    "code": 0,
    "msg": "",
    "data": {
        "total": "￥32.00",
        "remain": "￥99,968.00"
    }
}

调用示例

URL请求

请求示例

{
    "type": 3,
    "orderNumberList": [
        "aOP2505071626702"
    ],
    "password": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtoohrn6S3C8KnlbK0RSc0OFh7MxO/1KiT0t9cAKq222VfuTE1oOCAl9FUli2OoH3wh5H4hsZe+B29N4757mlIeuF0RdEK/9d68dYzmiAaSnhOtfGXzbV/CgFeZFQUsOQYUWuX854m171+Tc0Kp6BkfJ2Lw6r1xnAwaW9Mtm76i95X7aHAY4JNEBl2pWucdzOhaZTJM59iMghR681OSgw4YS0s6Xe2kqgM+v1vLbrwuXU8VcD9cQhyC9srdGv+iKzVZqPSgM/PHSpv7tWgq3cN7cMQ1U3o8RNu3/KuW7UBYGUkWSUlg3GOwwl8QxF4QSs/zfX/iSd06AapdFtU07YxQIDAQAB"
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": {
        "total": "￥32.00",
        "remain": "￥99,968.00"
    }
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

常见问题

版本历史

版本	日期	修改说明
v1.0	2025-01-01	初始版本

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": {
        "actionFormType": "RedirectActionForm",
        "method": "GET",
        "redirectUrl": "https://icashierprod-qk.alipay.com/business/cashier/checkout?partnerId=2188140386674455&cashierOrderId=0507016108004c7a49c5ac12fd308760",
        "trade_no": "2025050721115048768"
    }
}

发起支付

发起支付接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

公钥

代码示例

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

版本历史

请求参数

请求示例代码

返回响应

发起支付

发起支付接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

公钥#

代码示例#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

版本历史#

请求参数

请求示例代码

返回响应

发起支付接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

公钥

代码示例

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

版本历史