Core concepts
Payment Configuration
Learn how to configure VPAY, a premium payment integration platform, to support multiple gateways like Benefit and Mastercard — and ensure smooth, secure, and scalable transaction handling.
🛠 Getting Started
Before initiating any transactions, you must properly configure the VPAY SDK in your system. This includes:
- Creating a merchant account
- Setting up return URLs
- Generating an API key
- Configuring sandbox/test environments
🔐 Step 1: Create a Merchant Account
Log in or create a user account on the VPAY Dashboard.
Once logged in, register your business as a merchant by providing the following details:
- Business name
- Legal entity information
- Contact details
- Supported payment providers (e.g., Benefit, Mastercard)
After creating the merchant profile, you'll be able to access the developer tools and start integrating.
🔗 Step 2: Configure Return URLs
Set up the endpoints where users will be redirected after completing a payment.
These URLs are configured inside the VPAY dashboard under your merchant settings.
| Type | URL Example |
|---|---|
| Success | https://yourdomain.com/success |
| Failure | https://yourdomain.com/failure |
Each URL must accept a track_id parameter in the query string:
https://yourdomain.com/success?track_id=81ec24c2-0a4d-4aba-89d1-56e1db8e940e