-
1、接口介绍
商户系统先调用该接口在快接支付服务后台生成预支付交易订单,再按扫码、H5等不同场景发起支付
支付方式 接口请求地址 微信扫码支付 http://商户后台查看/wechat/scan_pay 微信WAP(H5支付) http://商户后台查看/wechat/wap_pay 微信WAP(H5支付)线上 http://商户后台查看/wechat/online_wap_pay 微信APP支付 http://商户后台查看/wechat/app_pay 微信公众号支付 http://商户后台查看/wechat/public_pay 微信公众号支付线上 http://商户后台查看/wechat/online_public_pay 微信扫码支付线上 http://商户后台查看/wechat/online_scan_pay 微信小程序支付 http://商户后台查看/wechat/mini_pay 微信小程序支付线上 http://商户后台查看/wechat/online_mini_pay 微信被扫支付 http://商户后台查看/wechat/micropay -
2、请求参数
序号 请求参数 是否必填 类型 最大长度 描述 示范值 1 agent_no 否 String 20 代理商号(商户类型为代理时,必传,快接平台分配给接入代理商唯一的编号,请登录代理后台代理中心查看 201857831440477 2 merchant_no 是 String 20 快接平台分配的唯一商户号 2017092012 3 merchant_order_no 是 String 35 商户订单号 201709191749201232asdas 4 notify_url 是 String 100 通知地址 http://www.kj-pay.com/ 5 start_time 是 String 14 订单开始时间(格式为yyyyMMddHHmmss) 20171028100150 6 trade_amount 是 String 11 交易金额 单位为元,精确到小数点后两位,取值 0.01 7 goods_name 是 String 50 商品名称 测试商品 8 goods_desc 是 String 100 商品描述 test 9 return_url 否 String 100 同步跳转地址(需要同步跳转时,请确保该值为正确地址,并且pay_mode值必须为2) http://www.kj-pay.com/ 10 app_no 否 String 35 应用编号(可在商户中心->应用管理->应用信息 处选择该订单所属应用编号) 201710231452342219 11 attach 否 String 255 业务扩展参数,该参数异步通知时原样返回,不填则不返回 1 12 user_ip 否 String 15 IP地址,H5必填参数 Ip获取方式参考地址 https://pay.weixin.qq.com/wiki/doc/api/H5.php?chapter=15_5 13 pay_sence 否 String 255 支付场景,H5必填参数 苹果传示例值1,安卓传示例值2,Wap端传示例值3,注意参数值部分替换成自己的 1、{"type":"IOS","bundle_id":"com.tencent.wzryIOS","app_name":"王者荣耀"} 2、{"type":"Android","app_name": "王者荣耀","package_name": "com.tencent.tmgp.sgame"} 3、{"type":"Wap","wap_url": "http://www.kj-pay.com","wap_name": "快接支付"} 14 pay_type 否 String 1 返回支付参数类型(默认值为0,类型0:base64二维码图,1:二维码图片渲染页,2:纯二维码图片,3:支付链接 ) 1 15 receivers 否 String 2048 分账接收方列表(JSON类型的字符串),需走分账业务并需要传分账接收方的必填;注:下方带└符号参数表示为该参数中的数据;订单无需分账时receivers不传即可 分账接收方列表 不超过49个 json对象 示例值、 [{"type":"PERSONAL_OPENID","account":"oSepO0vHk3uvhdRrdjEbygdUTprA","name":"张三", "amount":"0.01", "description":"分到个人"}] 16 └ type 是 String 32 分账接收方类型 1、MERCHANT_ID-商户ID 2、PERSONAL_OPENID-(商户后台->交易分账管理->微信openID可得到) 3、PERSONAL_SUB_OPENID-个人sub_openid(由子商户APPID转换得到) PERSONAL_OPENID 17 └ account 是 String 64 分账接收方帐号 1、类型是MERCHANT_ID时,是商户ID (联系客服获取) 2、类型是PERSONAL_OPENID时,是openid(商户后台可得) 3、类型是PERSONAL_SUB_OPENID时,是个人sub_openid(由子商户APPID转换得到) oSepO0vHk3uvhdRrdjEbygdUTprA 18 └ name 是 String 1024 分账接收方全称 1、分账接收方类型是MERCHANT_ID时,是商户全称(联系客服获取) 2、分账接收方类型是PERSONAL_OPENID或PERSONAL_SUB_OPENID 时,是个人姓名 张三 19 └ amount 是 String 11 交易金额 单位为元,不能超过原订单支付金额及最大分账比例金额。精确到小数点后两位,取值范围[0.01,100000000] 0.01 20 └ description 是 String 80 分账描述 分给商户A 21 open_id 否 String 28 微信公众号可传该字段,则openid由用户自行产生,快接平台将不进行微信网页授权回调 ocbthxP77MfGj0p11r-4RUbb1nKM 22 auth_code 否 String 80 付款码数字,微信被扫支付必须 131563858867504301 23 terminal_id 否 String 50 终端设备号,微信被扫支付必须 D00000XXX 24 sign_type 是 String 1 签名类型(1->md5) 1 25 sign 是 String 32 签名 88772a091467bc0fa4790bcad0b1ee69 微信官方通道receivers参数
序号 请求参数 是否必填 类型 最大长度 描述 示范值 1 └ type 是 String 32 分账接收方类型 1、MERCHANT_ID-商户ID 2、PERSONAL_OPENID-(商户后台->交易分账管理->微信openID可得到) 3、PERSONAL_SUB_OPENID-个人sub_openid(由子商户APPID转换得到) PERSONAL_OPENID 2 └account 是 String 11 分账接收方帐号 1、类型是MERCHANT_ID时,是商户ID (联系客服获取) 2、类型是PERSONAL_OPENID时,是openid(商户后台可得) 3、类型是PERSONAL_SUB_OPENID时,是个人sub_openid(由子商户APPID转换得到) oSepO0vHk3uvhdRrdjEbygdUTprA 3 └ name 是 String 1024 分账接收方全称 1、分账接收方类型是MERCHANT_ID时,是商户全称(联系客服获取) 2、分账接收方类型是PERSONAL_OPENID或PERSONAL_SUB_OPENID 时,是个人姓名 张三 4 └ amount 是 String 11 交易金额 单位为元,不能超过原订单支付金额及最大分账比例金额。精确到小数点后两位,取值范围[0.01,100000000] 0.01 5 └ description 是 String 80 分账描述 分账给商户A 非微信官方通道receivers参数——单次实时分账
序号 请求参数 是否必填 类型 最大长度 描述 示范值 1 member_id 是 String 11 分账接收方用户标识,通过快接商务入驻获取 20040801 2 amount 是 String 10 分账金额,精确到小数点后两位;分账总额不得大于订单结算金额,未分账金额将结算至交易商户结算账户 0.01 -
3、响应参数
序号 返回参数 是否必填 字段类型 描述 1 data 是 String json数据 2 └ trade_no 是 String 交易订单号 3 └ pay_url 否 String 支付链接 4 └ image 否 String 二维码图片数据串,扫码支付返回的是image,其他默认都是pay_url 5 └ sign 是 String 签名 6 info 是 String 描述 7 status 是 String 返回码 示例:1 接口请求成功; 99 接口请求失败; 30 响应验签失败