# dcb.requestPayment

发起支付。

# 参数

属性 类型 默认值 必填 说明 最低版本
provider

wechat | alipay | native

支付服务提供商。

  • wechat: 微信支付
  • alipay: 支付宝
  • native: 多彩宝客户端

注意: wechatalipay 适用于自行实现支付页面的业务,native 适用于直接使用客户端支付页面的业务,若无特殊需求,直接使用 native 即可。

params

Object

支付参数。一般直接传入后端返回的参数即可。params 中的金额,需传入字符串,避免跨端传输出现精度缺失问题

showNativeResultPage

boolean

false

支付结束后是否展示原生结果页。

providernative 时生效。

# 返回值

属性 类型 说明 最低版本
orderParams

string

支付链接 TV 专用

TV-7.1.3
orderNo

string

订单编号 TV 专用

TV-7.1.3

# 示例

// 微信支付
await dcb.requestPayment({
  provider: 'wechat',
  params: {
    type: '06', // 业务类型

    areaCode: '100000', // 区划代码(不传则默认 10000,代表全国)

    consNo: '18108153387', // 水电燃业务时传户号,其他业务传手机号、身份证号等

    orgCode: '0601000', // 机构号
    unitOrgCode: '0601001', // 子机构号
    unitOrgName: '话费充值', // 子机构名称

    amt: '30.00', // 应付金额(元),支持最多两位小数,需传入字符串, 避免跨端传输出现精度缺失问题
    discountedAmt: '0.00', // 优惠金额(元),支持最多两位小数,需传入字符串, 避免跨端传输出现精度缺失问题
    payAmt: '30.00', // 实付金额(元),等于应付金额减去优惠金额,支持最多两位小数,需传入字符串, 避免跨端传输出现精度缺失问题

    goodsList: [
      {
        id: 'aaaxxxx', // 多多仓库资源 ID
        name: '话费充值 10 元', // 商品名称
        price: 30, // 单价(元)
        count: 1, // 商品件数
        totalAmt: '30.00', // 总价(元)
      },
    ],
  },
});

// 支付宝
await dcb.requestPayment({
  provider: 'alipay',
  params: {
    type: '06', // 业务类型

    areaCode: '100000', // 区划代码(不传则默认 10000,代表全国)

    consNo: '18108153387', // 水电燃业务时传户号,其他业务传手机号、身份证号等

    orgCode: '0601000', // 机构号
    unitOrgCode: '0601001', // 子机构号
    unitOrgName: '话费充值', // 子机构名称

    amt: '30.00', // 应付金额(元),支持最多两位小数,需传入字符串, 避免跨端传输出现精度缺失问题
    discountedAmt: '0.00', // 优惠金额(元),支持最多两位小数,需传入字符串, 避免跨端传输出现精度缺失问题
    payAmt: '30.00', // 实付金额(元),等于应付金额减去优惠金额,支持最多两位小数,需传入字符串, 避免跨端传输出现精度缺失问题

    goodsList: [
      {
        id: 'aaaxxxx', // 多多仓库资源 ID
        name: '话费充值 10 元', // 商品名称
        price: 30, // 单价(元)
        count: 1, // 商品件数
        totalAmt: '30.00', // 总价(元)
      },
    ],
  },
});

// 多彩宝客户端
await dcb.requestPayment({
  provider: 'native',
  params: {
    type: '06', // 业务类型

    areaCode: '100000', // 区划代码(不传则默认 10000,代表全国)

    consNo: '18108153387', // 水电燃业务时传户号,其他业务传手机号、身份证号等

    orgCode: '0601000', // 机构号
    unitOrgCode: '0601001', // 子机构号
    unitOrgName: '话费充值', // 子机构名称

    amt: '30.00', // 应付金额(元), 支持最多两位小数, 需传入字符串, 避免跨端传输出现精度缺失问题
    discountedAmt: '0.00', // 优惠金额(元),支持最多两位小数,需传入字符串, 避免跨端传输出现精度缺失问题
    couponId: 'xxxxx', // 优惠券id 传入后则使用优惠券并减掉相应的优惠金额
    payAmt: '30.00', // 实付金额(元),等于应付金额减去优惠金额,支持最多两位小数,需传入字符串, 避免跨端传输出现精度缺失问题

    goodsList: [
      {
        id: 'aaaxxxx', // 多多仓库资源 ID
        name: '话费充值 10 元', // 商品名称
        price: 30, // 单价(元)
        count: 1, // 商品件数
        totalAmt: '30.00', // 总价(元)
      },
    ],
  },
});

# 贡献者

上次更新时间: 8/8/2022, 3:29:00 PM