);
}
```
### Node.js/Express Example
```javascript theme={null}
const express = require('express');
const router = express.Router();
// Step 1: Get banks
router.get('/banks', async (req, res) => {
const response = await fetch(
'https://api.mavapay.co/api/v1/bank/bankcode?country=NG',
{
headers: { 'X-API-KEY': process.env.MAVAPAY_API_KEY }
}
);
const data = await response.json();
res.json(data);
});
// Step 4: Verify account
router.post('/verify-account', async (req, res) => {
const { accountNumber, bankCode } = req.body;
if (!accountNumber || accountNumber.length !== 10) {
return res.status(400).json({ error: 'Invalid account number' });
}
try {
const response = await fetch(
`https://api.mavapay.co/api/v1/bank/name-enquiry?accountNumber=${accountNumber}&bankCode=${bankCode}`,
{
headers: { 'X-API-KEY': process.env.MAVAPAY_API_KEY }
}
);
const data = await response.json();
res.json(data);
} catch (error) {
res.status(500).json({ error: 'Verification failed' });
}
});
module.exports = router;
```
## API Endpoints Reference
For complete API documentation, see:
* [Get Bank Codes endpoint](/api-reference/endpoint/bank-info/bank-code) - Fetch list of Nigerian banks
* [Name Enquiry endpoint](/api-reference/endpoint/bank-info/name-enquiry) - Validate bank account details
### Quick Reference
**Get Bank Codes:**
```bash theme={null}
GET /api/v1/bank/bankcode?country=NG
```
**Name Enquiry:**
```bash theme={null}
GET /api/v1/bank/name-enquiry?accountNumber={accountNumber}&bankCode={bankCode}
```
## Error Handling
### Common Errors
| Error | Cause | Solution |
| --------------------------- | ----------------------------------------- | -------------------------------------------------------- |
| Invalid account number | Account doesn't exist or wrong number | Ask user to verify their account number |
| Invalid bank code | Bank code doesn't match any Nigerian bank | Ensure you're using the NIP bank code from the bank list |
| Account verification failed | Temporary issue with bank API | Retry after a short delay |
| Rate limit exceeded | Too many requests | Implement rate limiting in your application |
### Example Error Response
```json theme={null}
{
"status": "error",
"message": "Invalid account number or bank code"
}
```
## Best Practices
1. **Cache Bank List**: Fetch and cache the bank list instead of fetching on every page load
2. **Validate Before Enquiry**: Check account number is exactly 10 digits before calling API
3. **Show Loading State**: Display loading indicator during verification
4. **Handle Errors Gracefully**: Provide clear error messages to users
5. **Confirm Before Proceeding**: Always show retrieved name for user confirmation
6. **Store Validated Data**: Save validated beneficiary details for future use
## Security Considerations
1. **API Key Protection**: Never expose your API key in frontend code
2. **Backend Validation**: Always verify account details on your backend
3. **Rate Limiting**: Implement rate limiting to prevent abuse
4. **Input Validation**: Validate all user inputs before making API calls
## Limitations
* Only available for Nigerian (NGN) bank accounts
* Not available for South African Rand (ZAR) or Kenyan Shilling (KES)
* Requires valid NIP bank code
* Account must be active and valid
## Related Documentation
Complete API reference for the Name Enquiry endpoint
API reference for fetching Nigerian bank codes
Required formats for all supported currencies
Learn how to create quotes with validated details
## Next Steps
* View [beneficiary formats](/api-reference/beneficiary-formats) for all currencies
* Learn how to [create quotes](/api-reference/endpoint/quote/get-quote)
* Explore [quote examples](/api-reference/quote-examples) for different currency pairs
* Set up [webhook notifications](/webhooks/introduction) for payment tracking