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

2020-09-18 14:33 更新

cloud.payment.faceToFace.pay 是当面付的当面付交易付款接口。

使用该API前,请确认你的小程序应用已经添加 当面付 功能

入参说明

字段名 类型 必填 说明
subject String 订单标题
outTradeNo String 交易创建时传入的商户订单号
totalAmount String 订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]
authCode String 支付授权码,25~30开头的长度为16~24位的数字,实际字符串长度以开发者获取的付款码长度为准
notify_url String 支付宝服务器主动通知商户服务器里指定的页面http/https路径,也可以是云函数的http触发路径。
appAuthToken String 三方代调用应用访问令牌,目前仅在云函数中调用支持。

调用示例

在云函数中调用

  1. // 云函数中使用云调用无需引入其他依赖,只需要使用ctx.cloud调用
  2. module.exports = async function (ctx) {
  3. const res = await ctx.cloud.payment.faceToFace.pay({
  4. // 参数接收自云函数调用端传入的参数
  5. subject: ctx.args.subject,
  6. outTradeNo: ctx.args.outTradeNo,
  7. totalAmount: ctx.args.totalAmount,
  8. authCode: ctx.args.authCode
  9. });
  10. return res;
  11. };

支持传入notifyUrl接收支付宝服务器交易通知

  1. // 云函数中使用云调用无需引入其他依赖,只需要使用ctx.cloud调用
  2. module.exports = async function (ctx) {
  3. const res = await ctx.cloud.payment.faceToFace.pay({
  4. // 参数接收自云函数调用端传入的参数
  5. subject: ctx.args.subject,
  6. outTradeNo: ctx.args.outTradeNo,
  7. totalAmount: ctx.args.totalAmount,
  8. authCode: ctx.args.authCode
  9. }, {
  10. // 传入接收支付宝服务器交易通知的http/https路径,也可以是云函数的http触发路径
  11. notify: {
  12. url: 'http://api.test.alipay.net/atinterface/receive_notify.htm'
  13. }
  14. });
  15. return res;
  16. };

支持传入appAuthToken进行三方代调用

  1. // 云函数中使用云调用无需引入其他依赖,只需要使用ctx.cloud调用
  2. module.exports = async function (ctx) {
  3. const res = await ctx.cloud.payment.faceToFace.pay({
  4. // 参数接收自云函数调用端传入的参数
  5. subject: ctx.args.subject,
  6. outTradeNo: ctx.args.outTradeNo,
  7. totalAmount: ctx.args.totalAmount,
  8. authCode: ctx.args.authCode
  9. }, { // appAuthToken参数接收自云函数调用处传入的参数
  10. appAuthToken: ctx.args.appAuthToken
  11. });
  12. return res;
  13. };

在小程序页面调用

alipay-serverless-sdk 版本&=1.0.0

  1. const payRes = await cloud.payment.faceToFace.pay({
  2. subject: '小程序Serverless支付测试',
  3. outTradeNo: "demo" + new Date().getTime(),
  4. totalAmount: '0.01',
  5. authCode: '286532211313197763'
  6. });

alipay-serverless-sdk 版本<1.0.0

  1. const payResult = await cloud.payment.faceToFace.pay('小程序Serverless支付测试', this.data.outTradeNo, '0.01', '286532211313197763');

返回数据示例

  1. {
  2. "code":"10000",
  3. "msg":"Success",
  4. "trade_no":"2013112011001004330000121536",
  5. "out_trade_no":"6823789339978248",
  6. "buyer_logon_id":"159****5620",
  7. "settle_amount":"88.88",
  8. "pay_currency":"CNY",
  9. "pay_amount":"580.04",
  10. "settle_trans_rate":"1",
  11. "trans_pay_rate":"6.5261",
  12. "total_amount":120.88,
  13. "trans_currency":"USD",
  14. "settle_currency":"USD",
  15. "receipt_amount":"88.88",
  16. "buyer_pay_amount":8.88,
  17. "point_amount":8.12,
  18. "invoice_amount":12.5,
  19. "gmt_payment":"2014-11-27 15:45:57",
  20. "fund_bill_list":[
  21. {
  22. "fund_channel":"ALIPAYACCOUNT",
  23. "amount":10,
  24. "real_amount":11.21
  25. }
  26. ],
  27. "card_balance":98.23,
  28. "store_name":"证大五道口店",
  29. "buyer_user_id":"2088101117955611",
  30. "discount_goods_detail":"[{"goods_id":"STANDARD1026181538","goods_name":"雪碧","discount_amount":"100.00","voucher_id":"2015102600073002039000002D5O"}]",
  31. "voucher_detail_list":[
  32. {
  33. "id":"2015102600073002039000002D5O",
  34. "name":"XX超市5折优惠",
  35. "type":"ALIPAY_FIX_VOUCHER",
  36. "amount":10,
  37. "merchant_contribute":9,
  38. "other_contribute":1,
  39. "memo":"学生专用优惠",
  40. "template_id":"20171030000730015359000EMZP0",
  41. "purchase_buyer_contribute":2.01,
  42. "purchase_merchant_contribute":1.03,
  43. "purchase_ant_contribute":0.82
  44. }
  45. ],
  46. "advance_amount":"88.8",
  47. "auth_trade_pay_mode":"CREDIT_PREAUTH_PAY",
  48. "charge_amount":"8.88",
  49. "charge_flags":"bluesea_1",
  50. "settlement_id":"2018101610032004620239146945",
  51. "business_params":"{"data":"123"}",
  52. "buyer_user_type":"PRIVATE",
  53. "mdiscount_amount":"88.88",
  54. "discount_amount":"88.88",
  55. "buyer_user_name":"菜鸟网络有限公司"
  56. }
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号