跳到主要内容

快速开始

欢迎来到艺爪付费,我们快速开始吧!

创建项目

项目

一个项目对应你的一个产品。跨平台的产品,例如一个Android/iOS/Web多平台的产品,算做一个项目。

进入 艺爪付费后台 界面,点击首页右上角,创建项目。

  • 名称:项目名称(产品名称/应用名称)。
  • Server酱SendKey:消息通知渠道,可选,从 https://sct.ftqq.com/ 获取。

项目创建之后,会显示项目ID和API密钥,用于后续API集成。

创建权益

权益

用户可享受的一种权益类型,例如:会员、积分。

权益可以配置初始值,例如:免费试用时长、免费试用积分。

一个产品可以有多种权益,例如:功能1会员、功能2会员、普通会员、高级会员。

权益分组

每个权益都必须分配到一个权益分组,一个权益分组包含多个具有不同级别的权益,例如:普通会员、高级会员。用户从一个分组中只能获得其中一个权益,或者从低级别权益升级到更高级别的权益。

每种权益类型都有一个默认分组,如果创建权益时没有分配权益分组,则会分配到相应的默认分组。

后台界面首页点击权益,进入权益页面。

权益列表

创建权益,例如:名称填写「会员」,初始余额填写「30d」。权益ID和别名可用于后续API集成。

权益详情

创建商品

商品

用户可以购买的商品,一个商品可以包含一个或多个商品权益。

例如:单月会员,包含30天会员权益;一年会员,包含365天会员权益。

商品权益

表示具体权益的数量,用户购买商品后获得,例如:30天会员权益,100积分权益。

后台界面首页点击商品,进入商品页面。

商品列表

  1. 创建商品,例如:「一年会员」和「单月会员」,选择价格。可在 价格表 页面配置价格选项。
  2. 创建商品之后,商品页面下方添加商品权益,例如:权益「会员」,时长「365d」,保存。

商品详情

商品展示效果如下图所示,底部划线价和底部提示语展示在同一个位置,同时配置时只展示底部提示语。

商品预览

支付渠道

艺爪付费支持多种 支付渠道,为方便快速上手,我们从微信收款码渠道开始。

后台界面首页点击支付渠道,进入支付渠道页面,点击右上角「+」号,创建支付渠道。

名称填写「微信收款」,类型「简易-微信」,然后点击不定额收款码右侧上传按钮,上传一张微信收款码图片。也可以继续添加固定金额的收款码。

微信收款码图片可以在微信「收付款 -> 二维码收款」中下载。未设置金额的即为不定额收款码,用户支付时可以选择任意金额。

微信收款-支付渠道

付费界面

付费界面

用户付费界面,可以配置商品展示、支付方式等。

后台界面首页点击商品,进入商品页面。点击付费界面「添加」按钮,创建付费界面。

名称可填写「我的会员」,在商品展示下方,选择需要展示的商品。也可以按需配置权益展示、支付方式等,完成之后点击页面底部保存按钮。商品选项前的箭头符号可以拖动调整展示顺序。

付费界面

付费界面创建之后,付费界面ID和别名可用于后续API集成。

在付费界面详情页面,点击右上角预览按钮,即可用测试账号进入用户付费页面,尝试各项功能。

付费界面

API集成

用户交互流程

当用户访问你的网站App时,调用艺爪付费的接口,获取用户会员信息和付费界面链接,根据返回信息判断用户可享受的权益,并展示在界面上。

会员充值按钮

当用户点击会员按钮时,跳转到付费界面链接,或通过 Window.open / Webview 加载链接。用户可以在付费界面充值,使用兑换码,查看账单等。

当用户离开付费界面(例如关闭Webview),或回到产品界面继续操作时(例如窗口激活),再次请求接口获取最新会员信息,更新界面展示。

调用API接口

用户身份标识

艺爪付费需要一个唯一ID作为用户身份标识(商户系统用户ID),用户的会员到期时间、余额、账单都和用户ID绑定。

如果你的产品有登录注册功能,那么用户ID可以作为用户身份标识。如果是免登录的客户端应用,可以用设备ID作为用户身份标识。

用户身份标识

假如你有多个项目,如果使用的是同一套账户系统,那么不会有问题。你系统中每个用户都唯一对应一个艺爪付费的账户,通过用户ID可以查询该用户在所有项目中的会员信息。

但如果你使用的是不同的账户系统,即产品A的用户和产品B的用户信息不互通,那么需要给用户ID加上产品特定的前缀,确保产品A的用户ID和产品B的用户ID不会重复。

场景和接口使用

如果你的产品是「订阅/永久会员」模式的,只需要调用 获取用户信息 接口,根据接口文档展示会员信息即可。

如果你的产品是「积分/消耗品」模式的,那么还需要调用 用户进行消费 接口,根据接口文档进行扣费操作。

接口调用方式及鉴权,可参照 API集成 文档,里面也有代码示例。

大功告成

恭喜你,已经完成接入了!

接下来可以按需查看文档的任意部分,例如价格表、订单管理、兑换码等功能。

如果接入和使用中遇到任何问题,可随时 联系我 解决。