Getting started
API credentials
The Payment Engine authenticates merchant server calls with an API key.
Create a key
- Open the dashboard in the correct environment (Test or Live).
- Select the target profile / payment channel.
- Go to Integration Settings (website profiles).
- Create an API key. Copy the plaintext immediately — it is shown once.
Use the key
POST /merchant/initiate-payment
Host: merchant.venpays.com
X-API-KEY: <your-secret-key>
Content-Type: application/json
Sandbox example host: init-vpay.venlabs.link.
Rules
| Do | Do not |
|---|---|
| Store keys in your backend secrets manager | Embed keys in mobile apps or frontend JS |
| Rotate/delete unused keys | Share Live keys in chat or tickets |
| Use Sandbox keys only against Sandbox hosts | Mix Sandbox keys with Live base URLs |
Treat every API key as a production secret.