Download the PHP package academe/omnipay-elavon without Composer
On this page you can find all versions of the php package academe/omnipay-elavon. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package omnipay-elavon
Omnipay: Elavon EPG
Elavon Payment Gateway (EPG) driver for the Omnipay PHP payment processing library
Omnipay is a framework-agnostic, multi-gateway payment processing library for PHP. This package implements Elavon Payment Gateway (EPG) support for Omnipay.
This driver uses Elavon's Hosted Payment Page (HPP) for secure card entry and 3DS authentication. All card details are entered on Elavon's hosted form, keeping your application out of PCI scope.
This package uses academe/elavon-epg-psr7 as the underlying API message driver and for DTOs.
Installation
Requirements
- PHP 8.1 or higher
- Omnipay 3.x
- An Elavon EPG merchant account with API credentials
Basic Usage
Gateway Setup
Hosted Payment Page Flow
The HPP gateway uses a redirect flow where the customer enters their card details on Elavon's secure hosted page:
- Create an order and payment session
- Redirect customer to Elavon's hosted payment page
- Customer enters card details and completes 3DS authentication
- Customer is redirected back to your site
- Verify the transaction result
Authorize (Two-step flow)
An authorization reserves funds on the cardholder's account but does not capture them.
Use capture() to complete the transaction later.
Purchase (Single-step flow)
A purchase authorizes and captures payment in one step.
Capture
Capture a previously authorized transaction.
Refund
Refund a captured/settled transaction.
Void
Void an authorized transaction before capture.
Fetch Transaction
Retrieve details of a transaction.
Gateway Parameters
| Parameter | Description |
|---|---|
merchantAlias |
Your Elavon merchant alias |
apiKey |
Your API key for authentication |
region |
API region: 'eu' or 'na' |
testMode |
Set to true for sandbox environment |
Request Parameters
Common Parameters
| Parameter | Description |
|---|---|
amount |
Transaction amount (e.g., '10.00') |
currency |
Three-letter ISO currency code (e.g., 'USD') |
transactionId |
Your unique order/transaction ID |
transactionReference |
Gateway's transaction reference (href URL) |
returnUrl |
URL to redirect after successful payment |
cancelUrl |
URL to redirect if payment is cancelled |
Response Methods
All responses provide these common methods:
Demo Scripts
The demo/ directory contains working examples demonstrating the HPP payment flow:
- hpp-form.php - Payment form with authorize/purchase option
- hpp-checkout.php - Creates order and redirects to HPP
- hpp-return.php - Handles return after payment
- hpp-capture.php - Captures authorized payments
- hpp-cancel.php - Handles cancelled payments
- transactions.php - View and manage transactions (void/refund)
- transaction-detail.php - View transaction details
Running the Demos
Start the web server:
Then open: http://localhost:8000/
Configuration
Copy demo/config.php.example to demo/config.php and add your credentials:
Testing
Support
If you are having general issues with Omnipay, we suggest posting on Stack Overflow. Be sure to add the omnipay tag.
If you believe you have found a bug, please report it using the GitHub issue tracker.
License
This package is released under the MIT License. See the LICENSE file for details.
All versions of omnipay-elavon with dependencies
academe/elavon-epg-psr7 Version ^2.0.1
http-interop/http-factory-guzzle Version ^1.2
omnipay/common Version ^3.0
symfony/http-client Version ^7.3