Sandbox Environment

Overview

The sandbox environment provides a safe testing space for integration development without financial risk.

---

Base URL

https://api-sandbox.accessbankplc.com

---

Sandbox Credentials

Contact your Access Bank account manager to obtain:

• Sandbox Merchant ID
• Sandbox Authorization Key

warning

Never use production credentials in sandbox, and never use sandbox credentials in production.

---

Sandbox Behavior

Virtual Funds

• All transactions use virtual money
• No real financial impact
• Wallet balances are simulated
• Transfers are instant

---

Sandbox Limitations

Feature	Sandbox	Production
Funds	Virtual	Real
Biometric verification	Simulated	Actual
BVN validation	Test data	Real NIBSS
NIN validation	Test data	Real NIMC
Interbank transfers	Simulated	Actual NIP
Settlement	Not applicable	Real debit/credit

---

Testing Checklist

• Authentication flow
• Customer validation (success case)
• Customer validation (sanctions hit)
• Wallet creation
• Wallet funding
• All transfer types
• Transaction status checks
• Account upgrade flow
• Webhook endpoints
• Error handling

---

Moving to Production

Before Going Live:

1. Get Production Credentials

   • Request from Access Bank
   • Store securely

2. Update Base URL

   const baseUrl = process.env.NODE_ENV === 'production'
     ? 'https://api.accessbankplc.com'
     : 'https://api-sandbox.accessbankplc.com';

3. Settlement Account

   • Confirm settlement account is funded
   • Verify account details

4. Final Testing

   • Run end-to-end tests in sandbox
   • Verify all integrations
   • Test error scenarios

5. Compliance Check

   • KYC procedures documented
   • Webhook security verified
   • Audit logging enabled

---

Support

For sandbox issues:

• 📧 Email: AFF@ACCESSBANKPLC.com

---