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

2020-09-18 14:33 更新

cloud.fund.transferBankcard.transfer 是單筆轉(zhuǎn)賬到銀行卡接口,提供通過(guò)API接口完成企業(yè)自身支付寶賬戶到銀行卡的轉(zhuǎn)賬功能。

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

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

PayeeInfo 對(duì)象說(shuō)明

字段名 類型 必填 說(shuō)明
identity String 參與方的唯一標(biāo)識(shí)。
identity_type String 參與方的標(biāo)識(shí)類型,目前支持如下類型:1、ALIPAY_USER_ID 支付寶的會(huì)員ID 2、ALIPAY_LOGON_ID:支付寶登錄號(hào),支持郵箱和手機(jī)號(hào)格式。
name String 參與方真實(shí)姓名,如果非空,將校驗(yàn)收款支付寶賬號(hào)姓名一致性。當(dāng)identity_type=ALIPAY_LOGON_ID時(shí),本字段必填。

調(diào)用示例

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

  1. // 云函數(shù)中使用云調(diào)用無(wú)需引入其他依賴,只需要使用ctx.cloud調(diào)用
  2. module.exports = async function (ctx) {
  3. let payeeInfo = new Object({
  4. identity: this.data.payeeId,
  5. identity_type: 'ALIPAY_USER_ID'
  6. });
  7. const res = await ctx.cloud.fund.transferBankcard.transfer({
  8. // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
  9. outBizNo: ctx.args.outBizNo,
  10. transAmount: ctx.args.transAmount,
  11. payee: payeeInfo,
  12. orderTitle: ctx.args.orderTitle
  13. });
  14. return res;
  15. };

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

  1. // 云函數(shù)中使用云調(diào)用無(wú)需引入其他依賴,只需要使用ctx.cloud調(diào)用
  2. module.exports = async function (ctx) {
  3. let payeeInfo = new Object({
  4. identity: this.data.payeeId,
  5. identity_type: 'ALIPAY_USER_ID'
  6. });
  7. const res = await ctx.cloud.fund.transferBankcard.transfer({
  8. // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
  9. outBizNo: ctx.args.outBizNo,
  10. transAmount: ctx.args.transAmount,
  11. payee: payeeInfo,
  12. orderTitle: ctx.args.orderTitle
  13. }, {
  14. // appAuthToken參數(shù)接收自云函數(shù)調(diào)用處傳入的參數(shù)
  15. appAuthToken: ctx.args.appAuthToken
  16. });
  17. return res;
  18. };

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

alipay-serverless-sdk 版本&=1.0.0

  1. var payee = new Object({
  2. identity: this.data.payeeId,
  3. identity_type: 'ALIPAY_USER_ID'
  4. });
  5. const res = await cloud.fund.transferBankcard.transfer({
  6. outBizNo: '2077353455543433',
  7. transAmount: '0.01',
  8. payee: payeeInfo,
  9. orderTitle: '測(cè)試'
  10. });

alipay-serverless-sdk 版本<1.0.0

  1. var payee = new Object({
  2. identity: this.data.payeeId,
  3. identity_type: 'ALIPAY_USER_ID'
  4. });
  5. const res = await cloud.fund.transferBankcard.transfer(generateOutBizNo(), '0.01', payee, '測(cè)試');

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

  1. {
  2. "code":"10000",
  3. "msg":"Success",
  4. "out_biz_no":"201808080001",
  5. "order_id":"20190801110070000006380000250621",
  6. "pay_fund_order_id":"20190801110070001506380000251556",
  7. "status":"SUCCESS",
  8. "trans_date":"2019-08-21 00:00:00"
  9. }
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

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

編程獅公眾號(hào)