# GlobalPayment

全球收银对象 GlobalPayment

# 属性

# string methodKey

初始值为null。当开发者调用 openMethodPicker 用户选中具体支付方式后确定,后续不再改变。

// 测试环境
const payment = wx.createGlobalPayment({ mchRegion: 'SG', isSandbox: true })

const goods = {
  goods_id: `goods_1`,
  goods_name: `拿铁`,
  goods_unit_price: {
    currency: 'SGD',
    total: 10,
  },
  goods_quantity: '1',
  goods_category: '1',
}

try {
  const pickerResp = await payment.openMethodPicker({
    amount: goods.goods_unit_price,
  })

  console.log(`openMethodPicker resp: `, pickerResp)

  if (pickerResp.methodKey === 'WECHAT_PAY') {
    // 发起微信支付逻辑
  } else {
    // 后台接口发起预下单
    const preOrderResp = await preOrder(
      goods.goods_unit_price,
      [goods],
      pickerResp.methodKey
    )

    console.log(`preOrder resp: `, preOrderResp)

    const { payment_id, prepay_info } = preOrderResp

    const requestPaymentResp = await payment.requestGlobalPayment({
      paymentId: payment_id,
      prepayInfo: prepay_info,
    })

    console.log(`requestGlobalPayment resp: `, requestPaymentResp)
  }
} catch (error) {
  console.log(error)
  this.setData({
    res: error.errMsg,
  })
}

# 方法

# Promise GlobalPayment.openMethodPicker(Object object)

拉起全球收银的支付方式选择面板。当用户选择支付方式或者关闭选择面板后,返回相应结果。 当用户选定支付方式后,globalPayment上的属性 methodKey 也会更新,后续该对象再次调用将直接失败,不再拉起选择面板。 若用户选择微信支付,请开发者按原微信支付接口 wx.requestPayment 调用完成后续支付流程。 若用户选择TPG的支付方式,流程会等待开发者前往TPG完成预下单后,携带预支付信息和交易单号调用 requestGlobalPayment,若开发者超时未调用,则会提示用户加载超时(超时时间暂定为30s)。 当用户关闭选择面板,即未选择支付方式,开发者后续仍可继续调用接口拉起支付方式选择面板。

# Promise GlobalPayment.requestGlobalPayment(Object object)

开发者调用 openMethodPicker 并在返回值 methodKey 中接受到用户选择了TPG的支付方式后,可调用此接口接入TPG的支付流程。 当用户已成功完成当前订单支付后,再次调用该对象的 requestGlobalPayment 会失败。即每次支付都需创建新的 globalPayment 对象重走流程。 仅在 methodKey 为TPG支付类型才能进入全球收银的支付流程,其他情况会失败。 建议在接口返回后,不论成功或失败,均通过 TPG 接口 inquiry-payment 对订单状态进行查询。

# Promise GlobalPayment.abort()

用户选择TPG的支付方式,界面会进入加载的Toast,等待开发者前往TPG完成预下单后携带预支付信息和交易单号调用 requestGlobalPayment,若开发者在 TPG预下单未成功或出现异常情况,可调用该接口主动终止TPG支付流程,界面加载的Toast将会隐藏,提示用户下单失败。