H5 支付

最近更新时间:2019-10-25 17:15:12

接口描述

手机 H5 支付接口,目前仅支持微信支付。

url https://pay.qcloud.com/cpay/mob_web_pay

输入参数

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

RequestContent 结构

   
一级参数名 二级参数名 三级参数名 必填 类型 说明
pay_content out_trade_no - String(32) 由客户端生成的订单号,前缀必须是云支付订单前缀。
total_fee - Number(32) 订单总金额,单位:分。
fee_type - String 货币类型(目前只支持人民币,请填 CNY)。
time_expire - Number(64) 订单过期时间。
caller_notify_url - String 商户指定的支付结果回调 URL。
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"   
        }    
    }    
}