2017 © Pedro Peláez
 

library genesis_php

PHP Client for Genesis Payment Processing Gateway

image

muratsplat/genesis_php

PHP Client for Genesis Payment Processing Gateway

  • Tuesday, July 12, 2016
  • by muratsplat
  • Repository
  • 0 Watchers
  • 0 Stars
  • 2,751 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 12 Versions
  • 6 % Grown

The README.md

Genesis PHP

Build Status Latest Stable Version Total Downloads Software License, (*1)

Overview

Client Library for processing payments through Genesis Payment Processing Gateway. Its highly recommended to checkout "Genesis Payment Gateway API Documentation" first, in order to get an overview of Genesis's Payment Gateway API and functionality., (*2)

Requirements

Note: Most of the extension are part of PHP and enabled by default, however some distributions are using custom configuration that might have some of them removed/disabled., (*3)

Installation

git clone http://github.com/GenesisGateway/genesis_php genesis_php && cd genesis_php

Getting Started

');
Config::setUsername('');
Config::setPassword('');
Config::setToken('');

// Create a new Genesis instance with desired API request
$genesis = new \Genesis\Genesis('Financial\Cards\Authorize');

// Set request parameters
$genesis
    ->request()
        ->setTransactionId('43671')
        ->setUsage('40208 concert tickets')
        ->setRemoteIp('245.253.2.12')
        ->setAmount('50')
        ->setCurrency('USD')
        // Customer Details
        ->setCustomerEmail('emil@example.com')
        ->setCustomerPhone('1987987987987')
        // Credit Card Details
        ->setCardHolder('Emil Example')
        ->setCardNumber('4200000000000000')
        ->setExpirationMonth('01')
        ->setExpirationYear('2020')
        ->setCvv('123')
        // Billing/Invoice Details
        ->setBillingFirstName('Travis')
        ->setBillingLastName('Pastrana')
        ->setBillingAddress1('Muster Str. 12')
        ->setBillingZipCode('10178')
        ->setBillingCity('Los Angeles')
        ->setBillingState('CA')
        ->setBillingCountry('US');

try {
    // Send the request
    $genesis->execute();

    // Successfully completed the transaction - display the gateway unique id
    echo $genesis->response()->getResponseObject()->unique_id;
}
// Log/handle API errors
// Example: Declined transaction, Invalid data, Invalid configuration
catch (\Genesis\Exceptions\ErrorAPI $api) {
    echo $genesis->response()->getResponseObject()->technical_message;
}
// Log/handle invalid parameters
// Example: Empty (required) parameter
catch (\Genesis\Exceptions\ErrorParameter $parameter) {
    error_log($parameter->getMessage());
}
// Log/handle network (transport) errors
// Example: SSL verification errors, Timeouts
catch (\Genesis\Exceptions\ErrorNetwork $network) {
    error_log($network->getMessage());
}

?>

Note: the file vendor/autoload.php is located inside the directory where you cloned the repo and it is auto-generated by Composer. If the file is missing, just run php composer.phar update inside the root directory, (*4)

Notifications

When using an Asynchronous workflow, you need to parse the incoming extension in order to ensure its authenticity and verify it against Genesis server., (*5)

Example:, (*6)

initReconciliation();

    // Application Logic
    // ...
    // for example, process the transaction status
    // $status = $notification->getReconciliationObject()->status;

    // Respond to Genesis
    $notification->renderResponse();
}
catch (\Exception $e) {
    error_log($e->getMessage());
}

?>

Endpoints

The current versions supports two separate endpoints: E-ComProcessing and eMerchantPay, (*7)

For example:, (*8)

  • You can set the Endpoint to E-ComProcessing, thus all the requests will go to E-ComProcessings Genesis instance:
\Genesis\Config::setEndpoint('e-comprocessing');
  • You can set the Endpoint to eMerchantPay, thus all the requests will go to eMerchantPays Genesis instance:
\Genesis\Config::setEndpoint('emerchantpay');

Request types

You can use the following request types to initialize the Genesis client:, (*9)

// Generic transaction operations
Financial\Capture
Financial\Refund
Financial\Void

// Alternative Payment Methods transactions
Financial\Alternatives\ABNiDEAL
Financial\Alternatives\CashU
Financial\Alternatives\Paysafecard
Financial\Alternatives\POLi
Financial\Alternatives\PPRO
Financial\Alternatives\Sofort

// PayByVouchers transactions
Financial\PayByVouchers\oBeP
Financial\PayByVouchers\Sale

// Credit Cards transactions
Financial\Cards\Authorize
Financial\Cards\Authorize3D
Financial\Cards\Credit
Financial\Cards\Payout
Financial\Cards\Sale
Financial\Cards\Sale3D
Financial\Cards\Recurring\InitRecurringSale
Financial\Cards\Recurring\InitRecurringSale3D
Financial\Cards\Recurring\RecurringSale

// Electronic Wallets transactions
Financial\Wallets\eZeeWallet
Financial\Wallets\Neteller
Financial\Wallets\WebMoney

// Generic (Non-Financial) requests
NonFinancial\AVS
NonFinancial\AccountVerification
NonFinancial\Blacklist

// Chargeback information request
NonFinancial\Fraud\Chargeback\DateRange
NonFinancial\Fraud\Chargeback\Transaction

// SAFE/TC40 Report
NonFinancial\Fraud\Reports\DateRange
NonFinancial\Fraud\Reports\Transaction

// Retrieval request
NonFinancial\Fraud\Retrieval\DateRange
NonFinancial\Fraud\Retrieval\Transaction

// Reconcile requests
NonFinancial\Reconcile\DateRange
NonFinancial\Reconcile\Transaction

// Get ABN iDEAL supported banks
NonFinancial\Retrieve\AbniDealBanks

// Web Payment Form (Checkout) requests
WPF\Create
WPF\Reconcile

More information about each one of the request types can be found in the Genesis API Documentation and the Wiki, (*10)

Running Specs

The following step are optional, however its recommended to run specs at least once, in order to ensure that everything is working as intended on your setup, (*11)

  • install Composer (if you don't have it already)
curl -sS https://getcomposer.org/installer | php
  • fetch all required packages
php composer.phar install
  • run phpspec
php vendor/bin/phpspec run

The Versions

12/07 2016

dev-master

9999999-dev

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

  • php >=5.3.2
  • ext-bcmath *
  • ext-curl *
  • ext-filter *
  • ext-hash *
  • ext-simplexml *
  • ext-xmlreader *
  • ext-xmlwriter *

 

The Development Requires

e-commerce payments authorize recurring webmoney sofort ideal paysafecard fraud trustpay visa mastercard poli void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso payment_processing paybyvouchers tc40 chargeback genesisgateway pci-dss

12/07 2016

1.5.1

1.5.1.0

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

  • php >=5.3.2
  • ext-bcmath *
  • ext-curl *
  • ext-filter *
  • ext-hash *
  • ext-simplexml *
  • ext-xmlreader *
  • ext-xmlwriter *

 

The Development Requires

e-commerce payments authorize recurring webmoney sofort ideal paysafecard fraud trustpay visa mastercard poli void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso payment_processing paybyvouchers tc40 chargeback genesisgateway pci-dss

12/07 2016

dev-dev-hotfix-response-conflict

dev-dev-hotfix-response-conflict

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

  • php >=5.3.2
  • ext-bcmath *
  • ext-curl *
  • ext-filter *
  • ext-hash *
  • ext-simplexml *
  • ext-xmlreader *
  • ext-xmlwriter *

 

The Development Requires

e-commerce payments authorize recurring webmoney sofort ideal paysafecard fraud trustpay visa mastercard poli void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso payment_processing paybyvouchers tc40 chargeback genesisgateway pci-dss

12/07 2016

dev-dev-hotfix

dev-dev-hotfix

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

  • php >=5.3.2
  • ext-bcmath *
  • ext-curl *
  • ext-filter *
  • ext-hash *
  • ext-simplexml *
  • ext-xmlreader *
  • ext-xmlwriter *

 

The Development Requires

e-commerce payments authorize recurring webmoney sofort ideal paysafecard fraud trustpay visa mastercard poli void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso payment_processing paybyvouchers tc40 chargeback genesisgateway pci-dss

12/07 2016

dev-feature/hotFixPickUpRawResponse

dev-feature/hotFixPickUpRawResponse

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

  • php >=5.3.2
  • ext-bcmath *
  • ext-curl *
  • ext-filter *
  • ext-hash *
  • ext-simplexml *
  • ext-xmlreader *
  • ext-xmlwriter *

 

The Development Requires

e-commerce payments authorize recurring webmoney sofort ideal paysafecard fraud trustpay visa mastercard poli void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso payment_processing paybyvouchers tc40 chargeback genesisgateway pci-dss

08/06 2016

1.4.3

1.4.3.0

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

  • php >=5.3.2
  • ext-bcmath *
  • ext-curl *
  • ext-filter *
  • ext-hash *
  • ext-simplexml *
  • ext-xmlreader *
  • ext-xmlwriter *

 

The Development Requires

e-commerce payments authorize recurring webmoney sofort ideal paysafecard fraud trustpay visa mastercard poli void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso payment_processing paybyvouchers tc40 chargeback genesisgateway pci-dss

08/06 2016

dev-feature/issue4

dev-feature/issue4

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

  • php >=5.3.2
  • ext-bcmath *
  • ext-curl *
  • ext-filter *
  • ext-hash *
  • ext-simplexml *
  • ext-xmlreader *
  • ext-xmlwriter *

 

The Development Requires

e-commerce payments authorize recurring webmoney sofort ideal paysafecard fraud trustpay visa mastercard poli void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso payment_processing paybyvouchers tc40 chargeback genesisgateway pci-dss

10/05 2016

1.4.2

1.4.2.0

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

  • php >=5.3.2
  • ext-bcmath *
  • ext-curl *
  • ext-filter *
  • ext-hash *
  • ext-simplexml *
  • ext-xmlreader *
  • ext-xmlwriter *

 

The Development Requires

e-commerce payments authorize recurring webmoney sofort ideal paysafecard fraud trustpay visa mastercard poli void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso payment_processing paybyvouchers tc40 chargeback genesisgateway pci-dss

14/04 2016

1.4.1

1.4.1.0

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

  • php >=5.3.2
  • ext-bcmath *
  • ext-curl *
  • ext-filter *
  • ext-hash *
  • ext-simplexml *
  • ext-xmlreader *
  • ext-xmlwriter *

 

The Development Requires

e-commerce payments authorize recurring webmoney sofort ideal paysafecard fraud trustpay visa mastercard poli void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso payment_processing paybyvouchers tc40 chargeback genesisgateway pci-dss

11/12 2015

1.4.0

1.4.0.0

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

  • php >=5.3.2
  • ext-bcmath *
  • ext-curl *
  • ext-filter *
  • ext-hash *
  • ext-simplexml *
  • ext-xmlreader *
  • ext-xmlwriter *

 

The Development Requires

e-commerce payments authorize recurring webmoney sofort ideal paysafecard fraud trustpay visa mastercard poli void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso payment_processing paybyvouchers tc40 chargeback genesisgateway pci-dss

31/07 2015

1.3.1

1.3.1.0

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

 

e-commerce payments authorize recurring sofort ideal paysafecard trustpay visa mastercard void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso payment_processing genesisgateway pci-dss paybyvoucher

30/07 2015

1.3.0

1.3.0.0

PHP Client for Genesis Payment Processing Gateway

  Sources   Download

MIT

The Requires

 

e-commerce payments authorize recurring sofort ideal paysafecard trustpay visa mastercard void cashu qiwi capture neteller genesis safetypay eps przelewy24 payment_gateway credit_card debit_card refund 3d-secure ezeewallet ppro elv giropay teleingreso genesisgateway pci-dss paybyvoucher