# 1、获取支付参数

# 接口名:createPayment

# 无框架下的云函数代码示例(该写法同时也适用于任何框架)

const vkPay = require("vk-uni-pay");

exports.main = async (event, context) => {
  
  let res = await vkPay.createPayment({
    context,
    provider: "alipay",
    data: {
      openid: "用户openid,小程序支付时必传",
      out_trade_no: "必填项,商户支付订单号,需自行保证全局唯一",
      total_fee: 1, // 订单金额(单位分 100 = 1元)
      subject: "订单标题",
      type: "订单类型如recharge(充值订单)、goods(商品订单)、vip(会员订单)等。", // 此处type的值如果是goods,则回调时就会执行 pay-notify 目录下的 goods.js 内的逻辑
      // 自定义回调数据,能在回调事件获取到以下数据,回调函数中通过 let { out_trade_no, user_id, recharge_balance } = data;方式获取(不可与data内的一级属性名重复)
      custom:{
        
      },
      // 微信、支付宝文档上的其他选填参数(other内的参数会原样发送给微信、支付宝)
      other:{
      
      }
    }
  });

  return res;
};

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 请求参数

参数 说明 类型 默认值 可选值
context 云函数的context Object - -
provider wxpay:微信支付 alipay:支付宝支付 String - wxpay、alipay
isPC 如果是PC扫码支付,则设为true(使用支付组件时,组件会自动上传isPC的参数) Boolean false true
needQRcode 是否强制使用二维码支付(让顾客扫码支付,一般用于物联网,如按摩椅上的扫码支付) 查看详情 Boolean false true
data 订单数据 查看详情 Object -

# data 参数

参数 说明 类型 默认值 可选值
openid 用户openid,小程序支付和微信公众号支付时必传 String - -
out_trade_no 必填项,商户支付订单号,需自行保证全局唯一 String - -
total_fee 订单金额(单位分 100 = 1元) Number - -
subject 订单标题 String - -
type 订单类型如recharge(充值订单)、goods(商品订单)、vip(会员订单)等。 String - -
custom 自定义数据,不可与外部重复(custom内的参数不会发送给微信、支付宝) Object - -
other 微信、支付宝文档上的其他选填参数(other内的参数会原样发送给微信、支付宝) Object - -
pid 多商户模式下的自定义商户id(等于vk-pay-config表的_id)查看vk-pay-config表 (opens new window) String - -
  • out_trade_no作用: 用于根据out_trade_no查订单状态、发起退款等接口需要。
  • 同时该订单号需保证全局唯一。
  • 通常情况下,支付订单号就是你系统的订单表的订单号或订单表的_id
  • 假设你的订单号是:2107151010101541001
  • 但如果你的订单分多次付款(如预付款,尾款等,则需要分别创建不同的支付订单号,如pre2107151010101541001、due2107151010101541001,也可以是2107151010101541001-1、2107151010101541001-2)
  • 对未支付的订单再次发起支付时,商户应该使用原单号发起,不要更换支付单号,避免用户重复支付。

# 返回值

参数名 类型 说明
orderInfo object 用于发起支付的订单信息
out_trade_no string 本次交易的商户支付订单号
pay_type string 本次交易的付款方式
needQRcode boolean 本次交易的是否是扫码支付模式
qrcodeImage string 如果是扫码支付,会返回此字段,代表二维码的base64值

# pid(多商户模式)

const vkPay = require("vk-uni-pay");

exports.main = async (event, context) => {
  
  let res = await vkPay.createPayment({
    context,
    provider: "alipay",
    data: {
      pid: "001", // 使用_id为001的商户配置
      openid: "用户openid,小程序支付时必传",
      out_trade_no: "必填项,商户支付订单号,需自行保证全局唯一",
      total_fee: 1, // 订单金额(单位分 100 = 1元)
      subject: "订单标题",
      type: "订单类型如recharge(充值订单)、goods(商品订单)、vip(会员订单)等。", // 此处type的值如果是goods,则回调时就会执行 pay-notify 目录下的 goods.js 内的逻辑
      // 自定义回调数据,能在回调事件获取到以下数据,回调函数中通过 let { out_trade_no, user_id, recharge_balance } = data;方式获取(不可与data内的一级属性名重复)
      custom:{
        
      },
      // 微信、支付宝文档上的其他选填参数(other内的参数会原样发送给微信、支付宝)
      other:{
      
      }
    }
  });

  return res;
};

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# needQRcode(强制使用二维码支付模式)

给vue页面使用时,传 needQRcode:true

 const vkPay = require("vk-uni-pay");
 
 exports.main = async (event, context) => {
   
   let res = await vkPay.createPayment({
     context,
     provider: "alipay",
     needQRcode:true, // 前端页面是vue时,传true
     data: {
       openid: "用户openid,小程序支付时必传",
       out_trade_no: "必填项,商户支付订单号,需自行保证全局唯一",
       total_fee: 1, // 订单金额(单位分 100 = 1元)
       subject: "订单标题",
       type: "订单类型如recharge(充值订单)、goods(商品订单)、vip(会员订单)等。", // 此处type的值如果是goods,则回调时就会执行 pay-notify 目录下的 goods.js 内的逻辑
       // 自定义回调数据,能在回调事件获取到以下数据,回调函数中通过 let { out_trade_no, user_id, recharge_balance } = data;方式获取(不可与data内的一级属性名重复)
       custom:{
         
       },
       // 微信、支付宝文档上的其他选填参数(other内的参数会原样发送给微信、支付宝)
       other:{
       
       }
     }
   });
 
   return res;
 };
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

给nvue页面使用时,传 needQRcode:'image'

 const vkPay = require("vk-uni-pay");
 
 exports.main = async (event, context) => {
   
   let res = await vkPay.createPayment({
     context,
     provider: "alipay",
     needQRcode: "image", // 前端页面是nvue时,传 "image"
     data: {
       openid: "用户openid,小程序支付时必传",
       out_trade_no: "必填项,商户支付订单号,需自行保证全局唯一",
       total_fee: 1, // 订单金额(单位分 100 = 1元)
       subject: "订单标题",
       type: "订单类型如recharge(充值订单)、goods(商品订单)、vip(会员订单)等。", // 此处type的值如果是goods,则回调时就会执行 pay-notify 目录下的 goods.js 内的逻辑
       // 自定义回调数据,能在回调事件获取到以下数据,回调函数中通过 let { out_trade_no, user_id, recharge_balance } = data;方式获取(不可与data内的一级属性名重复)
       custom:{
         
       },
       // 微信、支付宝文档上的其他选填参数(other内的参数会原样发送给微信、支付宝)
       other:{
       
       }
     }
   });
 
   return res;
 };
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28