digitickets / omnipay.paymentsense
Custom OmniPay driver for PaymentSense
Installs: 34 885
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 3
Forks: 0
Open Issues: 0
Requires
- php: ^7.0
- league/iso3166: ^2.1
- omnipay/common: ~2.0
Requires (Dev)
- omnipay/tests: ~2.0
- squizlabs/php_codesniffer: ~1.5
README
PaymentSense driver for the Omnipay PHP payment library
Omnipay is a framework agnostic, multi-gateway payment processing library for PHP 5.3+.
This package implements only PaymentSense support for Omnipay 2.x Off-sites, where the customer is redirected to enter payment details
Installation
This package is installed via Composer. To install, simply add it
to your composer.json
file:
{ "require": { "digitickets/omnipay.paymentsense": "^0.*" } }
And run composer to update your dependencies:
$ curl -s http://getcomposer.org/installer | php
$ php composer.phar update
Basic Usage
The following gateways are provided by this package:
- PaymentSense
For general usage instructions, please see the main Omnipay repository.
This is a sample code of standard Off-site controller using the driver.
Request a payment
// Gateway setup
$gateway = $this->gatewayFactory('PaymentSense');
// Pluigns specific parameters
gateway->setMerchantId('00000001');
$gateway->setPassword('#asPdasd_asd');
$gateway->setPreSharedKey('asdqweasdzxc');
// Create or fetch your product transaction
$transaction = $this->createTransaction($request);
// Get the data ready for the payment
// Please note that even off-site gateways make use of the CreditCard object,
// because often you need to pass customer billing or shipping details through to the gateway.
$cardData = $transaction->asOmniPay;
$itemsBag = $this->requestItemsBag($request);
// Authorize request
$request = $gateway->purchase(array(
'amount' => $transaction->amount,
'currency' => $transaction->currency,
'card' => $cardData,
'returnUrl' => $this->generateCallbackUrl(
'PaymentSense',
$transaction->id
),
'transactionId' => $transaction->id,
'description' => $transaction->description,
'items' => $itemsBag,
));
// Send request
$response = $request->send();
// Process response
$this->processResponse($response);
Process payment result
// Fetch transaction details
$transaction = Transaction::findOrFail($transactionId);
// Gateway setup
$gateway = $this->gatewayFactory('PaymentSense');
// Pluigns specific parameters
gateway->setMerchantId('00000001');
$gateway->setPassword('#asPdasd_asd');
$gateway->setPreSharedKey('asdqweasdzxc');
// Get the data ready to complete the payment. Since this is typically a stateless callback
// we need to first retrieve our original product transaction details
$params = [
"amount" => $transaction->amount,
"currency" => $transaction->currency,
'returnUrl' => $this->generateCallbackUrl(
'PaymentSense',
$transaction->id
),
'transactionId' => $transaction->id,
'transactionReference' => $transaction->ref,
];
// Complete purchase request
$request = $gateway->completePurchase($params);
// Send request
$response = $request->send();
// Process response
$this->processResponse($response);