快速开始
欢迎来到艺爪付费,我们快速开始吧!
创建项目
一个项目对应你的一个产品。跨平台的产品,例如一个Android/iOS/Web多平台的产品,算做一个项目。
进入 艺爪付费后台 界面,点击首页右上角,创建项目。
- 名称:项目名称(产品名称/应用名称)。
- 通知渠道和通知URL,参考配置项目通知 ,可以后续再填写。
项目创建之后,会显示项目ID和API密钥,用于后续API集成。
创建权益
用户可享受的一种权益类型,例如:会员、积分。
权益可以配置初始值,例如:免费试用时长、免费试用积分。
一个产品可以有多种权益,例如:功能1会员、功能2会员、普通会员、高级会员。
每个权益都必须分配到一个权益分组,一个权益分组包含多个具有不同级别的权益,例如:普通会员、高级会员。用户从一个分组中只能获得其中一个权益,或者从低级别权益升级到更高级别的权益。
每种权益类型都有一个默认分组,如果创建权益时没有分配权益分组,则会分 配到相应的默认分组。
后台界面首页点击权益,进入权益页面。
创建权益,例如:名称填写「会员」,初始余额填写「30d」。权益ID和别名可用于后续API集成。
创建商品
用户可以购买的商品,一个商品可以包含一个或多个商品权益。
例如:单月会员,包含30天会员权益;一年会员,包含365天会员权益。
表示具体权益的数量,用户购买商品后获得,例如:30天会员权益,100积分权益。
后台界面首页点击商品,进入商品页面。
- 创建商品,例如:「一年会员」和「单月会员」,选择价格。可在 价格表 页面配置价格选项。
- 创建商品之后,商品页面下方添加商品权益,例如:权益「会员」,时长「365d」,保存。
商品展示效果如下图所示,底部划线价和底部提示语展示在同一个位置,同时配置时只展示底部提示语。
支付渠道
艺爪付费支持多种 支付渠道,为方便快速上手,我们从微信收款码渠道开始。
后台界面首页点击支付渠道,进入支付渠道页面,点击右上角「+」号,创建支付渠道。
名称填写「微信收款」,类型「简易-微信」,然后点击不定额收款码右侧上传按钮,上传一张微信收款码图片。也可以继续添加固定金额的收款码。
微信收款码图片可以在微信「收付款 -> 二维码收款」中下载。未设置金额的即为不定额收款码,用户支付时可以选择任意金额。
付费界面
用户付费界面,可以配置商品展示、支付方式等。
后台界面首页点击商品,进入商品页面。点击付费界面「添加」按钮,创建付费界面。
名称可填写「我的会员」,在商品展示下方,选择需要展示的商品。也可以按需配置权益展示、支付方式等,完成之后点击 页面底部保存按钮。商品选项前的箭头符号可以拖动调整展示顺序。
付费界面创建之后,付费界面ID和别名可用于后续API集成。
在付费界面详情页面,点击右上角预览按钮,即可用测试账号进入用户付费页面,尝试各项功能。
API集成
用户交互流程
当用户访问你的网站App时,调用艺爪付费的接口,获取用户会员信息和付费界面链接,根据返回信息判断用户可享受的权益,并展示在界面上。
当用户点击会员按钮时,跳转到付费界面链接,或通过 Window.open / Webview 加载链接。用户可以在付费界面充值,使用兑换码,查看账单等。
当用户离开付费界面(例如关闭Webview),或回到产品界面继续操作时(例如窗口激活),再次请求接口获取最新会员信息,更新界面展示。
调用API接口
用户身份标识
艺爪付费需要一个唯一ID作为用户身份标识(商户系统用户ID),用户的会员到期时间、余额、账单都和用户ID绑定。
如果你的产品有登录注册功能,那么用户ID可以作为用户身份标识。如果是免登录的客户端应用,可以用设备ID作为用户身份标识。
假如你有多个项目,如果使用的是同一套账户系统,那么不会有问题。你系统中每个用户都唯一对应一个艺爪付费的账户,通过用户ID可以查询该用户在所有项目中的会员信息。
但如果你使用的是不同的账户系统,即产品A的用户和产品B的用户信息不互通,那么需要给用户ID加上产品特定的前缀,确保产品A的用户ID和产品B的用户ID不会重复。
场景和接口使用
如果你的产品是「订阅/永久会员」模式的,只需要调用 获取用户信息 接口,根据接口文档展示会员信息即可。
如果你的产品是「积分/消耗品」模式的,那么还需要调用 用户进行消费 接口,根据接口文档进行扣费操作。
接口调用方式及鉴权,可参照 API集成 文档,里面也有代码示例。
大功告成
恭喜你,已经完成接入了!
接下来可以按需查看文档的任意部分,例如价格表、订单管理、兑换码等功能。
如果接入和使用中遇到任何问题,可随时 联系我 解决。