有奖捉虫:云通信与企业服务文档专题,速来> HOT

接口描述

手机 H5 支付接口,目前仅支持微信支付。
url
https://pay.qcloud.com/cpay/mob_web_pay

输入参数

参数名
必填
类型
说明
request_content
String
请求内容,该 string 可以转为 json 结构,json 格式见本节 RequestContent。
authen_info
AuthenInfo
认证信息,详见接口调用说明。

RequestContent 结构

一级参数名
二级参数名
三级参数名
必填
类型
说明
out_trade_no
-
String(32)
由客户端生成的订单号,前缀必须是云支付订单前缀。
total_fee
-
Number(32)
订单总金额,单位:分。
fee_type
-
String
货币类型(目前只支持人民币,请填 CNY)。
time_expire
-
Number(64)
订单过期时间。
body  
-
String(128)
商品或订单简要描述,需传入应用市场上的“APP 名称-实际商品名称”,如“天天爱消除-游戏充值”。
detail
-
String
商品详细列表,由 json 转化而来,json 结构见公共数据结构 Detail。
remark
-
String(127)
支付备注信息。
wxpay_pay_content_ext
attach
String(127)
附加数据,记录子商户自定义数据。
goods_tag
String(32)
商品标记,代金券或立减优惠功能的参数。
limit_pay
String(32)
定支付方式,目前只能是 no_credit,指定不能使用信用卡支付。
scene_info
String(256)
支付的场景信息 json 串,参数格式参考微信官方文档 参数说明部分
pay_mch_key
pay_platform
-
Number(32)
第三方支付类型,详见枚举 PayPlatform。
out_mch_id
-
String(32)
服务商对外账号。
out_sub_mch_id
-
String(32)
子商户对外账号。
out_shop_id
-
String(32)
门店对外账号。
order_client
spbill_create_ip
-
String(16)
客户端 IP。
nonce_str
-
-
String(32)
随机字符串。

输出参数

参数名
必填
类型
说明
response_content
ResponseContent
请求内容,该 string 可以转为 json 结构,json 格式见本节 ResponseContent。
authen_info
AuthenInfo
认证信息,详见接口调用说明。

ResponseContent 结构

参数名
必填
类型
说明
status
Status
错误码,详见 枚举值定义-Status 枚举变量。0:成功;非0:失败。
description
String(255)
错误描述。
log_id
Number(32)
消息 ID。
internal_status
Number(32)
调试使用,调用者可以不予理会。
mobile_web_pay
MobileWebPayResponse
authen_info 存在时必填。详见 MobileWebPayResponse。

MobileWebPayResponse 结构

一级参数名
二级参数名
必填
类型
说明
pay_mch_key
-
PayMchKey
支付商户信息,详细见公共数据结构 PayMchKey。
nonce_str
-
String(32)
随机字符串。
mobile_web_pay
wxpay
WxpayMWebArguments
微信 H5 支付 SDK 接口参数,结构见下文。

WxpayMWebArguments 结构

参数名
必填
类型
说明
mweb_url
String
浏览器用来拉起微信 H5 支付的 URL。可在 mweb_url 后拼接参数 redirect_url,指定回调页面。当用户支付完成后,手机浏览器会调整到 redirect_url。
prepay_id
String
微信返回的支付交易会话 ID,目前没有实际作用。

示例

输入参数示例:
{
"authen_info": {
"a": {
"authen_type": 1,
"authen_code": "2D51EDAB82771A999B80F8EEE38CEC1A68FC2BDC9BCCA12C0B6EDA8BC22BF5DA"
}
},
"request_content": {
"pay_mch_key": {
"pay_platform": 1,
"out_mch_id": "sz01fdd7icm7JKjkkfc3",
"out_sub_mch_id": "sz01LG0dvp4O09jjuPbA",
"out_shop_id": "sz011Zszd73bocifI9eG"
},
"nonce_str": "E94C00688C3F429CA2B0B396BF823548",
"order_client": {
"spbill_create_ip": "90.0.00.0"
},
"pay_content": {
"body": "body",
"out_trade_no": "010000521567668680",
"wxpay_pay_content_ext": {
"scene_info": "{"h5_info": {"type":"Wap","wap_url": "https://pay.qq.com\\",\\"wap_name\\": "\\u817e\\u8baf\\u5145\\u503c"}}"
},
"total_fee": 100,
"fee_type": "CNY"
}
}
}
输出参数示例:
{
"response_content": {
"status": 0,
"description": "\\u64CD\\u4F5C\\u6210\\u529F\\u3002",
"log_id": 3637968353,
"internal_status": 0,
"mobile_web_pay": {
"pay_mch_key": {
"pay_platform": 1,
"out_mch_id": "sz01fdd7icm7JKjkkfc3",
"out_sub_mch_id": "sz01LG0dvp4O09jjuPbA",
"out_shop_id": "sz011Zszd73bocifI9eG",
"sub_pay_platform": 100
},
"nonce_str": "zWbxyYBupz2DDIRiO9u9BsmjbAQsmnGv",
"mweb_args": {
"wxpay": {
"mweb_url": "https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx2016121516420242444321ca0631331346&package=1405458241",
"prepay_id": "wx201411101639507cbf6ffd8b0779950874"
}
}
}
},
"authen_info": {
"a": {
"authen_type": 1,
"authen_code": "852F74DA744049B1C629056FE8E8CC7BB59C49A25546ED66C8B75F4E6475AD73"
}
}
}