Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Ring

Billing Setup and Testing Subscriptions

How billing setup works

If you plan to publish a paid public app, you need to set up billing with Ring. Free apps and private apps don't need billing setup.

The Ring Appstore Onboarding Team will email you a link to the billing onboarding form at the email address on your Ring Developer Portal account. If you haven't received it, contact Developer Support.

Before you fill out the form, check that your app meets these requirements:

  • US legal entity and bank account. Billing onboarding requires a US legal entity and a US bank account that can receive USD payouts from Stripe. A US LLC owned by a non-US resident qualifies. If you're an individual in the US, enter your full legal name as the Company Name. If you don't have a US entity and bank account, you can launch your app for free and add paid billing later.
  • One plan per app. Each app has one plan, at one fixed monthly price per device or per location. Annual and tiered pricing aren't available.
  • Free trial. Your plan can have a free trial of 1–30 days, or no trial.
  • App and plan names. Customers see both names, so neither can include "Ring", "Amazon", or any other Amazon brand or trademark. Include your app name in your plan name.
  • Supported devices. Your app must work with Ring cameras, doorbells, or both.
  • Price changes. After your app is live, a price change can take 45 days or more to take effect, so choose your price carefully.

Billing setup has three steps:

  1. Fill out the billing onboarding form using the link in that email, with your app's billing and pricing information.
  2. Complete your tax interview. The team will email you a link to your tax interview.

    Important: Use only the link in that email, not the tax interview link in the Ring Developer Portal. Using the wrong link may delay your setup.

  3. Fill out the Stripe onboarding questionnaire. The team emails it to you as your last step. It sets up your Stripe account so you can receive payouts.

After you complete the Stripe questionnaire, our team finishes setting up your plan. You'll get an email when billing setup is complete, and a final approval email after that.

Questions about billing setup? Contact Developer Support.

Testing subscriptions

Current limitation: You can't test subscriptions yet when testing your app before certification. The staging users you add on the Test page don't receive subscription_activated or subscription_deactivated webhooks, and GET /v1/accounts/me/subscriptions returns no active subscriptions for them. We're adding support so you can test the subscription flow before certification. This page will be updated when it's available.

Until then, you can test your subscription handling this way:

  1. Handle the no-subscription case. When testing your app, it sees no active subscription. Make sure it handles that state cleanly, and give your own test accounts a way to reach subscription-gated features, such as an allowlist.
  2. Test your webhook handler with sample payloads. Send the sample payloads from Subscription Activated and Subscription Deactivated to your webhook endpoint, signed with your HMAC key. This checks signature verification and your grant and revoke logic.
  3. Explain subscription behavior to reviewers. In the certification reviewer notes, describe what your app does with and without an active subscription.
  4. Test real subscriptions with a beta rollout. After your app is certified and billing setup is complete, publish it as a beta rollout and join it with your own Ring account. Beta testers go through the real trial and subscription flow, so you'll receive subscription_activated and see the subscription in the Subscriptions API. If your plan has a free trial, cancel before it ends to avoid being charged, and confirm you receive subscription_deactivated. Then move to a gradual or full rollout.