Gateway types
Online gatewaysReal-time payment processing. The customer enters payment details on the checkout page, and the gateway authorizes the transaction instantly.Examples: Stripe, PayPal, bKash, Nagad, Razorpay, SSLCommerz, Square.
Manual gatewaysOffline payment methods that require manual confirmation. The customer is shown instructions (bank account number, QR code), and a staff member marks the payment as complete after verifying the transfer.Examples: bank transfer, cash on delivery, manual invoice.
How gateway routing works
When a customer reaches the checkout page, OwnPay looks at the brand’s active gateways and presents them as payment options. The routing logic is straightforward:- Load all gateways marked active for the brand.
- Filter by the payment’s currency (each gateway declares its supported currencies via
supportedCurrencies()). - Present the matching gateways on the checkout page.
- The customer selects one and submits payment.
OwnPay does not currently perform automatic gateway failover or load balancing. The customer chooses the gateway. If you want redundancy, activate multiple gateways so the customer has alternatives.
Credential encryption
Gateway API keys, secrets, and merchant IDs are never stored in plaintext. When you save gateway credentials, OwnPay encrypts them using AES-256-GCM with a key derived from your application’sAPP_KEY. The encrypted blob is stored in the database; only the running application can decrypt it.
Per-brand gateway assignment
Each brand independently selects which gateways to activate. Brand A might use Stripe and PayPal, while Brand B uses bKash and SSLCommerz. Credentials, fees, and enabled/disabled state are all scoped to the brand’smerchant_id.
Gateway health checks
OwnPay periodically pings active gateways to verify they are reachable. If a gateway consistently fails health checks, it is flagged in the admin dashboard so you can investigate. Check gateway status under Gateways in the sidebar.Popular supported gateways
This table shows a subset. OwnPay supports 123+ gateways. See the full list in the admin panel under Gateways or visit GitHub.
Related pages
- Gateway configuration - step-by-step setup for each provider
- Currencies - manage currencies and exchange rates
- Payment flow - transaction statuses and lifecycle
- Plugin system - how gateways are built as plugins
- Build a gateway plugin - developer guide for custom gateways