PayPal Payment Setup Tutorial

Learn how to integrate PayPal to accept PayPal account, credit card, and digital wallet payments through PayPal.

Prerequisites

  • Gustaio account with restaurant profile set up
  • Complete business information (required for PayPal business account)
  • Bank account for receiving payments
  • Valid business documents for verification

Step 1: Create PayPal Business Account

  1. Sign Up for PayPal Business

  2. Business Information

    • Business name (must match your legal business name)
    • Business type: Restaurant/Food Service
    • Business address
    • Tax ID/EIN (if applicable)
    • Website URL (your Gustaio domain)

  3. Verify Business Information

    • Upload required business documents
    • Verify bank account
    • Complete identity verification
    • Confirm email address

Step 2: Complete Business Profile

Before connecting to Gustaio, ensure your profile is complete:

Required Information

  1. Business Details

    • Legal business name
    • Business address (complete and accurate)
    • Phone number
    • Business email
    • Website URL

  2. Industry Information

    • Business category: Food & Beverage
    • Sub-category: Restaurant/Food Delivery
    • Business description

  3. Financial Information

    • Bank account details
    • Expected monthly volume
    • Average transaction amount

Missing Information Errors

If you receive "Missing required information" errors:

  1. Check Required Fields

    • Ensure all mandatory business profile fields are completed
    • Verify address format matches PayPal requirements
    • Update any incomplete sections

  2. Common Missing Fields

    • Complete business address
    • Phone number verification
    • Business description
    • Industry categorization

Step 3: Connect PayPal to Gustaio

  1. Navigate to Payments

    • Go to Gustaio Dashboard
    • Click "Shop" → "Payments"
    • Find "PayPal Payments" section

  2. Connect PayPal Account

    • Click "Connect PayPal"
    • You'll be redirected to PayPal's onboarding
    • Log in to your PayPal business account

  3. Grant Permissions

    • Review permissions requested by Gustaio
    • Grant access for:
      • Payment processing
      • Refund processing
      • Transaction information
      • Account information

  4. Complete Integration

    • Follow PayPal's onboarding wizard
    • Confirm integration details
    • Return to Gustaio dashboard

Step 4: PayPal Account Verification

Integration Status

After connecting, PayPal will review your integration:

  1. Pending Review

    • Initial status shows "Integration Pending"
    • PayPal reviews business information
    • Process typically takes 1-3 business days

  2. Capability Requirements

    • PAYMENTS_RECEIVABLE: Ability to receive payments
    • PRIMARY_EMAIL_CONFIRMED: Email verification completed

Common Capability Issues

If you see capability warnings:

  1. Email Not Confirmed

    • Check PayPal account email verification
    • Confirm primary business email
    • Complete email verification if needed

  2. Business Verification Incomplete

    • Upload required business documents
    • Complete identity verification
    • Provide additional information if requested

Step 5: Enable PayPal in Gustaio

  1. Payment Methods Configuration

    • Go to Dashboard → Shop → Payment Methods
    • Find "PayPal" option
    • Toggle to "Enabled"

  2. Test Integration

    • Save payment method settings
    • Visit your restaurant website
    • Test ordering process with PayPal

Step 6: Test PayPal Payments

Sandbox Testing

PayPal provides sandbox accounts for testing:

  1. Create Sandbox Accounts

    • Go to developer.paypal.com
    • Create test buyer and seller accounts
    • Use sandbox credentials for testing

  2. Test Payment Flows

    • PayPal account payments
    • Guest checkout with credit cards
    • Mobile wallet payments

Test Scenarios

  1. Successful Payments

    • Complete checkout with test PayPal account
    • Test guest checkout with test card
    • Verify orders appear in Gustaio dashboard

  2. Error Scenarios

    • Insufficient funds
    • Declined cards
    • Cancelled payments

Live Testing

When ready for real payments:

  1. Small Test Transaction

    • Make small purchase with real PayPal account
    • Verify payment processing
    • Check payout to your bank account

  2. Refund Test

    • Process test refund through Gustaio
    • Verify refund appears in PayPal account
    • Confirm customer receives refund

Step 7: Configure PayPal Settings

Payment Settings

  1. Accepted Payment Types

    • PayPal account balance
    • Credit and debit cards
    • Bank transfers (where available)
    • PayPal Credit (where available)

  2. Checkout Experience

    • Express Checkout for faster payments
    • Guest checkout enabled
    • Mobile-optimized checkout

Payout Settings

  1. Automatic Transfers

    • Set up automatic bank transfers
    • Choose transfer frequency (daily/weekly)
    • Configure minimum transfer amount

  2. Currency Settings

    • Set primary currency
    • Enable multi-currency if needed
    • Configure exchange rate preferences

Transaction Fees

PayPal Standard Fees

  • Domestic: 2.49% + €0.35
  • International: 3.4% + €0.35
  • PayPal Express: 2.99% + €0.35
  • Micropayments: 5% + €0.05 (transactions under €12)

Additional Fees

  • Chargebacks: €18 per dispute
  • Refunds: No additional fee (original fee not returned)
  • Currency Conversion: 2.5% above base exchange rate
  • Receiving Payments: No additional fee

Common Issues & Solutions

"PayPal Not Connected" Error

Problem: Integration shows as disconnected

Solutions:

  • Re-authorize Gustaio in PayPal account settings
  • Check that business account is in good standing
  • Verify all required permissions were granted
  • Contact support for reconnection

"Account Under Review" Status

Problem: PayPal account under review, payments failing

Solutions:

  • Complete all verification requirements
  • Respond to PayPal emails requesting information
  • Provide additional business documentation
  • Contact PayPal merchant support

High Fee Rates

Problem: Transaction fees higher than expected

Solutions:

  • Verify account type (business vs personal)
  • Check if international fees apply
  • Review PayPal rate structure for your region
  • Consider PayPal Pro for lower rates with volume

Customer Payment Issues

Problem: Customers cannot complete PayPal payments

Solutions:

  • Check PayPal system status
  • Verify integration is approved and active
  • Test payment flow yourself
  • Review PayPal transaction logs

Advanced Configuration

Webhooks (Automatic)

Gustaio automatically configures webhooks for:

  • Payment confirmations
  • Payment cancellations
  • Refund notifications
  • Dispute notifications

Recurring Payments

For subscription-based services:

  • Set up recurring payment profiles
  • Configure billing cycles
  • Handle failed recurring payments

Multi-Currency Support

For international customers:

  • Enable additional currencies
  • Set currency conversion preferences
  • Display prices in local currencies

Best Practices

Security

  1. Account Security

    • Use strong passwords
    • Enable two-factor authentication
    • Monitor account activity regularly

  2. Transaction Monitoring

    • Review transaction reports daily
    • Watch for unusual activity patterns
    • Set up email alerts for large transactions

Customer Experience

  1. Clear Payment Options

    • Display PayPal logo prominently
    • Offer both PayPal and guest checkout
    • Provide clear payment instructions

  2. Mobile Optimization

    • Test PayPal checkout on mobile devices
    • Ensure responsive design
    • Optimize for one-touch payments

Financial Management

  1. Reconciliation

    • Download daily transaction reports
    • Match PayPal settlements to bank deposits
    • Track fees and net revenues

  2. Dispute Management

    • Respond quickly to disputes
    • Provide detailed transaction information
    • Maintain good seller metrics

Monitoring & Maintenance

Regular Checks

  1. Account Health

    • Monitor account limitations
    • Check verification status
    • Review performance metrics

  2. Integration Status

    • Verify webhook functionality
    • Test payment processing
    • Check connection status

PayPal Dashboard Monitoring

  1. Transaction Overview

    • Daily payment volume
    • Success/failure rates
    • Average transaction value

  2. Account Performance

    • Dispute rates
    • Refund rates
    • Customer satisfaction scores

Support Resources

PayPal Support

Gustaio Integration Support

  • Contact through Gustaio dashboard
  • Include PayPal merchant ID in support requests
  • Provide specific error messages and screenshots

Documentation

PayPal integration provides customers with familiar, trusted payment options while offering you secure payment processing with comprehensive fraud protection.

We use cookies

We use tracking cookies (like Google Analytics) to understand how you interact with our website, which helps us to improve your experience. Are you okay with that? You can view our Privacy Policy for more details.