支付寶小程序Serverless 支付能力API·cloud.payment.faceToFace.pay

2020-09-18 14:33 更新

cloud.payment.faceToFace.pay 是當(dāng)面付的當(dāng)面付交易付款接口。

使用該API前,請(qǐng)確認(rèn)你的小程序應(yīng)用已經(jīng)添加 當(dāng)面付 功能

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

字段名 類(lèi)型 必填 說(shuō)明
subject String 訂單標(biāo)題
outTradeNo String 交易創(chuàng)建時(shí)傳入的商戶訂單號(hào)
totalAmount String 訂單總金額,單位為元,精確到小數(shù)點(diǎn)后兩位,取值范圍[0.01,100000000]
authCode String 支付授權(quán)碼,25~30開(kāi)頭的長(zhǎng)度為16~24位的數(shù)字,實(shí)際字符串長(zhǎng)度以開(kāi)發(fā)者獲取的付款碼長(zhǎng)度為準(zhǔn)
notify_url String 支付寶服務(wù)器主動(dòng)通知商戶服務(wù)器里指定的頁(yè)面http/https路徑,也可以是云函數(shù)的http觸發(fā)路徑。
appAuthToken String 三方代調(diào)用應(yīng)用訪問(wèn)令牌,目前僅在云函數(shù)中調(diào)用支持。

調(diào)用示例

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

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

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

// 云函數(shù)中使用云調(diào)用無(wú)需引入其他依賴,只需要使用ctx.cloud調(diào)用
module.exports = async function (ctx) {
  const res = await ctx.cloud.payment.faceToFace.pay({
    // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
    subject: ctx.args.subject,
    outTradeNo: ctx.args.outTradeNo,
    totalAmount: ctx.args.totalAmount,
    authCode: ctx.args.authCode
  }, {
    // 傳入接收支付寶服務(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ú)需引入其他依賴,只需要使用ctx.cloud調(diào)用
module.exports = async function (ctx) {
  const res = await ctx.cloud.payment.faceToFace.pay({
    // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
    subject: ctx.args.subject,
    outTradeNo: ctx.args.outTradeNo,
    totalAmount: ctx.args.totalAmount,
    authCode: ctx.args.authCode
   }, {    // appAuthToken參數(shù)接收自云函數(shù)調(diào)用處傳入的參數(shù)
    appAuthToken: ctx.args.appAuthToken
  });
  return res;
};

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

alipay-serverless-sdk 版本&=1.0.0

const payRes = await cloud.payment.faceToFace.pay({
    subject: '小程序Serverless支付測(cè)試',
    outTradeNo: "demo" + new Date().getTime(),
    totalAmount: '0.01',
    authCode: '286532211313197763'
  });

alipay-serverless-sdk 版本<1.0.0

const payResult = await cloud.payment.faceToFace.pay('小程序Serverless支付測(cè)試', this.data.outTradeNo, '0.01', '286532211313197763');

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

{
    "code":"10000",
    "msg":"Success",
    "trade_no":"2013112011001004330000121536",
    "out_trade_no":"6823789339978248",
    "buyer_logon_id":"159****5620",
    "settle_amount":"88.88",
    "pay_currency":"CNY",
    "pay_amount":"580.04",
    "settle_trans_rate":"1",
    "trans_pay_rate":"6.5261",
    "total_amount":120.88,
    "trans_currency":"USD",
    "settle_currency":"USD",
    "receipt_amount":"88.88",
    "buyer_pay_amount":8.88,
    "point_amount":8.12,
    "invoice_amount":12.5,
    "gmt_payment":"2014-11-27 15:45:57",
    "fund_bill_list":[
        {
            "fund_channel":"ALIPAYACCOUNT",
            "amount":10,
            "real_amount":11.21
        }
    ],
    "card_balance":98.23,
    "store_name":"證大五道口店",
    "buyer_user_id":"2088101117955611",
    "discount_goods_detail":"[{"goods_id":"STANDARD1026181538","goods_name":"雪碧","discount_amount":"100.00","voucher_id":"2015102600073002039000002D5O"}]",
    "voucher_detail_list":[
        {
            "id":"2015102600073002039000002D5O",
            "name":"XX超市5折優(yōu)惠",
            "type":"ALIPAY_FIX_VOUCHER",
            "amount":10,
            "merchant_contribute":9,
            "other_contribute":1,
            "memo":"學(xué)生專用優(yōu)惠",
            "template_id":"20171030000730015359000EMZP0",
            "purchase_buyer_contribute":2.01,
            "purchase_merchant_contribute":1.03,
            "purchase_ant_contribute":0.82
        }
    ],
    "advance_amount":"88.8",
    "auth_trade_pay_mode":"CREDIT_PREAUTH_PAY",
    "charge_amount":"8.88",
    "charge_flags":"bluesea_1",
    "settlement_id":"2018101610032004620239146945",
    "business_params":"{"data":"123"}",
    "buyer_user_type":"PRIVATE",
    "mdiscount_amount":"88.88",
    "discount_amount":"88.88",
    "buyer_user_name":"菜鳥(niǎo)網(wǎng)絡(luò)有限公司"
}
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

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

編程獅公眾號(hào)