Skip to main content

ZepoPay Payment Gateway

Quick Start​

  1. Authenticate - Get your access token
  2. Create Transaction - Submit payment details
  3. Handle Response - Process the payment result
  4. Monitor Status - Receive webhook notifications

Core Features​

  • Multi-provider payment processing
  • Real-time transaction status updates
  • Secure card operations
  • Comprehensive webhook notifications
  • Detailed transaction reporting

Integration Flow​

1. Authentication → 2. Create Transaction → 3. Process Payment → 4. Handle Response → 5. Monitor Status

Available Payment Methods​

Payment methods are configured per merchant. The available methods will be displayed in your merchant dashboard and can be accessed via the API.

note

If you need access to additional payment methods, they can be enabled through your merchant dashboard.

Before You Start​

To integrate with ZepoPay, you'll need:

Access Credentials​

Your API credentials consist of a Client ID and Client Secret used for authentication:

  1. Log in to your ZepoPay merchant dashboard
  2. Navigate to Applications in the side menu
  3. Click the eye icon next to your application to reveal your credentials
  4. Copy your Client ID and Client Secret
Keep Your Credentials Safe

Never expose your Client Secret in client-side code or public repositories. Store it securely on your server.

Webhook Endpoint​

Set up a webhook endpoint to receive real-time payment notifications:

Requirements:

  • Must be a publicly accessible HTTPS URL
  • Must respond with HTTP 200 status code within 30 seconds
  • Should validate webhook signatures for security
  • Should handle idempotent processing (duplicate notifications)

Example endpoint: https://yourdomain.com/api/webhooks/zepopay

Webhook Events:

  • Transaction status changes (Pending, Captured, Failed, Declined, Refunded)

SSL/TLS Security​

All API endpoints and webhooks must use HTTPS with a valid SSL/TLS certificate:

  • API requests must be made to https://api.paysecurez.com
  • Webhook endpoints must accept HTTPS connections
  • Use TLS 1.2 or higher for secure communication

Integration Checklist​

1. Payment Configuration Setup​

ZepoPay will create and configure your payment solution in our system:

  • Payment method setup for your specific requirements
  • Initial test environment provisioned

2. Review Authentication Requirements​

Study the authentication flow and ensure your implementation matches our specifications:

  • Review the Authentication documentation
  • Ensure your request parameters match our API examples
  • Verify token handling and refresh logic

3. Set Up Webhook Endpoint​

Implement a webhook endpoint to receive transaction status updates:

  • Create an HTTPS endpoint on your server
  • Implement proper signature validation
  • Configure the webhook URL in your merchant dashboard
  • Test webhook reception with sample payloads

4. Implement Error Handling​

Build robust error handling for all payment scenarios:

  • Handle HTTP status codes (400, 401, 403, 422, 500)
  • Parse error messages and display user-friendly feedback
  • Implement retry logic for transient failures
  • Log errors for troubleshooting

5. Test Your Integration​

Thoroughly test your integration with ZepoPay's support:

  • Use the same API endpoints and credentials as production
  • ZepoPay team configures test channels for your testing
  • Test success, failure, and decline scenarios
  • Verify webhook notifications are received and processed

6. Go Live​

Once testing is complete, ZepoPay will enable your live channel:

  • No code changes required on your side
  • Same API endpoints and authentication flow
  • ZepoPay switches channel configuration from test to live
  • Monitor initial live transactions closely

Need Help?​

Contact our integration support team: support@zepopay.com