跳转到内容
ASO.dev ASO.dev

收入集成：Stripe、Paddle、RevenueCat、Shopify 等 | ASO.dev

开发中  即将上线

将收入数据源连接到 ASO.dev，用于验证 MRR、分析 retention，并保持 subscription metrics 同步。

这些集成指南专注于 read-only、report-only 或 analytics-only access。有些 provider 支持明确的 read-only scopes；有些 provider 使用没有细粒度 read-only scopes 的 API keys。在这种情况下，ASO.dev 应仅在服务端保存 key，并只将其用于验证读取。

支持的收入集成

Section titled “支持的收入集成”
  • App Store Connect
  • Google Play
  • RevenueCat
  • Stripe
  • Lemon Squeezy
  • Paddle
  • Adapty
  • Shopify
  • Chargebee

以只读模式连接 Google Play

按照以下流程通过 ASO.dev 连接 Google Play 收入报表：

  1. 登录你的 ASO.dev 账号。
  2. 打开 Dashboard -> List Startup。
  3. 选择 Google Play 作为数据源。
  4. 为 ASO.dev 创建 Google Cloud service account。
  5. 在 Play Console 中打开 Users and permissions，邀请 service account email。
  6. 授予财务数据所需的读取和报表权限。
  7. 下载 service account JSON key 并上传到 ASO.dev。
  8. 输入 developer bucket ID，例如 pubsite_prod_rev_0123456789。
  9. 如果希望 ASO.dev 先同步单个应用，请输入 package name。
  10. 等待 1-10 分钟完成首次同步。

必填字段

  • Business Name：ASO.dev 应为此收入源展示的公开名称。
  • Service Account JSON：服务端使用的 Google Cloud service account key。
  • Developer Bucket ID：私有 Google Cloud Storage 报表 bucket，通常为 pubsite_prod_rev_...。
  • Package Name：可选，但建议用于应用级验证。

推荐 Play Console 权限

  • 全局访问权限下的 View app information and download bulk reports (read-only)。
  • 全局访问权限下的 View financial data, orders, and cancellation survey responses。

对于应用级访问，Google Play 也提供 View financial data，但从 Google Cloud Storage 下载财务报表需要在正确范围内拥有财务访问权限。

API / 报表详情

  • 财务和销售报表存储在私有 Google Cloud Storage bucket 中。
  • 程序化下载使用 OAuth2 server-to-server auth，并使用 Google Cloud Storage 只读 scope：https://www.googleapis.com/auth/devstorage.read_only。
  • Estimated sales reports 每日生成。
  • Earnings reports 通常在月初附近生成。

此连接包含的数据

  • Google Play estimated sales reports
  • Earnings reports
  • 可用时的订阅统计报表
  • Google Play 报表中包含的退款和订单相关财务行

ASO.dev 不会做什么

  • 请求 Google 账号密码
  • 请求应用发布权限
  • 上传 release 或编辑商店 listing
  • 退款订单或取消订阅
  • 修改 monetization products 或价格

以只读模式连接 App Store Connect

按照以下流程通过 ASO.dev 连接 App Store Connect 收入报表：

  1. 登录你的 ASO.dev 账号。
  2. 打开 Dashboard -> List Startup。
  3. 选择 App Store Connect 作为数据源。
  4. 在 App Store Connect 中打开 Users and Access -> Integrations -> App Store Connect API。
  5. 生成一个可访问 Sales and Trends reports 的新 API key。
  6. 复制 Issuer ID 和 Key ID。
  7. 下载 .p8 private key。
  8. 在 App Store Connect payments and proceeds 中找到 Vendor Number。
  9. 将凭据输入 ASO.dev，并等待 1-10 分钟完成首次同步。

必填字段

  • Business Name：ASO.dev 应为此收入源展示的公开名称。
  • Issuer ID：App Store Connect API issuer identifier。
  • Key ID：生成的 API key 标识符。
  • Private Key：从 App Store Connect 下载的 .p8 key。
  • Vendor Number：下载 Sales 和 Finance report 时必需。

API 详情

  • Sales reports endpoint：GET https://api.appstoreconnect.apple.com/v1/salesReports
  • Finance reports endpoint：GET https://api.appstoreconnect.apple.com/v1/financeReports
  • 认证方式：使用 App Store Connect API private key 签名的 JWT。
  • Sales reports 需要 filter[vendorNumber]、filter[reportType]、filter[reportSubType] 和 filter[frequency]。
  • Finance reports 需要 filter[vendorNumber]、filter[regionCode]、filter[reportType] 和 filter[reportDate]。

推荐访问权限

使用可以下载 Sales and Trends reports 的 API key / user access level。

如果 ASO.dev 需要 settled payout / proceeds 数据，该 key 还必须能够访问 Payments and Financial Reports。

此连接包含的数据

  • App Store sales 和 proceeds reports
  • 自动续订订阅报表
  • Subscriber 和 subscription event reports
  • Apple 报表中可用的退款和 proceeds 数据

ASO.dev 不会做什么

  • 请求 Apple ID 密码
  • 使用双重认证登录 session
  • 编辑 app、metadata、pricing、in-app purchases 或 subscriptions
  • 提交 build 或 release
  • 修改税务、银行或协议设置

以只读模式连接 RevenueCat

按照以下流程安全连接 RevenueCat：

  1. 从 ASO.dev 集成页面打开 RevenueCat 授权 URL。
  2. 登录 RevenueCat。
  3. 授予项目和客户指标的只读访问权限。
  4. 确认授权连接。
  5. 你会被重定向回 ASO.dev。
  6. 完成集成设置并选择要同步的项目。
  7. 初始数据通常会在 1-10 分钟内出现。

安全详情

  • 基于重定向的 OAuth 流程（authorization_code）。
  • 不需要分享密码。
  • 我们只请求：
    • project_configuration:projects:read
    • customer_information:customers:read
    • customer_information:subscriptions:read
    • customer_information:purchases:read
  • Public OAuth client 必须包含 PKCE：code_challenge 和 code_challenge_method=S256。
  • 服务端 confidential client 使用已注册的 client credentials 交换 authorization code。
  • 可以随时在 RevenueCat 中撤销访问权限。

ASO.dev 授权 URL

为 ASO.dev 生成 RevenueCat 授权 URL 时，请使用此模板：

https://api.revenuecat.com/oauth2/authorize?response_type=code&client_id=ASO_DEV_REVENUECAT_CLIENT_ID&redirect_uri=ASO_DEV_REDIRECT_URI_URL_ENCODED&scope=project_configuration%3Aprojects%3Aread%20customer_information%3Acustomers%3Aread%20customer_information%3Asubscriptions%3Aread%20customer_information%3Apurchases%3Aread&state=RANDOM_CSRF_STATE

对于 public client，请额外添加：

&code_challenge=PKCE_CODE_CHALLENGE&code_challenge_method=S256

你将获得什么

  • 安全同步的经常性收入历史。
  • 可用于验证和分析的 MRR 与流失数据。
  • 用于验证流程的争议和拒付可见性。

以只读模式连接 Stripe

按照以下步骤通过 ASO.dev 安全连接 Stripe：

  1. 登录你的 ASO.dev 账号。
  2. 打开 Dashboard -> List Startup。
  3. 选择 Stripe 作为数据源。
  4. 点击 Connect with Stripe，开始 Stripe Connect OAuth 授权。
  5. 选择要同步的 Stripe 账号。
  6. 在 Stripe 授权页面授予 ASO.dev 只读访问权限。
  7. OAuth 重定向后返回 ASO.dev。
  8. 完成 Startup 资料（URL、行业等）。
  9. 等待 1-10 分钟完成首次回填。

OAuth 详情

  • 授权端点：https://connect.stripe.com/oauth/authorize
  • 必需查询参数：response_type=code、client_id
  • 推荐查询参数：redirect_uri、scope=read_only、state
  • redirect_uri 必须在 Stripe 中注册，生产模式必须使用 HTTPS。
  • ASO.dev 应在重定向后校验返回的 state 和已授权的 scope。
  • 如果 Stripe 未授予 read_only，ASO.dev 应停止同步并要求用户重新连接。

此连接包含的数据

  • 月经常性收入（MRR）
  • 流失率和留存指标
  • 客户生命周期价值（LTV）
  • 争议和退款数据

ASO.dev 不会做什么

  • 存储完整银行卡号或 CVC
  • 在只读验证足够时请求写入权限
  • 创建扣款
  • 修改 Stripe 账号设置

使用 API key 连接 Lemon Squeezy

按照以下流程通过 ASO.dev 连接 Lemon Squeezy 收入数据：

  1. 登录你的 ASO.dev 账号。
  2. 打开 Dashboard -> List Startup。
  3. 选择 Lemon Squeezy 作为数据源。
  4. 在 Lemon Squeezy 中打开 Settings -> API。
  5. 为 ASO.dev 创建一个新的 API key。
  6. 复制 API key 并粘贴到 ASO.dev。
  7. 如果你的账号有多个 store，请选择要验证的 store。
  8. 等待 1-10 分钟完成首次同步。

必填字段

  • Business Name：ASO.dev 应为此收入源展示的公开名称。
  • Lemon Squeezy API Key：在 Lemon Squeezy settings 中创建的 API key。
  • Store ID：如果 ASO.dev 可以自动检测 stores，则为可选；多 store 账号建议填写。

API 详情

  • Base URL：https://api.lemonsqueezy.com/v1
  • 认证方式：Authorization: Bearer {api_key}
  • 必需 headers：Accept: application/vnd.api+json 和 Content-Type: application/vnd.api+json
  • API key 可以为 live mode 或 test mode 创建。
  • 生成的 API key 有效期为一年。

此连接包含的数据

  • Orders
  • Customers
  • Subscriptions
  • Subscription invoices
  • 可用时的 subscription items 和 usage records
  • Lemon Squeezy API 数据中可用的退款和取消信号

重要访问说明

Lemon Squeezy API keys 应作为 secret credentials 处理。Lemon Squeezy 的公开 API 文档没有描述类似 Stripe restricted keys 或 Chargebee read-only keys 的细粒度只读 API scopes。

ASO.dev 应仅将该 key 用于收入验证所需的读取操作，并且只在服务端保存。

ASO.dev 不会做什么

  • 创建 checkout links
  • 创建、更新、暂停、恢复或取消 subscriptions
  • 创建 discounts 或修改 license key
  • 修改 products、variants、files 或 store settings
  • 存储 Lemon Squeezy 账号密码

使用只读 API key 连接 Paddle

按照以下步骤通过 ASO.dev 连接 Paddle：

  1. 登录你的 ASO.dev 账号。
  2. 打开 Dashboard -> List Startup。
  3. 选择 Paddle 作为数据源。
  4. 在 Paddle 中打开 Developer Tools -> Authentication。
  5. 为 ASO.dev 创建一个新的 API key。
  6. 只选择收入验证所需的读取权限。
  7. 复制 API key 并粘贴到 ASO.dev。
  8. 完成 Startup 资料（URL、行业等）。
  9. 等待 1-10 分钟完成首次同步。

必需的 Paddle 权限

  • transaction.read
  • subscription.read
  • customer.read
  • adjustment.read

可选权限，取决于你希望 ASO.dev 显示多少商品目录细节：

  • product.read
  • price.read
  • discount.read
  • report.read

此连接包含的数据

  • 月经常性收入（MRR）
  • 流失率和留存指标
  • 客户生命周期价值（LTV）
  • 争议和退款数据

ASO.dev 不会做什么

  • 请求 Paddle 的 *.write 权限
  • 请求 payment_method.read
  • 创建扣款
  • 修改你的账号设置

连接 Adapty revenue analytics

按照以下流程通过 ASO.dev 连接 Adapty revenue analytics：

  1. 登录你的 ASO.dev 账号。
  2. 打开 Dashboard -> List Startup。
  3. 选择 Adapty 作为数据源。
  4. 在 Adapty 中打开 App Settings -> General -> API keys。
  5. 复制要验证的 production app 对应的 app-specific Secret API key。
  6. 将 key 粘贴到 ASO.dev。
  7. 选择要同步的 app、platform 和 date range。
  8. 等待 1-10 分钟完成首次同步。

必填字段

  • Business Name：ASO.dev 应为此收入源展示的公开名称。
  • Adapty Secret API Key：来自 Adapty App Settings 的 app-specific secret key。
  • App Name：如果 ASO.dev 可以自动检测 app，则为可选；多 app 账号建议填写。
  • Timezone：用于 analytics grouping 的可选 IANA timezone，例如 Europe/Berlin。

API 详情

  • Analytics Export API host：https://api-admin.adapty.io（根路径 / 不是公开页面，可能返回 404；请使用下面的完整 endpoints）。
  • Analytics endpoint：POST https://api-admin.adapty.io/api/v1/client-api/metrics/analytics/
  • Cohort endpoint：POST https://api-admin.adapty.io/api/v1/client-api/metrics/cohort/
  • LTV endpoint：POST https://api-admin.adapty.io/api/v1/client-api/metrics/ltv/
  • Retention endpoint：POST https://api-admin.adapty.io/api/v1/client-api/metrics/retention/
  • 认证 header：Authorization: Api-Key {YOUR_SECRET_API_KEY}
  • 必需 request header：Content-Type: application/json
  • 可选 timezone header：Adapty-Tz: Europe/Berlin

重要访问说明

Adapty 公开 API 文档描述了 secret 和 public API keys，但没有描述 Analytics Export API 的细粒度 read-only scopes。

ASO.dev 应仅将该 key 用于 analytics export 和收入验证请求。请将该 key 作为 secret credential 处理，仅在服务端保存；如果需要移除访问权限，请在 Adapty 中轮换该 key。

此连接包含的数据

  • Revenue analytics
  • 月经常性收入（MRR）
  • Lifetime Value（LTV）
  • Cohort 和 retention metrics
  • 可用时的 conversion 和 funnel metrics
  • 可用时按 store、country、product、paywall、placement 和 attribution 的 breakdowns

ASO.dev 不会做什么

  • 请求 Adapty 密码
  • 修改 paywalls 或 remote configs
  • 创建、更新或删除 profiles
  • 授予或撤销 access levels
  • 发送 set transaction
  • 修改 Adapty app settings

以只读模式连接 Shopify

按照以下流程通过 ASO.dev 安全连接 Shopify：

  1. 登录你的 ASO.dev 账号。
  2. 打开 Dashboard -> List Startup。
  3. 选择 Shopify 作为数据源。
  4. 输入你的 Shopify 店铺域名，例如 your-store.myshopify.com。
  5. 点击 Connect with Shopify，开始 Shopify OAuth 授权。
  6. 在 Shopify 中检查请求的只读权限。
  7. 批准连接。
  8. OAuth 重定向后返回 ASO.dev。
  9. 等待 1-10 分钟完成首次同步。

OAuth 详情

  • 授权端点：https://{shop}.myshopify.com/admin/oauth/authorize
  • Token 端点：https://{shop}.myshopify.com/admin/oauth/access_token
  • 必需查询参数：client_id、scope、redirect_uri、state
  • ASO.dev 必须校验 OAuth callback 的 hmac，验证 state，并确认 shop 主机名。

必需的 Shopify scopes

  • read_orders
  • read_customers

为了完整的历史收入验证，ASO.dev 应请求：

  • read_all_orders

Shopify 要求应用在请求 read_all_orders 前先通过 Partner Dashboard 审批。没有此 scope 时，Shopify 订单访问会受默认订单时间窗口限制。

可选 scope，取决于 ASO.dev 展示的数据：

  • read_products
  • read_discounts
  • read_shopify_payments_disputes

此连接包含的数据

  • 月经常性收入（MRR）
  • 扣除退款后的订单收入历史
  • 客户留存和 LTV 信号
  • 授予可选争议 scope 后的 Shopify Payments 争议数据

ASO.dev 不会做什么

  • 请求 Shopify 写入 scope
  • 创建、编辑、退款或取消订单
  • 修改产品、价格、折扣或店铺设置
  • 存储 Shopify 账号密码

使用只读 API key 连接 Chargebee

按照以下流程通过 ASO.dev 安全连接 Chargebee：

  1. 登录你的 ASO.dev 账号。
  2. 打开 Dashboard -> List Startup。
  3. 选择 Chargebee 作为数据源。
  4. 输入你的 business name。
  5. 输入 Chargebee site name，例如你的 Chargebee URL 是 acme.chargebee.com，则填写 acme。
  6. 在 Chargebee 中打开 Settings -> Configure Chargebee -> API Keys and Webhooks。
  7. 为 ASO.dev 创建一个新的 Read-only API key。
  8. 复制 API key 并粘贴到 ASO.dev。
  9. 等待 1-10 分钟完成首次同步。

必填字段

  • Business Name：ASO.dev 应为此收入源展示的公开名称。
  • Chargebee API Key：在 Chargebee 中创建的只读 API key。
  • Site Name：Chargebee 站点子域名，不包含 .chargebee.com。

API 详情

  • Base URL：https://{site}.chargebee.com/api/v2
  • 认证方式：HTTP Basic Auth
  • Username：Chargebee API key
  • Password：留空
  • Chargebee test site 和 live site 使用不同的 API key。

推荐 key 类型

如果 ASO.dev 需要完整的收入验证数据，请使用 Read-only: All。

只有在 restricted read-only access 包含订阅、客户、发票、credit notes、订单、交易和事件等必要账单数据时，才使用受限只读访问。

此连接包含的数据

  • 月经常性收入（MRR）
  • 订阅和发票历史
  • 客户留存和 LTV 信号
  • 退款、credit notes 和交易事件

ASO.dev 不会做什么

  • 请求 full-access API key
  • 创建、更新、取消或暂停订阅
  • 创建发票、扣款、退款或 credit notes
  • 修改 plans、products、coupons 或账号设置
打开 ASO.dev 工具