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.