Paystack (guest payments)

Paystack guest payments settle to your Paystack subaccount. You connect by pasting the subaccount code from Paystack — there is no agency OAuth Connect flow for Paystack in Zyelra.

• A Paystack business account with a subaccount created for the property/agency settlement target.
• Permission to manage Settings → Payments.

Paystack subaccounts (official) ↗

1. Step 1In provider

   Create a subaccount in Paystack

   In the Paystack Dashboard, open Subaccounts and create a subaccount for the bank settlement details that should receive guest payments. Copy the subaccount code (commonly starts with ACCT_).

2. Step 2In Zyelra

   Open Settings → Payments → Paystack

   Go to Settings → Payments, choose Connect Paystack, and paste the Paystack subaccount code. Submit Connect subaccount.

3. Step 3In provider

   Webhook (platform)

   Paystack payment events POST to {your Zyelra API base URL}/api/v1/webhooks/payments/paystack. Platform signing configuration is operated by Zyelra — do not invent secrets.

4. Step 4In Zyelra

   Run a test guest payment

   Complete a test checkout and confirm settlement routing to the subaccount in Paystack Dashboard.

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

1. Paystack shows connected in Settings → Payments.
2. Guest checkout uses Paystack.
3. Dashboard shows the charge against the connected subaccount.

• Invalid subaccount code — copy again from Paystack Dashboard → Subaccounts.
• Settlement bank issues — fix bank details on the subaccount in Paystack.
• Wrong integration — confirm you are in Settings → Payments, not Billing.