In order for your clients to purchase access to your AI Expert, you need to connect your BuddyPro instance to your payment system. This allows you to automate sales, subscription and access management.

19.1 Integration with Stripe

A) Link your Stripe account to your BuddyPro instance:

• In your BuddyPro instance (in a Telegram chat with your AI Expert), enter the following command:

  /setupStripe
  

• After successfully entering this command, your BuddyPro instance will send you a link. Click on that link to connect your Stripe account with Buddy Pro. If you don’t have a Stripe account yet, you will be able to create one.

B) Example Buddy Pro products will be generated

• Buddy will generate 4 products for you, together with example pricing and payment links:
  • Monthly subscription: $149 / month → 1000 messages per month
  • Quarterly subscription: $399 / 3 months → 1000 messages per month
  • Annual subscription: $1149 / year → 1000 messages per month
  • Extra Messages: $69 → 500 additional messages with no expiration
    • ⚠️ IMPORTANT: Packages are only for existing subscribers who run out of monthly messages. They cannot be purchased without an active subscription.
• You can find the generated products here: https://dashboard.stripe.com/products
• You can find the generated payment links here: https://dashboard.stripe.com/payment-links

C) Adjust the pricing, monthly messages limits and name of the products according to your needs. Or create your own products and payment links if needed.

• If you want to change price of the example product, you must create a new Price on the product and then create a new payment link, choosing that price.

• Your Buddy Pro products inside Stripe must always have these metadata fields, which identify them as a Buddy Pro product (already set for the example products):

  case: buddy_pro
  messages: 200 (any number, up to you)
  

  

• The value 'messages' is a monthly limit of messages in a conversation (for subscriptions) or how many total messages are granted to the user (for packages).

• Both messages from user and from Buddy are counted towards the limit.

• The monthly limit is applied also on annual/quarterly subscriptions to avoid using up too many messages during a single month.

• Messages bought in a package do not have an expiration date.

• ‼️ When you’re creating your own product for a package, you need to allow creating a Post-payment invoice in the payment link settings

  • How to enable Post-payment invoice

D) Additional commands to manage invoices:

• /processStripePaymentManually:{paidInvoiceId}
  • This command is used to process the payment manually if automatic processing via webhook fails for some reason. Only use it if your BuddyPro instance or support prompts you to do so.

⚠️ WARNING ON MANUAL ADJUSTMENTS IN STRIPE: We strongly advise against making manual adjustments in Stripe to automatically issued (especially recurring) invoices to your clients for BuddyPro services (e.g. manually changing the billing period, moving the due date, adjusting the price on an already issued invoice, etc. without a deep understanding of how the integration works and what the implications may be). The BuddyPro platform may not be aware of these manual changes you are making in Stripe and may not sync with them properly, which can lead to issues with activating or deactivating access for the client.

Frequently Asked Questions (FAQ) for Stripe:

• How is the Buddy Pro subscription or package delivered to the user who buys it?
  • After the user buys your subscription or package, we automatically send them an activation email from our server with a button to activate their purchase.
  • If user is buying from within the Telegram chat with your Buddy Pro, the purchase might be activated automatically without the need to click on the activation email.
• What if I want to offer multiple tariffs on one of my web pages (signposting)?
  • If a user comes to your signpost from BuddyPro (e.g. after exhausting the trial), it is crucial that the client_reference_id parameter from the original URL is carried over to the Stripe payment links leading from the signpost to the individual Stripe checkouts. For more detailed information on this technical solution, see Step 20.3 Important Solution for Multi-Tariff ROSTERS.

<aside> 👇

If you implemented Stripe, continue to the next step and skip the FAPI alternative.

</aside>