Omnipay: NestPay

NestPay (EST) (İş Bankası, Akbank, Finansbank, Denizbank, Kuveytturk, Halkbank, Anadolubank, ING Bank, Citibank, Cardplus) gateway for Omnipay payment processing library

Omnipay is a framework agnostic, multi-gateway payment processing library for PHP 5.3+. This package implements NestPay (Turkey Payment Gateways) support for Omnipay.

NestPay (Eski adıyla EST) altyapısını kullanan Türkiye bankaları için Omnipay kütüphanesi. Desteklenmesi hedeflenen bankalar; İş Bankası, Akbank, Finansbank, Denizbank, Kuveytturk, Halkbank, Anadolubank, ING Bank, Citibank, Cardplus.

Installation

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

{
    "require": {
        "yasinkuyu/omnipay-nestpay": "~2.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:

• NestPay
  • İş Bankası
  • Akbank
  • Finansbank
  • Denizbank
  • Kuveytturk
  • Halkbank
  • Anadolubank
  • ING Bank
  • Citibank
  • Cardplus

Gateway Methods

• authorize($options) - authorize an amount on the customer's card
• completeAuthorize($options) - handle return from off-site gateways after authorization
• capture($options) - capture an amount you have previously authorized
• purchase($options) - authorize and immediately capture an amount on the customer's card
• completePurchase($options) - handle return from off-site gateways after purchase
• refund($options) - refund an already processed transaction
• void($options) - generally can only be called up to 24 hours after submitting a transaction

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

Unit Tests

PHPUnit is a programmer-oriented testing framework for PHP. It is an instance of the xUnit architecture for unit testing frameworks.

Sample App

    <?php defined('BASEPATH') OR exit('No direct script access allowed');

    use Omnipay\Omnipay;

    class PaymentTest extends CI_Controller {

        public function index() {

            $gateway = Omnipay::create('NestPay');

            $gateway->setBank("denizbank");
            $gateway->setUserName("DENIZTEST");
            $gateway->setClientId("800100000");
            $gateway->setPassword("DENIZTEST123");
            $gateway->setTestMode(TRUE);

            $options = [
                'number'        => '5406675406675403',
                'expiryMonth'   => '12',
                'expiryYear'    => '2015',
                'cvv'           => '000',
                'email'         => '[email protected]',
                'firstname'     => 'Yasin',
                'lastname'      => 'Kuyu'
            ];

            $response = $gateway->purchase(
            [
                //'installments'  => '', # Taksit
                //'moneypoints'   => 1.00, // Set money points (Maxi puan gir)
                'amount'        => 12.00,
                'type'          => 'Auth',
                'orderid'       => 'ORDER-365123',
                'card'          => $options
            ]
            )->send();

            $response = $gateway->authorize(
            [
                'type'          => 'PostAuth',
                'orderid'       => 'ORDER-365123',
                'card'          => $options
            ]
            )->send();

            $response = $gateway->capture(
            [
                'orderid'       => 'ORDER-365123',
                'amount'        => 1.00,
                'currency'      => 'TRY',
                'card'          => $options
            ]
            )->send();


            $response = $gateway->refund(
            [
                'orderid'       => 'ORDER-365123',
                'amount'        => 1.00,
                'currency'      => 'TRY',
                'card'          => $options
            ]
            )->send();

            $response = $gateway->credit(
            [
                'orderid'       => 'ORDER-365123',
                'amount'        => 1.00,
                'currency'      => 'TRY', // Optional (default parameter TRY)
                'card'          => $options
            ]
            )->send();

            $response = $gateway->void(
            [
                'orderid'       => 'ORDER-365123',
                'amount'        => 1.00,
                'currency'      => 'TRY',
                'card'          => $options
            ]
            )->send();

              $response = $gateway->credit(
            [
                'amount'        => 1.00,
                'card'          => $options
            ]
            )->send();

            $response = $gateway->settle(
            [
                'settlement'   => true,
                'card'         => $options
            ]
            )->send();

            $response = $gateway->money(
            [
                'moneypoints'  => "1",
                'card'         => $options
            ]
            )->send();

            if ($response->isSuccessful()) {
                //echo $response->getTransactionReference();
                echo $response->getMessage();
            } else {
                echo $response->getError();
            }

            // Debug
            //var_dump($response);

        }

    }

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 want to keep up to date with release anouncements, discuss ideas for the project, or ask more detailed questions, there is also a mailing list which you can subscribe to.

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