Paystack Nigeria settles your NGN revenue to your registered bank account 1 business day after the transaction date (T+1). Settlement happens automatically — no manual action required. To send payouts to vendors or users, create transfer recipients via POST /transferrecipient with bank code and account number, then use POST /transfer. The minimum transfer amount is NGN 100. Weekend and public holiday transactions settle on the next business day.
| Transaction Day | Settlement Day |
|---|---|
| Monday | Tuesday |
| Friday | Monday |
| Saturday | Monday |
| Sunday | Monday |
| Public holiday | Next business day |
Settlement appears in your bank account by 10 AM on the settlement date. Your Paystack account must be fully verified and your bank account confirmed for automatic settlement to work.
// Create a transfer recipient (one-time per vendor)
async function createNGNRecipient(name, accountNumber, bankCode) {
var res = await fetch('https://api.paystack.co/transferrecipient', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + process.env.PAYSTACK_SECRET_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
type: 'nuban',
name,
account_number: accountNumber,
bank_code: bankCode, // e.g., '058' for GTBank, '057' for Zenith
currency: 'NGN',
}),
});
var data = await res.json();
return data.data.recipient_code; // Store this in your database
}
// Send a payout
async function sendNGNPayout(recipientCode, amountNGN, reason) {
var res = await fetch('https://api.paystack.co/transfer', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + process.env.PAYSTACK_SECRET_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
source: 'balance',
amount: Math.round(amountNGN * 100), // NGN to kobo
recipient: recipientCode,
reason,
currency: 'NGN',
}),
});
return res.json();
}Get weekly developer tips
Join 25,000+ developers. Practical guides, job tips, and new content — straight to your inbox.
No spam. Unsubscribe anytime.
This guide is part of the Paystack by country guide.
KES 2,999
The definitive guide to building payment systems with Paystack — from your first transaction to production-grade payment infrastructure across Africa. 9 modules, 47 lessons. Free preview available.
Start Paystack Course