digitickets/omnipay-paymentsense-connect-e

Connect-e payment driver for omnipay, aka Cybersource

v1.2 2024-05-14 16:19 UTC

README

Javascript gateway driver for Paymentsense's Connect-E service

Omnipay implementation of Paymentsense's Connect-E gateway.

See Paymentsense documentation for more details.

Installation

This driver is installed via Composer. To install, simply add it to your composer.json file:

{
    "require": {
        "digitickets/omnipay-paymentsense-connect-e": "^1.0"
    }
}

And run composer to update your dependencies:

$ curl -s http://getcomposer.org/installer | php
$ php composer.phar update

What's Included

This driver allows you to retrieve an authcode using a JWT key, and once the transaction is complete, to check the validity of the payment at the gateway.

It also supports refunds of partial and full amounts.

It only handles card payments.

You can enable the 2 step process instead of 1 step by passing in waitPreExecute=true. Make sure to call acceptNotification() to confirm you wish to take the payment. https://docs.connect.paymentsense.cloud/ConnectE/WaitPreExecuteOneOffPayment

What's Not Included

This driver does not handle any of the other card management operations, such as subscriptions (repeat payments).

Basic Usage

For general Omnipay usage instructions, please see the main Omnipay repository.

First call the authorize() endpoint. Then call getTransactionReference() on the response. This will get you the authcode for passing into the connect-e javascript SDK.

Once the customer has paid via the SDK, you should call acceptNotification() to check that the payment was complete. Pass in the same authcode you got from authorize() in as a transactionReference param. This will return a transactionReference param, which can be used in the refund() call if required (note this is also known as crossReference or Request ID).

Required Parameters

You must pass the following parameters into the driver when calling authorize(), acceptNotification() or refund(). You will be sent these by the Paymentsense onboarding team.

jwt
merchantUrl

Support

If you are having general issues with Omnipay, we suggest posting on Stack Overflow. Be sure to add the omnipay tag so it can be easily found.

If you believe you have found a bug in this driver, please report it using the GitHub issue tracker, or better yet, fork the library and submit a pull request.