后端做app连续会员包月功能 -- IOS连续订阅 & 支付宝周期扣款

IOS连续订阅总结

如何判断后续用户是续费

1. 服务端轮询续费表，会员到期的前一天，根据用户id。去苹果服务器检验用户是否续费成功
	a. 查询的状态应有：等待扣费、扣费失败
    b. 扣费失败 , 对于扣费失败的用户, 苹果仍会尝试扣款60天, 此时应该标记为扣费失败, 轮询时会查到该数据
    c. 已关闭, 订阅已经关闭, 不会再次扣费, 轮询时不会查到该数据
	d. 如果扣费成功，正常发放会员权益即可

2. 用户进入会员首页时，检查用户订阅时间，如在扣款时间内，去苹果服务器获取用户订阅状态
	查询会有几种状态
	a. 有新的扣费(下个周期的扣费): 正常发放会员权益即可
	b: 已经关闭订阅： 更新用户订阅状态
	c: 已更换其他连续订阅产品：目前我们是只允许往高阶段更换
	  (连续包月可以升级到连续包季，但是连续包季不能降低到连续包月)，
	  ios内购那边，如果你升级了，会按照当前商品时间比例退款，
	  并同时变更为新的续订商品。所以我们服务端，需要按时间扣除会员权益，并更新为新的连续商品。
	d: 扣款失败：更新用户订阅状态为：扣费失败
	e: 有退款：退款逻辑
	f: 如果用户切换app账号，再用同一个appid连续订阅商品的时候，会切换绑定

苹果的异步通知类型

• INITIAL_BUY: 首次订阅成功
• CANCEL: 取消了订阅
• RENEWAL: 恢复了订阅
• INTERACTIVE_RENEWAL: 也是恢复了订阅,在sandbox测试时,6次收据之后,重新订阅,就会是这个状态
• DID_CHANGE_RENEWAL_PREF: 也是取消了订阅,在sandbox测试时,6次收据之后,就会变成这个状态
• DID_CHANGE_RENEWAL_STATUS:各种状态改变下都会调用,比如说首次购买会收到两次回调,一个是INITIAL_BUY一个是DID_CHANGE_RENEWAL_STATUS

苹果连续订阅表的设计

type AutoSubscription
    UserId                string   `bson:"userId" json:"userId"`                               // 当前权益的用户id
    OriginalUserId        string   `bson:"originalUserId" json:"originalUserId"`               // 原始订阅的用户id
    OriginalTransactionId string   `bson:"originalTransactionId" json:"originalTransactionId"` // 原始订阅唯一标识
    OriginalReceipt       string   `bson:"originalReceipt" json:"originalReceipt"`             // 原始票据
    Receipt               string   `bson:"receipt" json:"receipt"`                             // 上一次的票据
    TransactionId         []string `bson:"transactionId" json:"transactionId"`                 // 每一期的唯一标识
    OrderId               string   `bson:"orderId" json:"orderId"`                             // 订单id
    Status                int      `bson:"status" json:"status"`                               // 订阅状态 100 订阅中; 101 关闭订阅;
    RenewStatus           int      `bson:"renewStatus" json:"renewStatus"`                     // 续费状态. 100: 扣费成功; 101: 等待扣费; 102: 扣费失败
    OriginalProductId     string   `bson:"originalProductId" json:"originalProductId"`         // 一开始订阅的商品id
    ProductId             string   `bson:"productId" json:"productId"`                         // 现在订阅的商品id
    ExpiresDateMs         int64    `bson:"expiresDateMs" json:"expiresDateMs"`                 // 订阅周期过期时间 毫秒
    PurchaseDateMs        int64    `bson:"purchaseDateMs" json:"purchaseDateMs"`               // 订阅周期开始时间 毫秒
    UpdatedAt             int64    `bson:"updatedAt" json:"updatedAt"`
    CreatedAt             int64    `bson:"createdAt" json:"createdAt"`

支付宝自动续费文档

周期扣款场景为 支付并签约

准备工作

微服务pay, 需要提供的基础接口
1. 原创建接口 加周期扣款参数
2. 查询签约接口
3. 解约接口
4. 后续扣款接口
5. 开发语言：go
6. 第三方sdk:  https://github.com/smartwalle/alipay
恶心之处
    最短周期7天，测试时只能提前5天扣款，不能短时间调试

逻辑

1. 跟ios内购不太一样的地方就是，支付宝后续扣款需要自己去按照时间调接口扣款，不能像苹果一样，
 	自动触发。
2. 还有在测试开发的时候，并不能短周期扣款（ps: 苹果在沙盒环境，连续包月、包季、包年会每5、
	15、60分钟自动续费一次）。导致不能随意所欲的跑完整个周期。目前我是这样设置的，测试服
	设置为7天一个周期，在支付成功后，过5分钟自动扣费一次，即下个周期的费用，但是后续就不能扣款了。只能这样
3. "execute_time" 支付宝里这个参数踩了坑，只能比这个时间早，不能比这个时间晚。比如我设置的
	时间为2021-09-12，扣款时间只能是 2021-09-07 ~ 2021-09-12，超过这个时间不能扣款了。如果后
	续想再扣款，需要调接口更改签约协议的扣款周期了。
4. 目前我的做法是，在续费表中，写入下个周期扣款的日期。每天轮询，如果有当天的扣款日期，就
	进行扣款。目前测试服没啥问题，线上待观察
5. 其他检查协议的逻辑，基本跟苹果续订类似，也是在用户查看会员 或者 定时的去查询用户的续订状态

支付宝签约表的设计

• 因为支付宝可以不同周期的同时存在，跟苹果的有冲突，所以重新建了一张表，结构类似

type AliPayAgreement struct {
	UserId              string   `bson:"userId" json:"userId"`                           // 当前权益的用户id
	ExternalAgreementNo string   `bson:"externalAgreementNo" json:"externalAgreementNo"` // 商户签约号，代扣协议中标示用户的唯一签约号（确保在商户系统中唯一）
	ExecuteTime         string   `bson:"executeTime" json:"executeTime"`                 // 下次扣款时间
	AgreementNo         string   `bson:"agreementNo" json:"agreementNo"`                 // 签约后的 用户签约号
	Sign                string   `bson:"sign" json:"sign"`                               // 用户签约号
	TransactionId       []string `bson:"transactionId" json:"transactionId"`             // 每一期的订单id
	OrderId             string   `bson:"orderId" json:"orderId"`                         // 订单id
	Status              int      `bson:"status" json:"status"`                           // 订阅状态 100 签约中; 101 关闭签约; 102 待签约;
	RenewStatus         int      `bson:"renewStatus" json:"renewStatus"`                 // 续费状态.   100: 扣费成功; 101: 等待扣费; 102: 扣费失败
	ProductId           string   `bson:"productId" json:"productId"`                     // 现在订阅的商品id
	ExpiresDateMs       int64    `bson:"expiresDateMs" json:"expiresDateMs"`             // 订阅周期过期时间 毫秒
	PurchaseDateMs      int64    `bson:"purchaseDateMs" json:"purchaseDateMs"`           // 订阅周期开始时间 毫秒
	UpdatedAt           int64    `bson:"updatedAt" json:"updatedAt"`
	CreatedAt           int64    `bson:"createdAt" json:"createdAt"`
	SignAt              int64    `bson:"signAt" json:"signAt"`
	CloseAt             int64    `bson:"closeAt" json:"closeAt"`
	FirstPrice          int      `bson:"firstPrice" json:"firstPrice"`       // 首次扣款价格  单位： 分
	RenewPrice          int      `bson:"renewPrice" json:"renewPrice"`       // 后续代扣价格 单位： 分
	AlipayUserId        string   `bson:"alipayUserId" json:"alipayUserId"`   // 用户的支付宝账号对应的支付宝唯一用户号。
	AlipayLogonId       string   `bson:"alipayLogonId" json:"alipayLogonId"` // 用户的支付宝登录账号
}

测试服自动续费说明

自动续费说明
- 安卓自动续费
    目前仅有支付宝（支付宝支持最少7天一个周期）
    测试服，为了方便测试，连续包月、包季、包年，均设置为7天一个周期，5分钟后自动扣款一次。后续则按照7天一个周期进行扣款。后续根据周期时间，提前5天扣款。
    举例：2021-09-01 购买连续包月会员，支付宝那边显示每隔7天，自动扣款，下次扣款日期为 09-03（提前5天扣款）。实际为了测试，提前到当前时间，延迟5分钟执行。
         支付成功后，会员时间延长1个月。后续扣款时间为下个周期，即 3号+7天 = 10号。即09-10 再次进行下次扣款，后续以此类推。支付宝展示亦是如此
- IOS自动续费
    测试服，ios中连续包月、连续包季、连续包年，分别为5、15、60分钟一个周期，进行周期扣款，扣款次数最多为6次。（苹果那边固定设置，无法改变）。测试时最好使用未支付过的apple账号，避免其他错误。

IOS沙盒环境下的订阅周期

相关文档

支付宝周期扣款文档：

• 支付宝周期扣款官方文档
• 案例分析

苹果

• app-store帮助中心

• 官方文档

• 超详细文档

• 其他优秀文档
  https://blog.csdn.net/kaikai0803/article/details/95642913
  https://www.jianshu.com/p/a3cb7760dbbe
  https://blog.csdn.net/theCrucian/article/details/89406203