Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
你丑我先上
unidocs-zh
提交
b5f106ce
U
unidocs-zh
项目概览
你丑我先上
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
b5f106ce
编写于
7月 07, 2022
作者:
d-u-a
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
plus iap: 更新新增参数及方法
上级
abaf6c87
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
15 addition
and
11 deletion
+15
-11
docs/tutorial/app-payment-aip.md
docs/tutorial/app-payment-aip.md
+15
-11
未找到文件。
docs/tutorial/app-payment-aip.md
浏览文件 @
b5f106ce
...
@@ -102,8 +102,8 @@ var restoreFlag = true; // 调用支付接口时标记 restoreFlag = true , 实
...
@@ -102,8 +102,8 @@ var restoreFlag = true; // 调用支付接口时标记 restoreFlag = true , 实
plus
.
payment
.
request
(
iap
,
{
plus
.
payment
.
request
(
iap
,
{
productid
:
"
商品id
"
,
productid
:
"
商品id
"
,
username
:
"
appusername
"
,
// 用户标识
username
:
"
appusername
"
,
// 用户标识
optimize
:
true
,
// 设置 optimize: true 解决丢单问题
optimize
:
true
,
// 设置 optimize: true 解决丢单问题
,已废弃,推荐使用 manualFinishTransaction
iapVersion
:
2
// 3.5.0
+ 支持,设置此参数后需要开发者主动关闭订单,参见下面的关闭订单方法 finishTransaction()
manualFinishTransaction
:
true
// 3.5.1
+ 支持,设置此参数后需要开发者主动关闭订单,参见下面的关闭订单方法 finishTransaction()
},
function
(
result
){
},
function
(
result
){
restoreFlag
=
false
;
// 支付成功清除标记 restoreFlag = false
restoreFlag
=
false
;
// 支付成功清除标记 restoreFlag = false
// 支付成功,result 为 IAP商品交易信息对象 IAPTransaction 需将返回的支付凭证传给后端进行二次认证
// 支付成功,result 为 IAP商品交易信息对象 IAPTransaction 需将返回的支付凭证传给后端进行二次认证
...
@@ -167,24 +167,28 @@ document.addEventListener('resume',function(){
...
@@ -167,24 +167,28 @@ document.addEventListener('resume',function(){
```
```
#### 丢单问题说明
#### 丢单问题说明
通过和用户联调我们发现在调用支付接口后,如果用户未绑定支付方式此时会触发支付失败回调方法,实际上用户可以跳转 AppStrore 绑卡然后继续支付,之前的逻辑在回调失败方法中框架会关闭订单,用户付完钱在回到App中也不会触发成功回调,这样就造成了丢单,解决方法就是在调用支付接口时添加optimize: true参数,并标记 restoreFlag = true;,支付成功回调中清除标记 restoreFlag = false; 然后在支付失败回调中框架就不会关闭订单了,并在页面显示的时候通过标记判断是否需要调用 restoreComplateRequest 方法,如果用户跳转App Store绑定支付方式付款成功后回到 App 就可以通过 restoreComplateRequest 方法恢复之前支付的订单信息,解决丢单的问题;
通过和用户联调我们发现在调用支付接口后,如果用户未绑定支付方式此时会触发支付失败回调方法,实际上用户可以跳转 AppStrore 绑卡然后继续支付,之前的逻辑在回调失败方法中框架会关闭订单,用户付完钱在回到App中也不会触发成功回调,这样就造成了丢单,解决方法就是在调用支付接口时添加optimize: true参数,并标记 restoreFlag = true;,支付成功回调中清除标记 restoreFlag = false; 然后在支付失败回调中框架就不会关闭订单了,并在页面显示的时候通过标记判断是否需要调用 restoreComplateRequest 方法,如果用户跳转App Store绑定支付方式付款成功后回到 App 就可以通过 restoreComplateRequest 方法恢复之前支付的订单信息,解决丢单的问题;
3.
5.1 之前因自动关闭订单导致某些情况下丢单的问题
3.
5.1 +
#### 丢单解决方案
-
新增手动关闭订单参数
`manualFinishTransaction`
, 在合适的时机调用
`iapChannel.finishTransaction`
关闭订单
3.
5.0+ 支持
-
新增关闭订单方法
`iapChannel.finishTransaction(Transaction, <Function> success, <Function> fail)`
-
调用支付和恢复购买时传递参数
`iapVersion`
, 设置后订单不会关闭,需要开发者在合适的时机调用
`finishTransaction`
关闭订单
-
新增 iapChannel 方法
`requestProduct`
`restoreCompletedTransactions`
替代
`requestOrder`
`restoreComplateRequest`
```
js
```
js
// 支付
// 支付
plus
.
payment
.
request
(
iapChannel
,
{
plus
.
payment
.
request
(
iapChannel
,
{
iapVersion
:
2
manualFinishTransaction
:
true
})
})
// 恢复
// 恢复
iapChannel
.
restoreCompl
ateRequest
({
iapChannel
.
restoreCompl
etedTransactions
({
iapVersion
:
2
manualFinishTransaction
:
true
})
})
```
```
...
@@ -193,7 +197,7 @@ iapChannel.restoreComplateRequest({
...
@@ -193,7 +197,7 @@ iapChannel.restoreComplateRequest({
1.
网络原因
1.
网络原因
2.
用户首次绑卡
2.
用户首次绑卡
过段时间调用恢复购买
`restoreCompl
ateRequest
`
可以获取到上次异常或未完成的订单
过段时间调用恢复购买
`restoreCompl
etedTransactions
`
可以获取到上次异常或未完成的订单
-
正确关闭订单的方法
-
正确关闭订单的方法
...
@@ -202,8 +206,8 @@ iapChannel.restoreComplateRequest({
...
@@ -202,8 +206,8 @@ iapChannel.restoreComplateRequest({
3.
二次确认后可安全调用
`finishTransaction`
关闭订单
3.
二次确认后可安全调用
`finishTransaction`
关闭订单
注意:
注意:
-
在订单未关闭时,即使卸载应用调用恢复购买
`restoreCompl
ateRequest
`
仍然可以获取到
-
在订单未关闭时,即使卸载应用调用恢复购买
`restoreCompl
etedTransactions
`
仍然可以获取到
-
A账号下载的应用,切换B账号, 调用
`restoreCompl
ateRequest
`
系统弹窗提示恢复购买失败
-
A账号下载的应用,切换B账号, 调用
`restoreCompl
etedTransactions
`
系统弹窗提示恢复购买失败
### 常见问题
### 常见问题
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录