A universal, framework-independent browser integration. Click each step below to view & copy the code instantly.
Place this single script tag in your HTML. It provides modal checkout, responsive iframe sizing, and automatic button detection.
<!-- Official Nijiy Pay Gateway universal integration script -->
<script
src="https://pay.nijiy.com/youpi.js"
data-youpi-key="YOUR_PUBLIC_KEY">
</script>Add data-youpi-pay, data-order-id, and data-amount to any button. The script automatically opens the centered modal checkout on click.
<button
data-youpi-pay
data-order-id="ORDER-1001"
data-amount="499">
Buy Now
</button>Optional attributes: data-currency="INR", data-customer-name, data-customer-email, data-customer-phone, data-metadata='{"sku":"TSHIRT-01"}'
The script emits standardized DOM CustomEvents on window so you can drive your interface.
<script>
window.addEventListener('youpi:payment:success', (e) => {
const { order_id, amount_received, utr, payment_mode } = e.detail;
console.log(`Payment confirmed for Order #${order_id}. UTR: ${utr}`);
window.location.href = `/order-success?order_id=${order_id}&amount=${amount_received}&utr=${utr}`;
});
window.addEventListener('youpi:payment:failed', (e) => {
window.location.href = `/order-failed?order_id=${e.detail.order_id}&reason=${e.detail.reason}`;
});
window.addEventListener('youpi:payment:suspicious', (e) => {
window.location.href = `/order-suspicious?order_id=${e.detail.order_id}`;
});
</script>For dynamic carts (React, Vue, Next.js, Nuxt), call the programmatic API directly.
NijiyPay.pay({
order_id: "ORDER-1001",
amount: 499,
currency: "INR",
customer: {
name: "Mohit",
email: "[email protected]",
phone: "9876543210"
},
metadata: { product_id: "TSHIRT-01" },
handler: function(response) {
// { status: "SUCCESS", order_id, amount_received, utr, payment_mode }
console.log(`Payment successful! UTR: ${response.utr}`);
},
onFailed: function(response) {
console.log(`Payment failed: ${response.reason}`);
},
onClose: function() {
console.log("modal closed")
}
});Critical security invariant: never mark an order paid based only on client-side browser events. Fulfil orders only after verifying the server-to-server HMAC-SHA256 signed webhook.
import crypto from 'node:crypto';
app.post('/api/youpi-webhook', express.raw({ type: 'application/json' }), (req, res) => {
const signature = req.headers['x-gateway-signature']; // 'sha256=...'
const webhookSecret = process.env.YOUPI_WEBHOOK_SECRET;
// Verify HMAC-SHA256 over the RAW request bytes
const expectedHmac = crypto.createHmac('sha256', webhookSecret).update(req.body).digest('hex');
if (signature !== `sha256=${expectedHmac}`) {
return res.status(401).send('Signature mismatch');
}
const event = JSON.parse(req.body.toString());
if (event.event === 'SUCCESS') {
// Authoritative proof: mark the order as PAID in your database.
db.orders.markPaid(event.orderId, { utr: event.utr, amount: event.amount });
}
res.status(200).json({ received: true });
});Nijiy Pay delivers a powerful, modern payment experience with rock-solid reliability.
Link your own payment bank account directly. Complete control over your receiving setup with seamless configuration.
Transparent settlement process with predictable timelines. Payout Releases after 48hrs directly to your linked bank account.
Works flawlessly with PHP, Node.js, Python, Laravel, Django, Next.js, WordPress, or plain HTML. One script, infinite possibilities.
Every merchant goes through our thorough verification process with our approval guarantee for trusted partnerships.
Our Specialized Developer Engineering Support team is here to assist you. Support for Integration 24x7.
Sign up today and start earning rewards. Join the growing network of merchants powered by Nijiy Pay.
Never mark an order paid based only on client-side browser events. Fulfil orders only after verifying the server-to-server HMAC-SHA256 signed webhook.
import crypto from 'node:crypto';
app.post('/api/youpi-webhook', express.raw({ type: 'application/json' }), (req, res) => {
const signature = req.headers['x-gateway-signature']; // 'sha256=...'
const webhookSecret = process.env.YOUPI_WEBHOOK_SECRET;
// Verify HMAC-SHA256 over the RAW request bytes
const expectedHmac = crypto.createHmac('sha256', webhookSecret).update(req.body).digest('hex');
if (signature !== `sha256=${expectedHmac}`) {
return res.status(401).send('Signature mismatch');
}
const event = JSON.parse(req.body.toString());
if (event.event === 'SUCCESS') {
// Authoritative proof: mark the order as PAID in your database.
db.orders.markPaid(event.orderId, { utr: event.utr, amount: event.amount });
}
res.status(200).json({ received: true });
});Get started with Nijiy Pay today
Developer Charges
Our Specialized Developer Engineering Support team is available 24x7 to help you integrate Nijiy Pay Gateway seamlessly.