From 4783e92058f7a50d87e4f19f74241ca6b082002b Mon Sep 17 00:00:00 2001 From: wangyaqi Date: Fri, 16 Jul 2021 17:04:04 +0800 Subject: [PATCH] docs: update uni-pay --- docs/uniCloud/unipay.md | 64 ++++++++++++++++++++++++++++++++--------- 1 file changed, 50 insertions(+), 14 deletions(-) diff --git a/docs/uniCloud/unipay.md b/docs/uniCloud/unipay.md index 177a61b2b..8bf1b1211 100644 --- a/docs/uniCloud/unipay.md +++ b/docs/uniCloud/unipay.md @@ -544,6 +544,8 @@ exports.main = async function (event) { ### 支付结果通知处理 +**注意：支付宝在非全量退款时也会发送通知到支付时设置的notify_url** + `unipayIns.verifyPaymentNotify`，用于在使用云函数 Url 化的云函数内检验并处理支付结果。 **入参说明** @@ -589,7 +591,11 @@ exports.main = async function (event) { } ``` -### 退款结果通知 +### 退款结果通知@verify-refund-notify + +**注意：支付宝在非全量退款时才会发送通知，通知地址为支付时设置的notify_url** + +> uni-pay 1.0.17版本起新增对支付宝退款结果通知的支持 `unipayIns.verifyRefundNotify`，用于在使用云函数 Url 化的云函数内检验并处理支付结果。 @@ -599,19 +605,19 @@ exports.main = async function (event) { **返回值说明** -| 参数名 | 类型 | 说明 | 支持平台 | -| :-----------------: | :----: | :---------------------------------------------------: | :------: | -| totalFee | Number | 订单总金额 | - | -| refundFee | Number | 申请退款金额 | - | -| settlementTotalFee | Number | 应结订单金额 | - | -| settlementRefundFee | Number | 退款金额 | - | -| outTradeNo | String | 商户订单号 | - | -| transactionId | String | 平台订单号 | - | -| refundId | String | 平台退款单号 | - | -| outRefundNo | String | 商户退款单号 | - | -| refundStatus | String | SUCCESS-退款成功,CHANGE-退款异常,REFUNDCLOSE—退款关闭 | - | -| refundAccount | String | 退款资金来源 | - | -| refundRecvAccout | String | 退款入账账户 | - | +| 参数名 | 类型 | 说明 | 支持平台| +| :-----------------: | :----:| :---------------------------------------------------: | :------:| +| totalFee | Number| 订单总金额 | - | +| refundFee | Number| 申请退款金额 | - | +| settlementTotalFee | Number| 应结订单金额，支付宝不返回 | - | +| settlementRefundFee | Number| 退款金额，支付宝不返回 | - | +| outTradeNo | String| 商户订单号 | - | +| transactionId | String| 平台订单号 | - | +| refundId | String| 平台退款单号，支付宝不返回 | - | +| outRefundNo | String| 商户退款单号 | - | +| refundStatus | String| SUCCESS-退款成功,CHANGE-退款异常,REFUNDCLOSE—退款关闭| - | +| refundAccount | String| 退款资金来源，支付宝不返回 | - | +| refundRecvAccout | String| 退款入账账户，支付宝不返回 | - | **使用示例** @@ -639,3 +645,33 @@ exports.main = async function (event) { } } ``` + +### 获取通知类型@check-notify-type + +> 新增于 uni-id 1.0.17 + +`unipayIns.checkNotifyType`，用于在使用云函数 Url 化的云函数内检验当前通知的类型。由于支付宝支付在非全量退款时会调用支付时设置的notify_url，可以使用此接口在调用校验通知之前判断通知类型 + +**入参说明** + +只接收对应云函数的`event`作为参数 + +**返回值说明** + +此接口会返回一个字符串，可能的值如下 + +- `refund`：当前是一个退款通知 +- `payment`：当前是一个支付结果通知 + +**使用示例** + +```js +exports.main = async function (event) { + let res = await unipayIns.checkNotifyType(event) + if(res === 'refund') { + // 退款通知 + } else if(res === 'payment') { + // 支付结果通知 + } +} +``` \ No newline at end of file -- GitLab