Add payments to your app

1. 1

   Tell Lovable you want to add payments, for example, by describing the pricing you want to offer.

   This initiates the payment setup process and helps Lovable recommend the best provider for your needs.

2. 2

   Review the feature overview and click 'Continue' in the 'Enable payments' dialog.

   This confirms you understand the provider's features and pricing before proceeding.

3. 3

   Fill out the account setup form with your email and name, and agree to the provider's policies.

   This creates your account with the chosen payment provider (Paddle or Stripe).

4. 4

   Tell Lovable what products and prices you want to sell, like 'Create three pricing tiers: Starter at $9/month, Pro at $29/month, and Enterprise at $99/month.'

   This sets up your offerings, builds your checkout flow, and adds the necessary user interface components to your app.

5. 5

   Test your payment flow in the preview using the provided test card numbers.

   This ensures your app's logic works correctly, features unlock as expected, and transactions appear in the Payments tab before you accept real money.

6. 6

   When ready, open the Payments tab and follow the 'go-live' checklist to complete verification and publish your app.

   This enables your app to accept real payments from customers.

I want to add payments to my app. I'm selling a digital course for $197. Set up checkout and make sure I can test it before going live.

Merchant of Record (MoR)

This is the legal business that is officially responsible for processing payments, handling taxes, and making sure everything follows the rules. When a payment provider acts as an MoR, they are legally the seller, and they manage all the financial and legal details for you.

PSP

Payment Service Provider. This is a company that helps businesses accept electronic payments, like credit card payments. They handle the technical side of moving money from the customer to your bank, but you are still responsible for taxes and compliance.

Webhook

A webhook is an automatic message sent from one app to another when a specific event happens. In payments, webhooks tell your app when a payment is successful, a subscription renews, or a refund occurs, so your app can react accordingly.

API keys

These are secret codes that act like a password, allowing your Lovable app to securely communicate with the payment provider's services.

Environment variables

These are special settings or values that your app can use, like API keys or other configuration details, which are kept separate from your main code for security and flexibility.

KYC/KYB

Know Your Customer / Know Your Business. This refers to the process where financial institutions verify the identity of their customers or businesses to prevent fraud and illegal activities.

• Do not try to sell physical products using built-in payments if you need inventory and logistics management; use the Shopify integration instead.
• Do not attempt to set up payments if you are not on a Pro plan or higher, or if your project uses your own Supabase backend instead of Lovable's built-in backend.
• Do not expect to set up payments if you are not a project admin/owner or workspace admin/owner.
• Do not edit products directly in your payment provider's dashboard after setting them up through Lovable, as this can cause issues with your Lovable project.
• Do not delete or disable the webhook endpoints Lovable registers in your payment provider's dashboard, as this will prevent payment events from reaching your app and unlocking features.