支付寶小程序Serverless 資金能力API·cloud.fund.b2cRedPacket.send

2020-09-18 14:34 更新

cloud.fund.b2cRedPacket.send 是商家發(fā)放現(xiàn)金紅包給用戶接口,提供通過API接口完成企業(yè)自身支付寶賬戶到用戶支付寶賬戶的轉(zhuǎn)賬功能。

使用該API前,請確認你的小程序應用已經(jīng)添加 現(xiàn)金紅包 功能

入?yún)⒄f明

字段名 類型 必填 說明
outBizNo String 商戶端的唯一訂單號,對于同一筆轉(zhuǎn)賬請求,商戶需保證該訂單號唯一。
transAmount String 訂單總金額,單位為元,精確到小數(shù)點后兩位,取值范圍[0.01,100000000]。
payee PayeeInfo 收款方信息。詳細字段見下面PayeeInfo對象說明。
orderTitle String 轉(zhuǎn)賬業(yè)務(wù)的標題,用于在支付寶用戶的賬單里顯示。

PayeeInfo 對象說明

字段名 類型 必填 說明
identity String 參與方的唯一標識。
identity_type String 參與方的標識類型,目前支持如下類型:1、ALIPAY_USER_ID 支付寶的會員ID 2、ALIPAY_LOGON_ID:支付寶登錄號,支持郵箱和手機號格式。
name String 參與方真實姓名,如果非空,將校驗收款支付寶賬號姓名一致性。當identity_type=ALIPAY_LOGON_ID時,本字段必填。

調(diào)用示例

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

// 云函數(shù)中使用云調(diào)用無需引入其他依賴,只需要使用ctx.cloud調(diào)用
module.exports = async function (ctx) {
  let payeeInfo = new Object({
    identity: this.data.payeeId,
    identity_type: 'ALIPAY_USER_ID'
  });
  const res = await ctx.cloud.fund.b2cRedPacket.send({
    // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
    outBizNo: ctx.args.outBizNo,
    transAmount: ctx.args.transAmount,
    payee: payeeInfo,
    orderTitle: ctx.args.orderTitle
  });
  return res;
};

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

// 云函數(shù)中使用云調(diào)用無需引入其他依賴,只需要使用ctx.cloud調(diào)用
module.exports = async function (ctx) {
  let payeeInfo = new Object({
    identity: this.data.payeeId,
    identity_type: 'ALIPAY_USER_ID'
  });
  const res = await ctx.cloud.fund.b2cRedPacket.send({
    // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
    outBizNo: ctx.args.outBizNo,
    transAmount: ctx.args.transAmount,
    payee: payeeInfo,
    orderTitle: ctx.args.orderTitle
  }, {
    // appAuthToken參數(shù)接收自云函數(shù)調(diào)用處傳入的參數(shù)
    appAuthToken: ctx.args.appAuthToken
  });
  return res;
};

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

alipay-serverless-sdk 版本&=1.0.0

var payee = new Object({
  identity: this.data.payeeId,
  identity_type: 'ALIPAY_USER_ID'
});
const res = await cloud.fund.b2cRedPacket.send({
    outBizNo: '2077353455543433',
    transAmount: '0.01',
    payee: payeeInfo,
    orderTitle: '測試'
  });

alipay-serverless-sdk 版本<1.0.0

var payee = new Object({
  identity: this.data.payeeId,
  identity_type: 'ALIPAY_USER_ID'
});
const res = await cloud.fund.b2cRedPacket.send(generateOutBizNo(), '0.01', payee, '測試');

返回數(shù)據(jù)示例

{
    "code":"10000",
    "msg":"Success",
    "out_biz_no":"201808080001",
    "order_id":"20190801110070000006380000250621",
    "pay_fund_order_id":"20190801110070001506380000251556",
    "status":"SUCCESS",
    "trans_date":"2019-08-21 00:00:00"
}
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號