支付寶小程序Serverless 支付能力API·cloud.payment.common.create

2020-09-18 14:33 更新

cloud.payment.common.create 是通用接口的創(chuàng)建交易 接口。

入?yún)⒄f(shuō)明

字段名 類(lèi)型 必填 說(shuō)明
subject String 訂單標(biāo)題
outTradeNo String 商戶(hù)訂單號(hào),64個(gè)字符以?xún)?nèi),可包含字母、數(shù)字、下劃線(xiàn),需保證在商戶(hù)端不重復(fù)
totalAmount String 訂單總金額,單位為元,精確到小數(shù)點(diǎn)后兩位,取值范圍[0.01,100000000]
buyerId String 買(mǎi)家的支付寶用戶(hù)ID,如果為空,會(huì)從傳入的碼值信息中獲取買(mǎi)家ID
notify_url String 支付寶服務(wù)器主動(dòng)通知商戶(hù)服務(wù)器里指定的頁(yè)面http/https路徑,也可以是云函數(shù)的http觸發(fā)路徑。
appAuthToken String 三方代調(diào)用應(yīng)用訪(fǎng)問(wèn)令牌,目前僅在云函數(shù)中調(diào)用支持。

調(diào)用示例

在云函數(shù)中調(diào)用

// 云函數(shù)中使用云調(diào)用無(wú)需引入其他依賴(lài),只需要使用ctx.cloud調(diào)用
module.exports = async function (ctx) {
  const res = await ctx.cloud.payment.common.create({
    // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
    subject: ctx.args.subject,
    outTradeNo: ctx.args.outTradeNo,
    totalAmount: ctx.args.totalAmount,
    buyerId: ctx.args.buyerId
  });
  return res;
};

支持傳入notifyUrl接收支付寶服務(wù)器交易通知

// 云函數(shù)中使用云調(diào)用無(wú)需引入其他依賴(lài),只需要使用ctx.cloud調(diào)用
module.exports = async function (ctx) {
  const res = await ctx.cloud.payment.common.create({
    // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
    subject: ctx.args.subject,
    outTradeNo: ctx.args.outTradeNo,
    totalAmount: ctx.args.totalAmount,
    buyerId: ctx.args.buyerId
  }, {
    // 傳入接收支付寶服務(wù)器交易通知的http/https路徑,也可以是云函數(shù)的http觸發(fā)路徑
    notify: {
        url: 'http://api.test.alipay.net/atinterface/receive_notify.htm'
    }
  });
  return res;
};

支持傳入appAuthToken進(jìn)行三方代調(diào)用

// 云函數(shù)中使用云調(diào)用無(wú)需引入其他依賴(lài),只需要使用ctx.cloud調(diào)用
module.exports = async function (ctx) {
  const res = await ctx.cloud.payment.common.create({
    // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
    subject: ctx.args.subject,
    outTradeNo: ctx.args.outTradeNo,
    totalAmount: ctx.args.totalAmount,
    buyerId: ctx.args.buyerId
  }, {
    // appAuthToken參數(shù)接收自云函數(shù)調(diào)用處傳入的參數(shù)
    appAuthToken: ctx.args.appAuthToken
  });
  return res;
};

在小程序頁(yè)面調(diào)用

alipay-serverless-sdk 版本&=1.0.0

const createRes = await cloud.payment.common.create({
    subject: '小程序Serverless支付測(cè)試',
    outTradeNo: "demo" + new Date().getTime(),
    totalAmount: '0.01',
    buyerId: '2088202286335281'
  });

alipay-serverless-sdk 版本<1.0.0

const createRes = await cloud.payment.common.create('小程序Serverless支付測(cè)試', "demo" + new Date().getTime(), '0.01', '2088202286335281');

返回?cái)?shù)據(jù)示例

{
    "code":"10000",
    "msg":"Success",
    "out_trade_no":"20150423001001",
    "trade_no":"2015042321001004720200028594"
}
以上內(nèi)容是否對(duì)您有幫助:
在線(xiàn)筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)