首页>>app
苹果订阅支付必须走苹果支付接入详细教程
2023-05-30
177浏览
客户端实现ios订阅支付后,支付成功会返回一个收据(一大串随机字符串),需要请求苹果服务器的接口来校验该收据的真实性,同时校验完成后苹果服务器也会发通知告诉我们的自己的服务器(ios后台配置的回调地址),这个时候就需要服务端来接入苹果服务器并处理该支付逻辑。这里不使用客户端直接接入苹果服务器校验收据接口的

客户端实现ios订阅支付后,支付成功会返回一个收据(一大串随机字符串),需要请求苹果服务器的接口来校验该收据的真实性,同时校验完成后苹果服务器也会发通知告诉我们的自己的服务器(ios后台配置的回调地址),这个时候就需要服务端来接入苹果服务器并处理该支付逻辑。这里不使用客户端直接接入苹果服务器校验收据接口的原因大概就是因为订阅类型需要共享密钥,防止该密钥暴露,同时服务器接入能更好处理逻辑。

image.png

接入必要配置

1.订阅类型需要从苹果后台获取一个共享密钥

2.需要在苹果后台配置好回调地址

3.需要配置订阅产品(周期,价格,我自己没什么了解,这个需要注意的是订阅有按组分,同一个组和不同组的产品是有区别的,例如同一个组的不同产品进行购买,他们的原始订单可能相同)

接入必要资源

简体中文文档 - Apple Developer

校验收据:通过 App Store 验证收据 - 简体中文文档 - Apple Developer

回调通知:启用 App Store 服务器通知 - 简体中文文档 - Apple Developer

退款处理:处理退款通知 - 简体中文文档 - Apple Developer

收据校验沙箱环境:https://sandbox.itunes.apple.com/verifyReceipt

收据校验生产环境:https://buy.itunes.apple.com/verifyReceipt

接入流程

1.服务端接入apple校验收据接口

注意事项:防止相同数据重复校验或者相同请求大量请求导致的不稳定因素,建议使用时间戳校验预防,不要将共享密钥暴露在客户端,共享密钥同时也可以对回调通知进行校验,校验收据后不要做为订单处理,最好一切以回调为主。

接口地址:https://buy.itunes.apple.com/verifyReceipt

接口类型:POST

接口格式:appliaction/json

功能说明:该接口主要是用来恢复订阅和支付校验,校验完成会有回调通知到商户服务器

请求参数:

官方:Apple Developer Documentation

{"password":"这里是共享密钥","receipt-data":"这里是收据的字符串"}

返回结果:

状态码:Apple Developer Documentation

失败:

{"status":21000}

成功:

成功结果参数文档:responseBody | Apple Developer Documentation

主要参数说明:

{"environment": "Production",   //请求环境"receipt": {"receipt_type": "Production","adam_id": xxx,"app_item_id": xxx,"bundle_id": "com.xxx","application_version": "2","download_id": xxx,"version_external_identifier": xxx,"receipt_creation_date": "2022-10-24 07:14:36 Etc/GMT","receipt_creation_date_ms": "1666595676000","receipt_creation_date_pst": "2022-10-24 00:14:36 America/Los_Angeles","request_date": "2023-02-24 03:29:47 Etc/GMT","request_date_ms": "1677209387760","request_date_pst": "2023-02-23 19:29:47 America/Los_Angeles","original_purchase_date": "2022-07-04 03:24:29 Etc/GMT","original_purchase_date_ms": "1656905069000","original_purchase_date_pst": "2022-07-03 20:24:29 America/Los_Angeles","original_application_version": "2","in_app": [  //所有订单都可能存在,主要是非订阅订单{"quantity": "1","product_id": "xxxx","transaction_id": "xxxx","original_transaction_id": "xxx","purchase_date": "2022-07-04 03:25:29 Etc/GMT","purchase_date_ms": "1656905129000","purchase_date_pst": "2022-07-03 20:25:29 America/Los_Angeles","original_purchase_date": "2022-07-04 03:25:30 Etc/GMT","original_purchase_date_ms": "1656905130000","original_purchase_date_pst": "2022-07-03 20:25:30 America/Los_Angeles","expires_date": "2022-07-11 03:25:29 Etc/GMT","expires_date_ms": "1657509929000","expires_date_pst": "2022-07-10 20:25:29 America/Los_Angeles","web_order_line_item_id": "xxx","is_trial_period": "false","is_in_intro_offer_period": "false","in_app_ownership_type": "PURCHASED"}]},"latest_receipt_info": [  //订单订阅集合,从上往下订单时间倒序,第一个为最新的支付订单{"quantity": "1","product_id": "xxx",  //订单产品id,apple后台支付配置的参数"transaction_id": "xxx",  //apple当前订单号"original_transaction_id": "xxx",  //apple原始订单号,该用户在该产品第一笔支付订单,可当做同一批订单朔源"purchase_date": "2022-11-25 08:19:27 Etc/GMT", //订单时间"purchase_date_ms": "1669364367000","purchase_date_pst": "2022-11-25 00:19:27 America/Los_Angeles","original_purchase_date": "2022-07-04 03:25:30 Etc/GMT",  //最初购买时间"original_purchase_date_ms": "1656905130000","original_purchase_date_pst": "2022-07-03 20:25:30 America/Los_Angeles","expires_date": "2023-11-25 08:19:27 Etc/GMT",  //订阅过期时间"expires_date_ms": "1700900367000","expires_date_pst": "2023-11-25 00:19:27 America/Los_Angeles","web_order_line_item_id": "xxx","is_trial_period": "false",  //是否是试用订单"is_in_intro_offer_period": "false","in_app_ownership_type": "PURCHASED","subscription_group_identifier": "xxx"}],"latest_receipt": "------------加密串------------","pending_renewal_info": [{"auto_renew_product_id": "xxx","product_id": "xxx","original_transaction_id": "xxx","auto_renew_status": "0"}],"status": 0  //状态成功

}

  2.apple支付回调通知接入

回调通知配置:苹果后台可配置生产环境和沙箱环境的APPLE回调通知地址

接入文档:responseBodyV1 | Apple Developer Documentation

提示:接入apple支付回调apple提供了v1和v2两种类型,v2需要多一步加解密的操作

功能说明:该通知主要是订单状态的变更等,包括续订,付费通知,取消订阅,退款等通知

可进行订单处理

通知类型说明:

INITIAL_BUY

首次购买

REFUND

退款

CANCEL

取消订阅

DID_RENEW

自动续订

INTERACTIVE_RENEWAL

应用界面或appstore手动续订

DID_RECOVER

恢复订阅

回调请求参数示例

{"notification_type":"DID_RENEW",  //通知类型,该类型为续订通知"auto_renew_product_id":"xxx","password":"xxx",  //共享密钥,可以验证是否真实通知"environment":"Sandbox","original_transaction_id":xxx,"unified_receipt":{"status":0,"environment":"Sandbox","latest_receipt_info":[  //第一笔为最新的通知订单{"quantity":"1","product_id":"xxx","transaction_id":"xxx", //当前订单号"purchase_date":"2022-06-08 09:51:55 Etc/GMT","purchase_date_ms":"1654681915000","purchase_date_pst":"2022-06-08 02:51:55 America/Los_Angeles","original_purchase_date":"2022-06-08 04:36:20 Etc/GMT","original_purchase_date_ms":"1654662980000","original_purchase_date_pst":"2022-06-07 21:36:20 America/Los_Angeles","expires_date":"2022-06-08 09:54:55 Etc/GMT","expires_date_ms":"1654682095000","expires_date_pst":"2022-06-08 02:54:55 America/Los_Angeles","web_order_line_item_id":"xxx","is_trial_period":"false","is_in_intro_offer_period":"false","original_transaction_id":"xxx", //原始订单号,该产品首次的订单号"in_app_ownership_type":"PURCHASED","subscription_group_identifier":"xxx"},{"quantity":"1","product_id":"xxx","transaction_id":"xxx","purchase_date":"2022-06-08 09:48:03 Etc/GMT","purchase_date_ms":"xxx","purchase_date_pst":"2022-06-08 02:48:03 America/Los_Angeles","original_purchase_date":"2022-06-08 04:36:20 Etc/GMT","original_purchase_date_ms":"1654662980000","original_purchase_date_pst":"2022-06-07 21:36:20 America/Los_Angeles","expires_date":"2022-06-08 09:51:03 Etc/GMT","expires_date_ms":"1654681863000","expires_date_pst":"2022-06-08 02:51:03 America/Los_Angeles","web_order_line_item_id":"xxx","is_trial_period":"false","is_in_intro_offer_period":"false","original_transaction_id":"xxx","in_app_ownership_type":"PURCHASED","subscription_group_identifier":"xxx"}],"pending_renewal_info":[{"auto_renew_status":"1","auto_renew_product_id":"xxx","product_id":"xxx","original_transaction_id":"xxx"}]},"bvrs":"xxx","bid":"com.xxx","auto_renew_status":"true"

}

接入问题说明

1.latest_receipt_info集合订单按时间倒序排序,所以第一笔为最新的订单

2.ios收据为账户维度,即收据和通知获取的数据为该账户的历史订单集合,非当前支付

3.ios订单未返回金额等参数,需要自己做处理

4.ios退款通知不支持订阅类型

5.apple支付为全球性支付,需要自己处理货币转换

6.同一个产品包括同产品组,在同一个账户支付会生成一个原始订单号,可根据该订单号溯源

7.订单校验只适用于恢复订阅和收据校验,具体支付处理按通知为主

8.状态码21007为测试环境的收据请求到了正式环境


一、首页样式首页分类样式1、顶部banner图片,可以有连接进入相关的页面如图:banner图片json格式{"type":"banner","height":"150",//图片高度"list":[{"imgurl":"http://xxxx.png",//图片地址...
07-16
电商原生App,自主开发电商原生app
html包的制作配置文件名replace.txt ,建好文件存在包根目录即可,包内文件目录与文件名不能有中文。文件内容{“拦截网址”:“本地文件”}如:{"http://www.baidu1.com":"index.html","http://www.sina2.com":"test.html",}replace.txt写好后放到html目录下,打包...
06-27
创建App,打开网址:https://www.appbsl.cn/encapsulationApp/%20选择初级版本,年限七天免费,网址随便输入一个。配置页里面找到“本地资源上传”,把离线的zip上传即可本地资源如何配置配置文件名replace.txt文件,建好文件存在包根目录即可。注意:包内文件目录与文件名不能有任何中文。有是无法使用的。replace.t...
06-09
h5打包app,h5在线生成app,uniapp生成app
前端使用uniapp开发项目完成后,需要将页面打包,生成H5的静态文件,部署在服务器上。这样通过服务器链接地址,直接可以在手机上点开来访问。也可以用变色龙打包app功能,打包成App,过苹果上架时4.3问题。点击菜单栏“发行”,点击选择“网站-PC Web或手机H5”,填写网站标题和网站域名/服务器的IP地址。点击进入manifest....
05-19
Uinapp写的怎么导出h5,编译html,uniapp4.3
变色龙IOS免签功能列表:1、IOS免签推送消息给用户2、顶部栏颜色修改3、菜单栏配置4、全屏化显示5、支持支付功能6、注入JS,CSS功能...
05-17
苹果免签推送功能,IOS免签,不上架封装苹果不掉签
功能介绍1、App封装实现App封装,混合开发App,100多JS接口功能交互。2、制作小程序通过接口网站封装成小程序。下载地址https://pan.baidu.com/s/1KRYRk2ZG83B6w9p5rvJNzw提:0opi环境环境:PHP 5.6 + MySQL存储:七牛存储服务器最低要求CPU:1核,内存:2G,硬盘:10G,1M带宽不能用空间,有要修改php环境的要求。...
05-12
网站生成app源码,网站源码,生成app网站
在线一键网站网页生成app,包括安卓与苹果。...
05-12
网页生成app免费,网页app生成器无广告,在线生成网页转app,生成app,封装app,打包app
...
11-12