微信支付的 支付数据 字段说明
字段 | 类型 | 是否必须 | 介绍 | 示例 |
---|---|---|---|---|
body | string(128) | 是 | 商品描述 | 腾讯qq币充值 |
subject | string(8192) | 是 | 商品详情 | 商品详细内容,具体参看官方文档 |
order_no | string(32) | 是 | 商户订单号必须唯一,支付后的单号不能重复使用 | XD989877d |
amount | string | 是 | 订单价格,这里需要注意微信本来是分,这里sdk进行了转化,单位为元 | 1.3 |
client_ip | string(16) | 是 | 用户端的实际真是ip地址 | 123.12.12.123 |
timeout_express | int(14) | 否 | 订单过期时间,请使用当前时间戳+过期时间秒数 | time() + 300 表示 5分钟后过期 |
return_param | string(127) | 否 | 异步通知原样返回数据,请不要使用特殊字符 | 123abcd |
该表中的字段,是每一种支付都需要的,我们称其为:基础支付数据
App支付
app支付所需要的字段均在上表,无特殊字段
公众号支付
字段 | 类型 | 是否必须 | 介绍 | 示例 |
---|---|---|---|---|
openid | string(128) | 是 | 用户在微信公众号中的唯一标示 | oUpF8uMuAJO_M2pxb1Q9zNjWeS6o |
product_id | string(32) | 否 | 商品id,商户自行定义 | abcdef001 |
刷卡支付
该支付对标支付宝的 条码支付
用户选择刷卡支付付款并打开微信,进入“我”->“钱包”->“收付款”条码界面;
收银员在商户系统操作生成支付订单,用户确认支付金额;
商户收银员用扫码设备扫描用户的条码/二维码,商户收银系统提交支付;
微信支付后台系统收到支付请求,根据验证密码规则判断是否验证用户的支付密码,不需要验证密码的交易直接发起扣款,需要验证密码的交易会弹出密码输入框。支付成功后微信端会弹出成功页面,支付失败会弹出错误提示。
字段 | 类型 | 是否必须 | 介绍 | 示例 |
---|---|---|---|---|
terminal_id | string(32) | 否 | 设备号,可为门店编号,由上级定义 | BJKY_001 |
auth_code | string(128) | 是 | 授权码,设备读取的用户微信中条码信息 | 123738478223001 |
扫码支付
⚠️ 微信文档这里写的 trade_type = JSAPI
其实写错,正确的是:trade_type = NATIVE
字段 | 类型 | 是否必须 | 介绍 | 示例 |
---|---|---|---|---|
product_id | string(32) | 是 | 商品id,商户自行定义 | abcdef001 |
openid | string(128) | 否 | 用户在微信公众号中的唯一标示 | oUpF8uMuAJO_M2pxb1Q9zNjWeS6o |
H5支付
H5支付不建议在APP端使用,如需要在APP中使用微信支付,请接APP支付
腾讯文档中标记了该方式可以放入到app的wap页中,但是如果你真的是放到wap页中,它建议你采用 app支付。这里看自己取舍。
h5支付的数据,相比基础数据,必须传入场景信息。在payment sdk中我们将其已数组方式传入,内部会将其转化为json。
它可分别应用于: wap网站、ios移动应用、android移动应用,下面分别说明
Wap网站应用
字段 | 类型 | 介绍 | 示例 |
---|---|---|---|
type | string | 场景类型,可取:Wap Android IOS | Wap |
wap_url | string | wap网站的url地址 | http://m.jiasux.com |
wap_name | string | wap网站名称 | 加速侠手游下载 |
IOS移动应用
推荐使用app支付接入
字段 | 类型 | 介绍 | 示例 |
---|---|---|---|
type | string | 场景类型,可取:Wap Android IOS | IOS |
app_name | string | 应用名称 | 加速侠 |
bundle_id | string | bundle id | com.jiasux.gamebox |
Android移动应用
推荐使用app支付接入
字段 | 类型 | 介绍 | 示例 |
---|---|---|---|
type | string | 场景类型,可取:Wap Android IOS | Android |
app_name | string | 应用名称 | 加速侠 |
package_name | string | 应用包名 | com.jiasux.gamebox |
这里需要注意,上面的三种应用场景字段,都是放在 scene_info 这个字段中,传入到sdk中。
字段 | 类型 | 是否必须 | 介绍 | 示例 |
---|---|---|---|---|
scene_info | array | 是 | 它数组内容由上面3个场景构成,根据自己需要进行设置 | [ 'type' => 'Wap', 'wap_url' => 'http://m.jiasux.com', 'wap_name' => '加速侠' ] |
小程序支付
它的开发流程与 公众号支付 一致,因此除了账号不一致,其它都是一致的。