Developers
Integrate card payments with a hosted page or API
Hosted payment page, REST API and webhooks, with a sandbox for testing before you go live.
Integration options
Choose the path that fits your stack
- Hosted payment page. Redirect customers to a secure, Payixay-hosted checkout. Card data never touches your servers, which reduces your PCI DSS compliance scope.
- Server-to-server API. Build a fully custom checkout with our REST API, with 3-D Secure handled by the gateway. As card data passes through your systems, this option requires your own PCI DSS compliance.
- Webhooks. Receive real-time notifications for approvals, declines, refunds and chargebacks.
Plug-in availability is confirmed per merchant, ask our team whether your e-commerce platform is supported.
// Illustrative webhook handler (Node.js)
app.post('/webhooks/payixay', (req, res) => {
const event = req.body;
if (!verifySignature(req)) return res.sendStatus(401);
switch (event.status) {
case 'approved': markOrderPaid(event.order_id); break;
case 'declined': notifyCustomer(event.order_id); break;
case 'refunded': updateLedger(event); break;
case 'chargeback': openDispute(event.order_id); break;
}
res.sendStatus(200);
});
app.post('/webhooks/payixay', (req, res) => {
const event = req.body;
if (!verifySignature(req)) return res.sendStatus(401);
switch (event.status) {
case 'approved': markOrderPaid(event.order_id); break;
case 'declined': notifyCustomer(event.order_id); break;
case 'refunded': updateLedger(event); break;
case 'chargeback': openDispute(event.order_id); break;
}
res.sendStatus(200);
});
Go-live checklist
From sandbox to live
Get credentials
Receive sandbox keys once your application has been reviewed.
Build & test
Run approvals, declines, 3-D Secure and refunds with test cards.
Review
Our team checks your checkout flow and webhook handling.
Go live
Switch to live keys and start accepting real payments.
Need help with your integration?
Our technical team will help you choose the right integration and test it end to end.