NEXT GEN PAYON API Documentation

const crypto = require('crypto');
// Your webhook secret from the dashboard
const webhookSecret = 'whsec_...';
function verifyWebhookSignature(payload, signature, timestamp) {
const signedPayload = `${timestamp}.${payload}`;
const expectedSignature = crypto
.createHmac('sha256', webhookSecret)
.update(signedPayload)
.digest('hex');
return crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(expectedSignature)
);
}
// Express.js example
app.post('/webhook', (req, res) => {
const signature = req.headers['x-nextgenpayon-signature'];
const timestamp = req.headers['x-nextgenpayon-timestamp'];
const payload = JSON.stringify(req.body);
if (verifyWebhookSignature(payload, signature, timestamp)) {
// Process the webhook
console.log('Webhook verified:', req.body);
res.status(200).send('Webhook received');
} else {
console.error('Invalid webhook signature');
res.status(400).send('Invalid signature');
}
});

const NextGenPayon = require('nextgenpayon-node');
// Initialize the client with your API key
const client = new NextGenPayon('YOUR_API_KEY');
// Create a bulk payout
async function createBulkPayout() {
try {
const response = await client.payouts.createBulk({
batch_id: 'BATCH-2025051701',
description: 'May 2025 Salary Disbursement',
payments: [
{
employee_id: 'EMP001',
amount: 85000.00,
currency: 'INR',
description: 'May 2025 Salary'
},
{
employee_id: 'EMP002',
amount: 110000.00,
currency: 'INR',
description: 'May 2025 Salary'
}
],
scheduled_date: '2025-05-25T00:00:00Z'
});
console.log('Bulk payout created:', response);
return response;
} catch (error) {
console.error('Error creating bulk payout:', error);
throw error;
}
}
// Check payment status
async function checkPaymentStatus(batchId) {
try {
const response = await client.payouts.getBatch(batchId);
console.log('Payment status:', response);
return response;
} catch (error) {
console.error('Error checking payment status:', error);
throw error;
}
}
// Usage
createBulkPayout()
.then(response => checkPaymentStatus(response.batch_id))
.catch(error => console.error('Operation failed:', error));

{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded. Please try again in 23 seconds.",
"type": "api_error"
}
}