HomeIntroductionFeaturesIntegrations

My Account

PayPal Integration

Integrations • PayPal Integration

PayPal Integration with biela.dev


The PayPal integration enables secure online payments for your biela.dev projects.
 Once connected, you can accept one-time or recurring payments directly from your app or website using PayPal’s trusted checkout flow.

This guide will walk you through:
  • Setting up a PayPal Business account
  • Connecting your credentials securely to biela.dev
  • Adding PayPal checkout buttons
  • Testing payments in sandbox mode
  • Switching to live production payments



Prerequisites

Before starting, make sure you have:
  • A project created in biela.dev
  • A PayPal Business Account
  • Access to your PayPal Developer Dashboard (developer.paypal.com)
  • Basic understanding of your app’s payment flow (what users pay for)



Step-by-Step Integration


Step 1. Create a PayPal Business Account

To start accepting payments, you’ll need a verified PayPal Business account.

  1. Visit paypal.com/business
  2. Click Sign Up → choose Business Account
  3. Complete your business profile and verify your email
  4. Link your preferred bank account to receive payouts

⏱ Takes around 10–15 minutes to complete.


Step 2. Get Your PayPal API Credentials

Your Client ID and Client Secret allow biela.dev to connect your app securely to PayPal.

2. Go to Dashboard → My Apps & Credentials
3. Under REST API Apps, click Create App
4. Choose a name (for example: “MyApp Payments”)
5. Select your Business Account
6. Click Create App
7. Copy and securely store
  • Client ID
  • Client Secret

You’ll use these credentials later when connecting PayPal to biela.dev.


Step 3. Connect PayPal to biela.dev

biela.dev handles the integration scaffolding for you. Here’s how to set it up:

1. Open your project in biela.dev
2. Go to Integrations → Add Integration
3. Select PayPal
4. In the configuration window, enter:
  • Client ID (from Step 2)
  • Client Secret
  • Mode: Sandbox (for testing) or Live (for production)
5. Click Connect Integration

biela.dev automatically stores your credentials securely in your project’s environment variables.
No manual code handling required.


Step 4. Add a PayPal Checkout Button

Once the integration is connected, generate your PayPal checkout component.

1. In biela.dev → Integrations → PayPal, click Generate Checkout Component
2. Choose your payment type:
  • One-time payment
  • Subscription (recurring)
3. Enter:
  • Item Name (e.g., “Pro Plan”, “Course Enrollment”)
  • Amount
  • Currency
4. biela.dev automatically creates the payment component in your project.
5. Deploy your project or preview it.

The generated checkout button uses the official PayPal JavaScript SDK for secure transactions.



Step 5. Test Payments (Sandbox Mode)

Before going live, test payments safely using PayPal’s Sandbox Environment.
In your PayPal Developer Dashboard, create:

1. In your PayPal Developer Dashboard , create:
  • Sandbox Business Account
  • Sandbox Buyer Account
2. In biela.dev, set your integration mode to Sandbox
3. Use your Buyer Account to simulate transactions

Verify that:
  • Payments complete successfully
  • Your app handles errors gracefully
  • Post-payment actions (like enrollment, access unlocks, etc.) trigger correctly


Step 6. Go Live with Real Payments

After confirming your sandbox setup works perfectly:

  1. In your PayPal app settings, switch Mode → Live
  2. Replace sandbox credentials in biela.dev with your Live Client ID and Client Secret
  3. Redeploy your project

Your app will now start processing real PayPal payments.

  ⚠️ Make sure you’ve linked a verified bank account to your PayPal Business profile before accepting real payments.  


Managing Payments and Transactions

Once integrated, you can view and manage payments in two places:

In PayPal:
  • PayPal Dashboard
  • View completed, pending, or refunded transactions
  • Download transaction reports for accounting

In Your biela.dev Project:
  • View payment logs (successful or failed)
  • Track users and their payment status
  • Connect workflows (e.g., trigger access, send emails, etc.)


Advanced Features (Optional)

After the basic integration, you can extend functionality easily with biela.dev prompts.

1. Subscriptions
Prompt:

Prompt
Please enable PayPal subscription payments in my project for recurring plans.


2. Refund System
Prompt:

Prompt
Add refund functionality to my PayPal integration so I can process refunds directly from my app dashboard.


3. Payment Confirmation Emails
Prompt:

Prompt
After each successful PayPal payment, send an automated confirmation email to the customer.


Troubleshooting


Button not appearing?

Prompt:

Prompt
The PayPal checkout button isn’t showing on my page.


Payment goes through but no post-payment action triggers?

Prompt:

Prompt
PayPal payments are working, but my post-payment workflow (e.g., granting access) isn’t triggered.
Please review the success callback.



Amounts incorrect?

Prompt:

Prompt
The PayPal checkout amount doesn’t match my intended price.
Please fix the payment configuration.


Final Checklist


  • PayPal Business account created and verified
  • Client ID and Secret generated
  • Added credentials in biela.dev integration settings
  • Checkout component generated
  • Payments tested in Sandbox mode
  • Post-payment actions verified
  • Switched to Live mode
  • Real payments confirmed successfully

That’s It!


Your biela.dev project can now securely accept PayPal payments with minimal setup.

You can now:

  • Accept one-time or recurring payments
  • Automate workflows post-purchase
  • Track all transactions easily
  • Extend functionality with a single prompt

Next Steps:
 Explore advanced automations in biela.dev to connect your PayPal events with your app logic no backend code required.

Previous

Supabase Integration

Next

Custom Domain Integration

Article 3 of 4 in Integrations