Introduction
ePay helps you accept payments online and through payment links.
This guide walks you through the basics: how ePay works, which integration to choose, how to create your first test payment, how to handle the payment result and what to check before going live.
Choose your path
If you are not sure where to start, continue to Choose your integration.
If you already know what you want to build, go directly to one of these guides:
Plugin
Connect ePay to an existing webshop platform with minimal setup.
Checkout
Redirect customers to an ePay-hosted payment window.
Blocks
Embed secure payment fields directly in your own checkout.
Link
Send a payment link or QR code without building a full checkout.
Subscription
Take the first payment now and store consent for later recurring charges.
Verify
Add age verification directly to the payment flow.
API
Build a custom backend integration with full control.
What you will learn
By the end of this guide, you will understand how to:
- Choose the right ePay integration for your setup
- Find the values you need in ePay Backoffice
- Create your first test payment
- Test successful and failed payments
- Handle the payment result correctly
- Prepare your account for live payments
How ePay works
Most ePay integrations follow the same basic flow:
Your system creates a payment
The customer completes the payment
ePay sends the result back to your system
Your system updates the order
The exact implementation depends on how you want to accept payments.
For example, a webshop plugin handles most of the setup for you. A Checkout integration redirects the customer to an ePay-hosted payment window. Blocks lets you embed secure payment fields directly in your own checkout. The API gives you full control over the flow.
Test environment and live environment
Your ePay account always includes both a test environment and a live environment.
Test environment
Build and validate safely
For development and testing. You can create payments, test redirects, test payment results and simulate different outcomes. No real money is moved.
You can always return to the test environment, even after going live, without affecting your live setup.
Live environment
Start charging real payments
For real payments. It becomes active when your account is set to live and your acquirer agreement is in place.
You should always build and test your integration in the test environment before switching to the live environment.
What you need before you start
To follow this guide, you need:
- An ePay account
- Access to ePay Backoffice
- A Point of Sale
- An API key
- A way to test your payment flow