跳到主要内容

扫码支付

二维码支付包括两种模式：

MPM模式（商户展示二维码）​

在MPM模式下，商户生成并展示二维码，顾客使用其移动钱包APP扫描该二维码以完成支付。具体流程如下：

  1. 商户系统向PayCloud提交订单支付请求。
  2. PayCloud处理支付请求，并将移动钱包系统生成的二维码返回给商户系统。
  3. 商户系统显示二维码。
  4. 顾客使用移动钱包APP扫描二维码并完成支付。
  5. 商户系统接收到支付结果通知，随即更新订单状态，提示商户可以交付商品或服务。
扫码支付MPM模式（商户展示二维码 ）流程图

扫码支付MPM模式（商户展示二维码 ）使用案例示意图

CPM模式（顾客展示二维码）​

在CPM模式下，顾客生成并展示其移动钱包中的二维码，商户使用扫码设备扫描该二维码以完成支付。具体流程如下：

  1. 顾客在其移动钱包APP中生成二维码。
  2. 商户使用扫码设备扫描顾客的二维码。
  3. 商户系统将扫描到的二维码信息传递给PayCloud进行支付处理。
  4. PayCloud处理支付请求并获得钱包系统返回的交易结果后，向商户系统发送交易结果通知。
  5. 商户系统接收支付结果通知，更新订单状态，商户向顾客交付商品或服务。
扫码支付CPM模式（顾客展示二维码）流程图

扫码支付CPM模式（顾客展示二维码）使用案例示意图

开发指南​

API列表​

下表列出了二维码支付相关的API。

API名称 说明
MPM模式-获取收款二维码通过此API提交付款订单以获取付款的二维码
CPM模式-提交付款请求通过本接口提交付款码支付订单
取消订单通过此api关闭未付款订单，如果已经付款，则向用户退款
提交退款申请如果您通过此API提交退款请求，但退款没有立即到达，您可以调用退款查询API来获取退款的进度。
查询支付订单通过该API查询正向交易订单的交易结果（消费/预授权/预授权完成）
查询退款订单通过此API查询退款交易订单（消费取消/预授权取消/消费退款/预授权完成退款）的交易结果
交易结果通知交易完成后，通知商家，告知商家交易结果

快速集成SDK​

为了简化集成过程，我们也提供了一些语言的SDK或Demo（参见SDK/Demo章节）。该SDK通过处理大部分必要的功能，使二维码支付流程的实现变得更加简单。

注意事项​

CPM模式注意事项​

在 CPM 模式 下，我们不会自动识别二维码的具体付款方式。由于某些支付方式的付款码规则未公开或与其他钱包应用存在冲突，我们无法做自动识别，所以需要由商户开发方自行识别。为确保准确处理，建议按照以下步骤操作：

  1. 使用摄像头或条码读取设备扫描二维码或条形码，获取其中的数字或字符串内容。

  2. 利用正则表达式对付款码进行自动匹配。我们支持的付款方式及其对应的正则表达式如下：

支付方式付款码正则表达式

  1. 如果无法自动识别付款方式，可在页面上提供选项，供用户人工选择。

  2. 将扫描到的内容与识别出的付款方式，通过参数 auth_code 和 pay_method_id 一并传递至我们的 API。