Frequently Asked Questions (FAQ)

What is PayOS?
PayOS is a payment orchestration platform that allows merchants to route transactions dynamically between multiple payment processors, optimizing costs and conversion rates.
How does PayOS help reduce transaction failures?
PayOS leverages dynamic routing and automatic retries to route transactions to the best available processor, improving the chances of payment success.
Can I use PayOS if I only need a single payment processor?
Yes, PayOS supports both multi-processor and single-processor setups. You can still benefit from features like hosted checkout and reporting.

What are the rate limits for PayOS APIs?
PayOS enforces rate limits to ensure platform stability. Refer to the Rate Limiting page for more details.
How do I handle payment failures?
Use the automatic retry feature provided by PayOS. If retries fail, PayOS sends webhook notifications so you can take further action.
Can I customize the hosted checkout?
Yes, merchants can add their logo, adjust colors, and change the order of payment methods. See the Hosted Checkout page for more information.
How do I get notified about payment events?
Configure webhooks to receive real-time updates about payment statuses, refunds, and other events.

How often should I rotate API keys?
It is recommended to rotate API keys every 90 days to maintain security.
What should I do if I experience duplicate payments?
Avoid manually retrying transactions when automatic retries are in progress. Use the PayOS dashboard to monitor retries and payment statuses.
How do I migrate from another payment provider to PayOS?
Use PayOS’s migration tools to import existing customer data and payment methods. Refer to the Migration Guide for more details.