APP 支付

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

接口描述

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

url https://pay.qcloud.com/cpay/app_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,指定不能使用信用卡支付。
pay_mch_key pay_platform - Number(32) 第三方支付类型,详见枚举 PayPlatform。
out_mch_id - String(32) 服务商对外帐号。
out_sub_mch_id - String(32) 子商户对外帐号。
out_shop_id - String(32) 门店对外帐号。
wxpay_pay_mch_key_ext mob_app_id String(32) 受理商户的 APPID,在微信开放平台绑定申请。
nonce_str - - String(32) 随机字符串。

输出参数

参数名 必填 类型 说明
response_content ResponseContent 请求内容,详见本节 ResponseContent。
authen_info AuthenInfo 认证信息,详见接口调用说明。

ResponseContent 结构

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

AppPayResponse 结构

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

WxpaySdkArguments 结构

参数名 必填 类型 说明
app_id String 子商户在微信开放平台上申请的 APPID。
timestamp String 时间戳。
nonce_str String 随机字符串。
package_value String 暂填写固定值 Sign=WXPay。
partner_id String 子商户的商户号。
sign String 签名。
prepare_id String 微信返回的支付交易会话 ID。

示例

输入参数示例:

{  
    "authen_info": {  
        "a": {  
            "authen_type": 1,  
            "authen_code": "E6E70FF7E330E046239B05E100942B15C469928B044DF6488F3BD88AB385C682"  
        }  
    },  
    "request_content": "{  
            "pay_mch_key": {  
                "out_sub_mch_id": "sz01LG0dvp4O09jjuPbA",  
                "wxpay_pay_mch_key_ext": {  
                    "mob_app_id": "wx87dd198b78jucir8"  
                },  
                "out_mch_id": "sz01fdd7icm7JKjkkfc3",  
                "out_shop_id": "sz011Zszd73bocifI9eG",  
                "pay_platform": 1,  
                "out_mch_id": "sz01MaHltuPggtcvcTUM"  
            },  
            "nonce_str": "k8s03nyOPIQxju4lw69CCfeUWL66GDBH",  
            "pay_content": {  
                "body": "body",  
                "fee_type": "CNY",  
                "out_trade_no": "011888520000211567600739877620",  
                "total_fee": 100,  
                "time_expire": 1567601636  
            }  
        }"  
}  

输出参数示例:

{  
    "response_content": "{  
            "status": 0,  
            "description": "\u64CD\u4F5C\u6210\u529F\u3002",  
            "log_id": 3637968353,  
            "internal_status": 0,  
            "app_pay": {  
                "pay_mch_key": {  
                    "pay_platform": 1,  
                    "out_mch_id": "sz01fdd7icm7JKjkkfc3",  
                    "out_sub_mch_id": "sz01LG0dvp4O09jjuPbA",  
                    "out_shop_id": "sz011Zszd73bocifI9eG",  
                    "sub_pay_platform": 100,  
                    "wxpay_pay_mch_key_ext": {  
                        "app_id": "wx0b0ebc671d51405b",  
                    }  
                },  
                "nonce_str": "zWbxyYBupz2DDIRiO9u9BsmjbAQsmnGv",  
                "sdk_args": {  
                    "wxpay": {  
                        "app_id": "wx87dd198b78jucir8",  
                        "partner_id": "257300488",  
                        "package_value": "Sign=WXPay",  
                        "nonce_str": "k8s03nyOPIQxju4lw69CCfeUWL66GDBH",  
                        "timestamp": "1567600739",  
                        "sign": "B3E62ECF398573085397AFCAE1568A8A"  
                    }  
                }  
            }  
        }",  
    "authen_info": {  
        "a": {  
            "authen_type": 1,  
            "authen_code": "852F74DA744049B1C629056FE8E8CC7BB59C49A25546ED66C8B75F4E6475AD73"  
        }  
    }  
}