Skip to content

PayPal (guest payments)

Connect PayPal Business via PayPal Connect OAuth in Settings → Payments for guest checkout. Separate from Zyelra SaaS billing.

Available with provider requirementsSupported, but an external account or verification is required.

What this connection does

PayPal guest payments connect your PayPal Business merchant account through OAuth so guests can pay stays via PayPal checkout.

Before you start

  • A PayPal Business account eligible for Commerce / partner Connect onboarding.
  • Permission to manage Settings → Payments.

PayPal multiparty / partner docs (official) ↗

Connect PayPal

  1. Step 1In provider

    Prepare PayPal Business

    Sign in to PayPal Business and complete any required business verification before connecting a partner app.

  2. Step 2In Zyelra

    Open Settings → Payments → PayPal

    Go to Settings → Payments and choose Connect PayPal account.

  3. Step 3In provider

    Complete PayPal Connect OAuth

    Authorize Zyelra on PayPal’s consent screens. Do not paste fabricated client secrets into the agency UI — OAuth establishes the merchant link.

  4. Step 4In provider

    Webhook (platform)

    PayPal payment events POST to {your Zyelra API base URL}/api/v1/webhooks/payments/paypal. Zyelra verifies PayPal payment notifications.

  5. Step 5In Zyelra

    Test guest checkout

    Run a test payment and confirm status updates in the stay / payment UI.

POST {your Zyelra API base URL}/api/v1/webhooks/payments/paypal

Verify

  1. PayPal shows connected in Settings → Payments.
  2. Guest checkout can complete with PayPal.
  3. Payment status updates after webhooks.

Troubleshooting

  • OAuth failed — restart Connect PayPal; confirm you used a Business account.
  • Needs attention — reconnect from Settings → Payments.
  • Confused with Billing — SaaS subscription settings live under Settings → Billing.

Security

Next step

Find setup steps for other messaging, payment, calendar, and channel connections.

Browse more integration guides →

Related guides

  • Integrations overview

    Hub for Zyelra integrations: email, SMS, WhatsApp, calendar, OTAs, guest payments, and AI — plus links to the Developer API and webhooks for custom connections.

  • Stripe (guest payments)

    Prefer Finance → Collection payments and guest payment links (Zyelra-managed). Connect Stripe via Stripe Connect OAuth in Settings → Payments → Advanced only for legacy stay checkout. Separate from Zyelra SaaS billing.

  • Paystack (guest payments)

    Connect a Paystack subaccount code from your Paystack dashboard so guests can pay through Paystack checkout. Manual connect — not SaaS billing.

  • Guest payments

    Collect guest stay payments through connected providers in Settings → Payments — separate from agency Billing.

  • Plans, subscription, and access

    Manage your Zyelra agency plan, subscription, invoices, and feature access under Settings → Billing.