PHPackages                             cloudcogsio/omnipay-firstatlanticcommerce-gateway - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. cloudcogsio/omnipay-firstatlanticcommerce-gateway

ActiveLibrary[API Development](/categories/api)

cloudcogsio/omnipay-firstatlanticcommerce-gateway
=================================================

First Atlantic Commerce (FAC) Payment Gateway Driver for Omnipay

v1.0.2.2(2y ago)41066MITPHPPHP ^7.2

Since Jul 28Pushed 1y ago1 watchersCompare

[ Source](https://github.com/cloudcogsio/omnipay-firstatlanticcommerce-gateway)[ Packagist](https://packagist.org/packages/cloudcogsio/omnipay-firstatlanticcommerce-gateway)[ RSS](/packages/cloudcogsio-omnipay-firstatlanticcommerce-gateway/feed)WikiDiscussions master Synced today

READMEChangelog (5)Dependencies (2)Versions (7)Used By (0)

Omnipay - First Atlantic Commerce
=================================

[](#omnipay---first-atlantic-commerce)

**First Atlantic Commerce gateway for the Omnipay PHP payment processing library**

[![Packagist License](https://camo.githubusercontent.com/5383b3a6472f6794ea9056476ecae189f0f7bf8cd9c56b804e870bf091b96213/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f636c6f7564636f6773696f2f6f6d6e697061792d666972737461746c616e746963636f6d6d657263652d67617465776179)](https://camo.githubusercontent.com/5383b3a6472f6794ea9056476ecae189f0f7bf8cd9c56b804e870bf091b96213/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f636c6f7564636f6773696f2f6f6d6e697061792d666972737461746c616e746963636f6d6d657263652d67617465776179) [![Packagist Version](https://camo.githubusercontent.com/80ab969139ea1d6b2c786a025e4fda3e114f8da75ec7144985006e96a161897b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636c6f7564636f6773696f2f6f6d6e697061792d666972737461746c616e746963636f6d6d657263652d67617465776179)](https://camo.githubusercontent.com/80ab969139ea1d6b2c786a025e4fda3e114f8da75ec7144985006e96a161897b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636c6f7564636f6773696f2f6f6d6e697061792d666972737461746c616e746963636f6d6d657263652d67617465776179) [![Packagist PHP Version Support (specify version)](https://camo.githubusercontent.com/3622b4dcc723a8d1d48e043514dee7d6e5a165358e2b935b17d607c2dfb26f45/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f636c6f7564636f6773696f2f6f6d6e697061792d666972737461746c616e746963636f6d6d657263652d676174657761792f6465762d6d6173746572)](https://camo.githubusercontent.com/3622b4dcc723a8d1d48e043514dee7d6e5a165358e2b935b17d607c2dfb26f45/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f636c6f7564636f6773696f2f6f6d6e697061792d666972737461746c616e746963636f6d6d657263652d676174657761792f6465762d6d6173746572) [![GitHub issues](https://camo.githubusercontent.com/4a07b6df34d66e80a187f576dcca07a1b4db5d3496434963c0b526303a149f9c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f636c6f7564636f6773696f2f6f6d6e697061792d666972737461746c616e746963636f6d6d657263652d67617465776179)](https://camo.githubusercontent.com/4a07b6df34d66e80a187f576dcca07a1b4db5d3496434963c0b526303a149f9c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f636c6f7564636f6773696f2f6f6d6e697061792d666972737461746c616e746963636f6d6d657263652d67617465776179) [![GitHub last commit](https://camo.githubusercontent.com/898672742ac7b14229575b1db71b94531bc03a1903345b5cbd070fdb0730cf97/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f636c6f7564636f6773696f2f6f6d6e697061792d666972737461746c616e746963636f6d6d657263652d67617465776179)](https://camo.githubusercontent.com/898672742ac7b14229575b1db71b94531bc03a1903345b5cbd070fdb0730cf97/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f636c6f7564636f6773696f2f6f6d6e697061792d666972737461746c616e746963636f6d6d657263652d67617465776179)

[Omnipay](https://github.com/thephpleague/omnipay) is a framework agnostic, multi-gateway payment processing library for PHP 5.3+. This package implements First Atlantic Commerce (FAC) support for Omnipay.

Installation
------------

[](#installation)

Via Composer

```
$ composer require cloudcogsio/omnipay-firstatlanticcommerce-gateway
```

Gateway Operation Defaults
--------------------------

[](#gateway-operation-defaults)

This gateway driver operates in 3DS mode by default and requires a callback URL to be provided via the '**setReturnUrl**' method. The return URL must then implement the '**acceptNotification**' method to capture the transaction response from FAC.

The gateway can process non-3DS transactions by explicitly turning off 3DS during gateway configuration.

```
$gateway->set3DS(false);
```

Usage
-----

[](#usage)

For general usage instructions, please see the main [Omnipay](https://github.com/thephpleague/omnipay) repository.

### Non-3DS Transactions (Direct Integration)

[](#non-3ds-transactions-direct-integration)

```
use Omnipay\Omnipay;
try {
    $gateway = Omnipay::create('FirstAtlanticCommerce_FAC');
    $gateway
        ->setTestMode(true)
        ->setIntegrationOption(\Omnipay\FirstAtlanticCommerce\Constants::GATEWAY_INTEGRATION_DIRECT)
        ->setFacId('xxxxxxxx')
        ->setFacPwd('xxxxxxxx')
        ->set3DS(false);

    $cardData = [
        'number' => '4111111111111111',
        'expiryMonth' => '01',
        'expiryYear' => '2025',
        'cvv' => '123'
    ];

    $transactionData = [
        'card' => $cardData,
        'currency' => 'USD',
        'amount' => '1.00',
        'transactionId' => 'OrderNo-2100001'
    ];

    $response = $gateway->purchase($transactionData)->send();

    if($response->isSuccessful())
    {
        // Verify response
        $response->verifySignature();

        // Purchase was succussful, continue order processing
        ...
    }
} catch (Exception $e){
    $e->getMessage();
}
```

### 3DS Transactions (Direct Integration)

[](#3ds-transactions-direct-integration)

'**returnUrl**' required. URL must be **https://**

```
use Omnipay\Omnipay;
try {
    $gateway = Omnipay::create('FirstAtlanticCommerce_FAC');
    $gateway
        ->setTestMode(true)
        ->setIntegrationOption(\Omnipay\FirstAtlanticCommerce\Constants::GATEWAY_INTEGRATION_DIRECT)
        ->setFacId('xxxxxxxx')
        ->setFacPwd('xxxxxxxx')
        ->set3DS(true)

        // **Required and must be https://
        ->setReturnUrl('https://localhost/accept-notification.php');

    $cardData = [
        'number' => '4111111111111111',
        'expiryMonth' => '01',
        'expiryYear' => '2025',
        'cvv' => '123'
    ];

    $transactionData = [
        'card' => $cardData,
        'currency' => 'USD',
        'amount' => '1.00',
        'transactionId' => 'OrderNo-2100001'
    ];

    $response = $gateway->purchase($transactionData)->send();

    if($response->isRedirect())
    {
	    // Redirect to continue 3DS verification
        $response->redirect();
    }
    else
    {
	    // 3DS transaction failed setup, show error reason.
        echo $response->getMessage();
    }
} catch (Exception $e){
    $e->getMessage();
}
```

***accept-notification.php***Accept transaction response from FAC.

```
$gateway  = Omnipay::create('FirstAtlanticCommerce_FAC');
$gateway
    // Password is required to perform response signature verification
    ->setFacPwd('xxxxxxxx');

// Signature verification is performed implicitly once the gateway was initialized with the password.
$response = $gateway->acceptNotification($_POST)->send();

if($response->isSuccessful())
{
    // Purchase was succussful, continue order processing
    ...
}
else
{
    // Transaction failed
    echo $response->getMessage();
}
```

Support
-------

[](#support)

If you are having general issues with Omnipay, we suggest posting on [Stack Overflow](http://stackoverflow.com/). Be sure to add the [omnipay tag](http://stackoverflow.com/questions/tagged/omnipay) so it can be easily found.

If you believe you have found a bug, please report it using the [GitHub issue tracker](https://github.com/cloudcogsio/omnipay-firstatlanticcommerce-gateway/issues), or better yet, fork the library and submit a pull request.

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance30

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 92.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~215 days

Total

5

Last Release

885d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1d2ff1bf8c9106dd0a4a8962cfc90c3450e288f5bc7abe69f0aa44d8e0761022?d=identicon)[cloudcogs](/maintainers/cloudcogs)

---

Top Contributors

[![cloudcogsio](https://avatars.githubusercontent.com/u/66295280?v=4)](https://github.com/cloudcogsio "cloudcogsio (13 commits)")[![jeet1293](https://avatars.githubusercontent.com/u/16204397?v=4)](https://github.com/jeet1293 "jeet1293 (1 commits)")

---

Tags

apiomnipaypayment gatewaycloudcogscloudcogs.iofirst atlantic commerce

### Embed Badge

![Health badge](/badges/cloudcogsio-omnipay-firstatlanticcommerce-gateway/health.svg)

```
[![Health](https://phpackages.com/badges/cloudcogsio-omnipay-firstatlanticcommerce-gateway/health.svg)](https://phpackages.com/packages/cloudcogsio-omnipay-firstatlanticcommerce-gateway)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)