Payment Gateway Setup
stoqio Backoffice supports both automatic and manual payment methods. This guide explains how to configure each gateway and enable it for SaaS plan checkout and platform billing flows.
Where to Configure
Go to: Backoffice → Gateways
How to Enable a Gateway
- Open Backoffice > Gateways.
- Click the Edit (pencil) icon for the gateway.
- Enter the required credentials.
- Set Status to Active.
- Save changes and run a test payment from the plan checkout flow.
Supported Gateways
- PayPal
- Stripe
- SSLCommerz
- Flutterwave
- Paystack
- Bank (Manual)
PayPal
To enable PayPal, enter your PayPal REST API credentials:
- Client ID
- Client Secret
Testing: Use PayPal Sandbox credentials and accounts to verify the checkout flow.
Stripe
To enable Stripe, use your Stripe keys:
- Secret Key
Testing: Use Stripe test cards to verify checkout.
SSLCommerz
To enable SSLCommerz, enter your store credentials:
- Store ID
- Store Password
Flutterwave
To enable Flutterwave, enter your API keys:
- Public Key
- Secret Key
Paystack
To enable Paystack, enter your Paystack credentials:
- Public Key
- Secret Key
Bank (Manual Payment)
Bank is a manual payment option. Customers submit payment details (for example, transaction ID), then backoffice admin reviews and approves the payment log.
- Add bank name, account number, branch, and instructions shown to customers.
- Enable the gateway and instruct users to follow payment instructions during plan checkout.
- Backoffice admin verifies the payment and confirms the payment status.
Common Notes
- Currency: Ensure the selected currency is supported by the gateway.
- Charges: Configure gateway charge/fee settings if available in the gateway edit screen.
- HTTPS: Use SSL (HTTPS) on your domain for secure payments.
Troubleshooting
- If payments fail, re-check credentials and mode (test/live).
- Confirm your server allows outbound HTTPS requests.
- Make sure your return/callback URL is reachable publicly.