Skip to content

支付方式与调起 ​

渠道与支付方式 ​

统一下单传 wayCode,网关按商户应用的支付通道配置选择 ifCode。不要通过下单指定其他商户或渠道账户。

ifCode已实现 wayCode场景参数
alipayALI_QR、ALI_BAR、ALI_JSAPI、ALI_APP、ALI_WAP、ALI_PC条码需 authCode,JSAPI 需 buyerUserId
alipayzftALI_QR、ALI_BAR、ALI_JSAPI、ALI_APP、ALI_WAP、ALI_PC同上;使用已配置的直付通身份
wxpaysftWX_NATIVE、WX_JSAPI、WX_LITE、WX_APP、WX_H5JSAPI / 小程序需 openid;小程序需配置对应 AppID
globetapALI_QR、WX_NATIVE动态二维码;支付宝开放 API 可返回 Scheme
jeepayplusALI_QR、ALI_BAR、ALI_JSAPI、ALI_APP、ALI_WAP、ALI_PC、WX_BAR、WX_JSAPI、WX_LITE、WX_APP、WX_H5、WX_NATIVE条码需 authCode,JSAPI 需对应钱包身份
聚合方式QR_CASHIER候选 ALI_QR、WX_NATIVE、ALI_WAP、WX_H5、ALI_JSAPI、WX_JSAPI,至少开通一个可用项
自动识别条码AUTO_BAR根据 authCode 识别方式,识别后仍要求渠道实际支持该方式

当前微信收付通未实现 WX_BAR,不能因为 AUTO_BAR 识别出微信条码就认为可用。字典存在某支付方式也不等于应用已开通该方式。

渠道扩展参数推荐作为 JSON 字符串发送:

json
{ "channelExtra": "{\"buyerUserId\":\"2088_DEMO\"}" }

微信 JSAPI 示例为 {"openid":"OPENID_DEMO"}。参数标识必须与该通道绑定的公众号、小程序或支付宝应用一致。H5 的场景信息、客户端 IP 等按实际渠道要求提供,不能把微信和支付宝扩展字段混用。

payDataType ​

值客户端处理
codeUrl将 payData 原始内容生成二维码;商户端收银台测试链接也可用此类型
payurl跳转至 payData 指定地址;开放 API 的 QR_CASHIER 返回此类型
form渲染可信支付响应中的表单并提交
wxapp交给微信对应 SDK / Bridge 调起
aliapp交给支付宝对应 SDK / Bridge 调起
codeImgUrl展示二维码图片地址或受支持的图片数据,以实际返回为准
none无需调起参数,继续检查订单状态

payData 的具体形态由渠道和支付产品决定,可能为字符串或调起参数;保持原值传给对应支付工具,不能假定所有方式都是 URL。

客户端支付结束后通过服务端查询或验签通知确认资金结果,客户端提示只用于交互展示。

如何选择 ​

  • 需要用户选支付方式:优先 QR_CASHIER。
  • 自行展示扫码:选择应用开通的 ALI_QR / WX_NATIVE,按实际返回类型展示。
  • 钱包内支付:对应 JSAPI,并完成产品要求的身份获取。
  • 普通浏览器:H5 / WAP 需开通,不能把 JSAPI 当作普通 URL。
  • App / 小程序:SDK 与渠道 AppID 匹配,按具体产品处理调起参数。

表中是代码实现范围,不代表每个部署、商户或产品均已开通。

接口行为以当前 payment 实现为准。示例商户号与密钥均为虚构。