README

PayU driver for the Omnipay PHP payment processing library

Omnipay is a framework agnostic, multi-gateway payment processing library for PHP 5.6+. This package implements PayU Online Payment Gateway support for Omnipay v3.

PayU REST API 2.1 documentation

This implementation uses OAuth 2

Installation

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

{
    "require": {
        "alias2k/omnipay-payu": "~1.0.0"
    }
}

TL;DR

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

use Omnipay\PayU\GatewayFactory;

$dotenv = new Dotenv\Dotenv(__DIR__);
$dotenv->load();

// default is official sandbox
$posId = isset($_ENV['POS_ID']) ? $_ENV['POS_ID'] : '300046';
$secondKey = isset($_ENV['SECOND_KEY']) ? $_ENV['SECOND_KEY'] : '0c017495773278c50c7b35434017b2ca';
$oAuthClientSecret = isset($_ENV['OAUTH_CLIENT_SECRET']) ? $_ENV['OAUTH_CLIENT_SECRET'] : 'c8d4b7ac61758704f38ed5564d8c0ae0';

$gateway = GatewayFactory::createInstance($posId, $secondKey, $oAuthClientSecret, true);

try {
    $orderNo = '12345677';
    $returnUrl = 'http://localhost:8000/gateway-return.php';
    $description = 'Shopping at myStore.com';

    $purchaseRequest = [
        'purchaseData' => [
            'customerIp'    => '127.0.0.1',
            'continueUrl'   => $returnUrl,
            'notifyUrl'     => $notifyUrl,
            'merchantPosId' => $posId,
            'description'   => $description,
            'currencyCode'  => 'PLN',
            'totalAmount'   => 15000,
            'extOrderId'    => $orderNo,
            'buyer'         => (object)[
                'email'     => 'test@test.com',
                'firstName' => 'Tester',
                'lastName'  => 'Tester',
                'language'  => 'pl'
            ],
            'products'      => [
                (object)[
                    'name'      => 'Lenovo ThinkPad Edge E540',
                    'unitPrice' => 15000,
                    'quantity'  => 1
                ]
            ],
            'payMethods'    => (object)[
                'payMethod' => (object)[
                    'type'  => 'PBL', // this is for card-only forms (no bank transfers available)
                    'value' => 'c'
                ]
            ]
        ]
    ];

    $response = $gateway->purchase($purchaseRequest);

    echo "TransactionId: " . $response->getTransactionId() . PHP_EOL;
    echo 'Is Successful: ' . (bool) $response->isSuccessful() . PHP_EOL;
    echo 'Is redirect: ' . (bool) $response->isRedirect() . PHP_EOL;

    // Payment init OK, redirect to the payment gateway
    echo $response->getRedirectUrl() . PHP_EOL;
} catch (\Exception $e) {
    dump((string)$e);
}

For custom sandbox payu gateway prepare .env file based on .env-default.

Test cards

Positive authorization

Negative authorization

The expiration date of cards range should be valid date range, value CVC / CVV2 (3 random digits). Sandbox environment doesn't support 3DS.