Welcome to Payviox
Payviox provides a simple and flexible payment infrastructure. You can integrate payments in minutes by choosing between two integration methods, and automatically receive payment confirmations via webhooks.New to Payviox? This guide explains the complete payment flow from start to finish.
Recommended integration: create the payment session from your backend with your secret key, then hand the
session_id to the JavaScript SDK in the browser — it takes the customer to the payment page for you. See Choose your integration method for this pattern and its two variations (SDK on its own, API on its own).Payment Flow
Here’s how a typical payment works with Payviox:Step-by-Step Flow
1
Customer initiates payment
Your customer clicks a “Pay Now” button or starts the checkout process on your website.
2
Create a payment session
Your application calls Payviox (via SDK or API) to create a payment session with order details, amount, currency, and items.
3
Redirect to secure payment page
The customer is redirected to Payviox’s secure payment page (or it opens in an iframe) where they can complete their payment.
4
Customer completes payment
The customer enters their payment details and confirms the transaction on the secure Payviox page.
5
Webhook notification
Immediately after payment, Payviox sends a webhook to your server with the payment status and details. This is how you know the payment was successful.
6
Customer returns to your site
After payment, the customer is redirected back to your website where you can show them a confirmation page.
Next Steps
Choose Integration Method
Compare SDK vs API integration
Understanding Webhooks
Learn about payment notifications
SDK Integration — Recommended
Start with the JavaScript SDK
API Integration
Use the REST API