Prerequisites
Everything you need before integrating with EPaySe payment gateway.
Before you start integrating with EPaySe, ensure your development environment meets these requirements and you have the necessary accounts and tools set up.
System Requirements
PHP
Required extensions: cURL, JSON, OpenSSL, mbstring
HTTPS
Valid SSL certificate for production environment
Database
For storing transaction records and webhooks
Server
Accessible from the internet for webhook delivery
Verify Your Setup
# Check PHP version
php -v
# Check required extensions
php -m | grep -E 'curl|json|openssl|mbstring'Account Setup
You'll need an approved EPaySe merchant account to process payments. Sign up for a free sandbox account or apply for a production account.
Required Information
Have these documents and information ready for account approval
- Valid business registration documents
- Bank account for settlements
- Business contact information
- Processing volume estimates
- Business description and website
Fast Approval
Development Tools
Install these tools to streamline your integration process.
Composer
PHP dependency manager
Git
Version control system
Postman
API testing tool
ngrok
Local tunnel for webhook testing
Install Composer
Composer is required to install the EPaySe PHP SDK and manage dependencies.
# Check if Composer is installed
composer --version
# If not installed, download and install
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composerLocal Webhook Testing with ngrok
ngrok allows you to test webhooks on your local development machine by creating a secure tunnel to localhost.
# Install ngrok
npm install -g ngrok
# Authenticate (sign up at ngrok.com for auth token)
ngrok config add-authtoken YOUR_AUTH_TOKEN
# Start tunnel on port 8000
ngrok http 8000Environment Setup
Sandbox Environment
Free testing environment with full feature access
- Full API testing with test cards
- Unlimited test transactions
- Webhook testing and debugging
- Completely free, no credit card required
Production Environment
Live environment for real payment processing
- Process real payments
- Requires valid SSL certificate
- Requires KYB approval
- Live API keys and endpoints
Security Checklist
Security Is Critical
Pre-Integration Security Checklist
Complete these security requirements before integrating
- Valid HTTPS/SSL certificate for all URLs
- Secure storage for API keys (environment variables, not code)
- Webhook signature verification implemented
- Secure logging without exposing sensitive data
- PCI DSS compliance for card data handling