README.md

Paypal NVP Api

This php class will simply consume the paypal NVP Api for make a simple payment.

Installation

Add this line into require in your composer.json:

composer require emirazaiez/paypal

then add this line to your php file (Or not if you use a framework)

require 'vendor/autoload.php'

You can get all informations about the paypal API and the paypal Configuration in this page : Paypal Developer

A few examples: (You can also check sample.php)

This is just an exemple, it's better if for each "function" you do a route

Simple make a call request to the API for get a paypal payment URL : (route can be something like : /paypal/checkout)

<?php
session_start(); //For use the 'transferData'

require 'vendor/autoload.php'

use Paypal\CheckoutManager;

$paypalConfig = array(
    'mode' => 'sandbox', // You can provide 'prod' for use the real paypal service
    'user' => '', // You can get it from paypal service
    'password' => '', // You can get it from paypal service
    'signature' => '', // You can get it from paypal service
    'lang' => 'EN'
);

$productConfig = array(
    'price' => 5,
    'currency' => 'USD',
    'description' => 'My app subscription for 1 month', //Which will be show on the paypal payment page
    'logo' => 'http://creativebits.org/files/500px-Apple_Computer_Logo.svg_.png', //Logo of your company
    'returnURL' => 'http://myweb.com/paypal/return', //The return url will be passed to paypal, this url will be call by paypal when the transfere will be done
    'cancelURL' => 'http://myweb.com/paypal/cancel', //The return url will be passed to paypal, this url will be call when the user cancel the payment
    'transferData' => array('productID' => '1', 'quantity' => '1month') //Those data arn't used by paypal, you can put whatever you want. Those data will be avaible on success of the "return url" called by paypal (You can only use this if you start the session)
);

$paypal = new CheckoutManager($paypalConfig['mode'], $paypalConfig['user'], $paypalConfig['password'], $paypalConfig['signature'], $paypalConfig['lang']);

$paypal->requestExpressCheckout($productConfig['price'], $productConfig['currency'], $productConfig['description'], $productConfig['logo'], $productConfig['returnURL'], $productConfig['cancelURL'])
       ->setTransferData($productConfig['transferData'])
       ->execute(
        function($paypalCheckoutURL,$success) {
            //Put your own logic here
            //You can redirect the user directly to paypal checkout shop :
            header("Location: " . $paypalCheckoutURL);
        },
        function($errors) {
            //Put your own logic here
        });

Simple return of paypal API : (route can be something like : /paypal/return)

<?php

$paypal = new CheckoutManager($paypalConfig['mode'], $paypalConfig['user'], $paypalConfig['password'], $paypalConfig['signature'], $paypalConfig['lang']);

$paypal->requestExpressCheckoutPayment($_GET['token'], $_GET['PayerID'])
       ->execute(
        function($transferedData, $paypalUser, $success) {
            //Put your own logic here (Will be some db call for save everything)
        }, 
        function($errors) {
            //Put your own logic here
        });

Cancel payment : (route can be something like : /paypal/cancel)

<?php

$paypal = new CheckoutManager($paypalConfig['mode'], $paypalConfig['user'], $paypalConfig['password'], $paypalConfig['signature'], $paypalConfig['lang']);

$paypal->requestExpressCheckoutDetails($_GET['token'])
       ->execute(
        function($transferedData, $paypalUser) {
            //Put your own logic here
        }, 
        function($errors) {
            //Put your own logic here
        });

Authors

Emir Azaiez