clapp/omnipay-otphu

Experimental Omnipay v2.5 Payment Gateway for https://www.otpbank.hu

1.0.0-alpha2 2016-12-09 23:52 UTC

Requires

• php: ^5.5.9 | ~7.0
• nesbot/carbon: ~1.0
• omnipay/common: ^2.5.1
• openlss/lib-array2xml: ^0.0.10

Requires (Dev)

• fzaninotto/faker: ^1.6
• phpunit/phpunit: ~4.8
• satooshi/php-coveralls: dev-master

MIT

• Gergely Sárosi

• payment
• pay
• otp
• merchant
• purchase
• omnipay
• otpbank
• hungary
• magyar

README

Experimental package, not recommended for production.

Install

composer require clapp/omnipay-otphu:dev-master

Usage Example

<?php
include 'vendor/autoload.php';

$gateway = Omnipay\Omnipay::create("\\".Clapp\OtpHu\Gateway::class);

$gateway->setShopId("0199123456");
$gateway->setPrivateKey(file_get_contents('myShopKey.privKey.pem'));
$gateway->setTestMode(false);

try {
    $request = $gateway->purchase([
        'amount' => '100.00',
        'currency' => 'HUF',
        'returnUrl' => 'https://www.example.com/processing-your-payment',
    ]);
    $response = $request->send();

    if ($response->isRedirect()){
        $redirectionUrl = $response->getRedirectUrl();
        $transactionId = $response->getTransactionId();
        /**
         * redirect the user to $redurectionUrl and store $transactionId for later use
         */
    }
}catch(Exception $e){
    /**
     * something went wrong
     */
}

// after the user is redirected back to our site by OTP
<?php
include 'vendor/autoload.php';

$gateway = Omnipay\Omnipay::create("\\".Clapp\OtpHu\Gateway::class);

$gateway->setShopId("0199123456");
$gateway->setPrivateKey(file_get_contents('myShopKey.privKey.pem'));
$gateway->setTestMode(false);

try {
    $response = $gateway->completePurchase([
        'transactionId' => 'myTransactionId',
    ])->send();

    if ($response->isSuccessful()){
        /**
         * the user's payment was successful
         */
    }
    if ($response->isPending()){
        /**
         * the user's payment is still pending, we should try $gateway->completePurchase() later
         */
    }
    if ($response->isCancelled()){
        /**
         * the user cancelled the payment
         */
    }
    if ($response->isRejected()){
        /**
         * the payment gateway rejected the user's payment
         */
         $reasonCode = $response->getTransaction()->getRejectionReasonCode(); //OTP's error code string
         $reasonMessage = $response->getTransaction()->getRejectionReasonMessage(); //human readable string
    }
}catch(Exception $e){
    /**
     * something went wrong
     */
}

Documentation

In the /docs folder or on Github Pages.