knit-pay / payum-payu-india
The Payum extension. It provides PayU India (payu.in) and PayUBiz payment gateway integration.
Requires
- payum/core: ^1.5
Requires (Dev)
- php-http/guzzle6-adapter: ^1.1.1
This package is auto-updated.
Last update: 2024-05-16 18:22:33 UTC
README
The Payum extension. It provides PayU India and PayUBiz payment integration.
Before proceeding, kindly create an account at PayU if you don't have one already.
Sign Up on PayU Live
For Testing, kindly create an account at PayU UAT Dashboard if you don't have one already.
Sign Up on PayU Test/UAT
Installation
The preferred way to install the library is using composer. Run composer require to add dependencies to composer.json:
php composer.phar require knit-pay/payum-payu-india php-http/guzzle6-adapter
Register the payu_india
Payum factory using PayumBuilder
(config.php):
use Payum\Core\GatewayFactoryInterface; use KnitPay\PayuIndia\PayuIndiaGatewayFactory; $payum = (new PayumBuilder()) ->addDefaultStorages() ->addGatewayFactory('payu_india', function(array $config, GatewayFactoryInterface $gatewayFactory) { return new PayuIndiaGatewayFactory($config, $gatewayFactory); }) ->addGateway('payu_india', [ 'factory' => 'payu_india', 'merchant_key' => 'Key', // Change this. 'merchant_salt' => 'Salt', // Change this. 'sandbox' => true, ]) ->getPayum() ;
prepare.php
Here you have to modify a gatewayName
value. Set it to payu_india
. The rest remain almost the same as described in basic get it started documentation.
Optional fields can be added as shown in the code below.
$gatewayName = 'payu_india'; /** @var \Payum\Core\Payum $payum */ $storage = $payum->getStorage($paymentClass); $payment = $storage->create(); $payment->setNumber(uniqid()); $payment->setCurrencyCode('INR'); $payment->setTotalAmount(123); // 1.23 INR $payment->setDescription('A description'); $payment->setClientId('anId'); $payment->setClientEmail('foo@example.com'); $payment->setDetails(array( // put here any fields in a gateway format. // for example if you use PayU India you can define optional fields like this. // Kindly refer to this link for more details. https://devguide.payu.in/docs/payu-hosted-checkout/payu-hosted-checkout-integration/https://devguide.payu.in/docs/payu-hosted-checkout/payu-hosted-checkout-integration/ // Uncomment the optional field below that you want to pass to the payment gateway. //'firstname' => 'First Name', //'lastname' => 'Last Name', //'address1' => 'Address Line 1', //'address2' => 'Address Line 2', //'city' => 'City', //'state' => 'State', //'country' => 'Country', //'zipcode' => 'Zip Code', //'phone' => 'Phone Number', //'pg' => 'CC', //'enforce_paymethod' => 'creditcard', //'display_lang' => 'Hindi' ));
capture.php
capture.php remains almost the same as described in basic get it started documentation. Although there is a minor modification. We need need to handle the HttpPostRedirect response also.
/** @var \Payum\Core\GatewayInterface $gateway */ if ($reply = $gateway->execute(new Capture($token), true)) { if ($reply instanceof HttpRedirect) { header("Location: ".$reply->getUrl()); die(); } elseif ($reply instanceof HttpPostRedirect) { echo $reply->getContent(); die(); } throw new \LogicException('Unsupported reply', null, $reply); }
Support
Feel free to contact us for any kind of support required. https://www.knitpay.org/contact-us/