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

IOS连续订阅总结

如何判断后续用户是续费

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

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

苹果的异步通知类型

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

  • 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连续会员包月功能 -- IOS连续订阅 & 支付宝周期扣款_第2张图片

相关文档

支付宝周期扣款文档:

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

苹果

  • app-store帮助中心

  • 官方文档

  • 超详细文档

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

你可能感兴趣的:(go,支付宝,苹果内购,ios,go,连续订阅,支付宝周期扣款,ios内购)