Skip to content

Payments troubleshooting

Separate guest payment failures from agency Billing problems and fix connected provider checkout issues.

Problem

Guests cannot pay, stays stay Unpaid, or admins confuse guest Payments with Zyelra Billing.

Cause

  • Guest provider not connected under Settings → Payments
  • Provider requirements (activation, webhooks, currency) incomplete
  • Using Settings → Billing for guest checkout by mistake
  • Stay still pending confirmation so payment is not offered yet

Solution

  • Connect Stripe, Paystack, and/or PayPal under Settings → Payments
  • Confirm the stay is in a state that allows guest payment via the self-service link
  • Use Settings → Billing only for the agency Zyelra subscription
  • Check the provider dashboard for declined payments or webhook failures

When to contact support

Contact support when provider webhooks are verified and the provider shows a successful charge but the stay payment status never updates in Zyelra.

Next step

Jump to another problem area if this guide did not resolve the issue.

Browse troubleshooting topics →

Related guides

  • Troubleshooting hub

    Find fixes for account, website, messaging, calendar, OTA, AI, payments, automations, and leads issues.

  • 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.

  • 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.

  • PayPal (guest payments)

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

  • Account and access troubleshooting

    Fix login, team access, and plan entitlement issues for your agency workspace.