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

2020-09-18 14:33 更新

cloud.payment.common.refund 是通用接口的交易退款接口。

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

字段名 類型 必填 說(shuō)明
outTradeNo String 交易創(chuàng)建時(shí)傳入的商戶訂單號(hào)
refundAmount String 需要退款的金額,該金額不能大于訂單金額,單位為元,支持兩位小數(shù)
appAuthToken String 三方代調(diào)用應(yīng)用訪問(wèn)令牌,詳見(jiàn)應(yīng)用授權(quá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.common.refund({
    // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
    outTradeNo: ctx.args.outTradeNo,
    refundAmount: ctx.args.refundAmount
  });
  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.common.refund({
    // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
    outTradeNo: ctx.args.outTradeNo,
    refundAmount: ctx.args.refundAmount
  }, {
    // appAuthToken參數(shù)接收自云函數(shù)調(diào)用處傳入的參數(shù)
    appAuthToken: ctx.args.appAuthToken
  });
  return res;
};

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

alipay-serverless-sdk 版本&=1.0.0

const refundResult = await cloud.payment.common.refund({
    outTradeNo: this.data.outTradeNo,
    refundAmount: '0.01'
  });

alipay-serverless-sdk 版本<1.0.0

const refundResult = await cloud.payment.common.refund(this.data.outTradeNo, '0.01');

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

{
    "code":"10000",
    "msg":"Success",
    "trade_no":"支付寶交易號(hào)",
    "out_trade_no":"6823789339978248",
    "buyer_logon_id":"159****5620",
    "fund_change":"Y",
    "refund_fee":88.88,
    "refund_currency":"USD",
    "gmt_refund_pay":"2014-11-27 15:45:57",
    "refund_detail_item_list":[
        {
            "fund_channel":"ALIPAYACCOUNT",
            "bank_code":"CEB",
            "amount":10,
            "real_amount":11.21,
            "fund_type":"DEBIT_CARD"
        }
    ],
    "store_name":"望湘園聯(lián)洋店",
    "buyer_user_id":"2088101117955611",
    "refund_preset_paytool_list":{
        "amount":[
            12.21
        ],
        "assert_type_code":"盒馬禮品卡:HEMA;抓貓貓紅包:T_CAT_COUPON"
    },
    "refund_settlement_id":"2018101610032004620239146945",
    "present_refund_buyer_amount":"88.88",
    "present_refund_discount_amount":"88.88",
    "present_refund_mdiscount_amount":"88.88"
}
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

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

編程獅公眾號(hào)