README

A simple laravel 5 server-to-server Simplepay payment gateway library.

Setps for installation:

Use following command in your terminal to install this library. (Currently the library is in development mode):

composer require Dploy/simplepay dev-master

Update the poviders in config/app.php

 'providers' => [
     // ...
     Dploy\Simplepay\SimplepayServiceProvider::class,
 ]

Update the aliases in config/app.php

 'aliases' => [
     // ...
     'Simplepay' => Dploy\Simplepay\Facade\Simplepay::class,
 ]

Add following line in composer.json in your project root only

  "autoload": {
         "psr-4": {
 	        ......
 	        ......
             "Dploy\\Simplepay\\": "src/"
         }
     },

Use composer command in your terminal
```
 composer dumpautoload
```
To use your own settings, publish config.
```
 $ php artisan vendor:publish
```

This is going to add config/simplepay.php file

NOTE: Make sure you have curl install in your system.

Examples:

Please find the example below:

	//add name space in your controller
	use Simplepay
	use Dploy\Simplepay\Models\CreateSyncPaymentRequest;

	//In controller action, add the following code

	//Get the request object, this is going to hold all your parameters
	$obj= new CreateSyncPaymentRequest();

	//add parameters
	$obj->currency = "USD";
	$obj->paymentBrand = "VISA";
	$obj->paymentType = "DB";
	$obj->amount = "92.00";
	$obj->cardNumber = "4200000000000000";
	$obj->cardHolder = "Mr. Abc";
	$obj->cardcvv = "125";
	$obj->cardExpiryMonth = "02";
	$obj->cardExpiryYear = "2019";

	//Now we are ready to make our call, this is going to make your direct payment in simplepay gateway
	$result = Simplepay::createSyncPayment($obj);

	//Here you can check the response returned by simplepay gateway
	var_dump($result);

Results:

If all parameters are correct then API will return the following array structure. Please note the in test mode the message will be "Request successfully processed in 'Merchant in Integrator Test Mode'"

	array(6) {
	  ["isSuccess"]=>
	  bool(true)
	  ["message"]=>
	  string(68) "Request successfully processed"
	  ["code"]=>
	  string(11) "000.100.110"
	  ["crud"]=>
	  string(579) "{"id":"8a82944a571dace401574ca1d2ec4290","paymentType":"DB","paymentBrand":"VISA","amount":"92.00","currency":"USD","descriptor":"5486.6167.4658 OPP_Channel ","result":{"code":"000.100.110","description":"Request successfully processed in 'Merchant in Integrator Test Mode'"},"card":{"bin":"420000","last4Digits":"0000","expiryMonth":"02","expiryYear":"2019"},"risk":{"score":"100"},"buildNumber":"34cf17be72dfb23fff3ba15de38c948bcddfcca6@2016-09-20 10:54:39 +0000","timestamp":"2016-09-21 12:04:16+0000","ndc":"8a8294184e542a5c014e691d33f808c8_b86252609caf47ce8bd7ab309dd425b1"}"
	  ["registrationId"]=>
	  bool(false)
	  ["id"]=>
	  string(32) "8a82944a571dace401574ca1d2ec4290"
	}

If case of error or missing parameters Errors are thrown using classes

SimplepayException

For example:

	throw new SimplepayException($request);

Simplepay server-to-server payment API note:

NOTE: You should be fully PCI compliant if you wish to perform an initial payment request server-to-server (as it requires that you collect the card data). If you are not fully PCI compliant, you can use Simplepay.js to collect the payment data securely.

Methods

createToken
createTokenPayment
deleteToken
createSyncPayment ( This method make payment directly )
createAsyncPayment ( This method initialize payment )
getPaymentStatus
createInitialRecurringPayment
createRepeatedRecurringPayment

Supported Brands

This library support only following brands: VISA MASTER AMEX ALIPAY CHINAUNIONPAY

Asynchronous methods Support following brands: ALIPAY CHINAUNIONPAY

Synchronous methods supprts following brands: VISA MASTER AMEX

Path to Config file:

	/src/Config/simplepay.php

Environment variables used:

	SIMPLEPAY_TEST_ENDPOINT=https://test.oppwa.com/
	SIMPLEPAY_LIVE_ENDPOINT=https://oppwa.com/
	SIMPLEPAY_VERSION=v1
	SIMPLEPAY_API_ENVIRONMENT=test
	SIMPLEPAY_USER_ID = replace with your userId
	SIMPLEPAY_ENTITY_ID = replace with your entityid
	SIMPLEPAY_PASSWORD = replace with your password

Synchronous workflow

Each paymentBrand follows one of two workflows: asynchronous or synchronous. In a synchronous workflow the payment data is sent directly in the server-to-server initial payment request and the payment is processed straight away.

Send an Initial Payment

Asynchronous workflow

In an asynchronous workflow a redirection takes place to allow the account holder to complete/verify the payment. After this the account holder is redirected back to the shopperResultUrl and the status of the payment can be queried.

Send an Initial Payment
Redirect the shopper
Get the payment status

Send an Initial Payment: use method [createAsyncPayment] for making initial payment

Redirect the Shopper:

The next step is to redirect the account holder. To do this you must parse the redirect_url from the Initial Payment response along with any parameters. If parameters are present they should be POST in the redirect, otherwise a straight forward redirect to the redirect_url is sufficient.

Get the payment status: use method [getPaymentStatus] for checking the payment status

#Tokenization & Registration: Simplepay note: NOTE: You should be fully PCI compliant if you wish to perform tokenization requests server-to-server (as it requires that you collect the card data). If you are not fully PCI compliant, you can use the Simplepay.js tokenization tutorial to collect the payment data securely.

Method details:

createToken:

Method to create token of user's credit card without making payment

* Requires:
* @param string userId
* @param string password
* @param string entityId
* @param string paymentBrand
* @param int cardNumber
* @param string cardHolder
* @param int cardExpiryMonth
* @param int cardExpiryYear
* @param int cardcvv

createTokenPayment:

Method to make payment in One Click

* Requires:
* @param string userId
* @param string entityId
* @param string password
* @param float amount
* @param string currency
* @param string paymentType
* @param int registrationId

One-Click payment : This method reqires 3 steps: 1. Authenticate user 2. Show Checkout 3. Send Payment

Step 1: Authenticate user
	You will need a method to authenticate the customer against your records in order to obtain their respective registration.id (token) associated with their account.  This can be achieved by asking the customer to log in for example, however you may find other ways that are applicable to your system.

	The information that you might want to store, per customer, in order to execute a One-Click payment includes:

	    registrationId (token): You can use 'createToken' method to store customer's card details (without making paymnet) or use 'createSyncPayments' method, and set createRegistration to true, to get the registrationId for user's card.
	    account brand: brand of customer's card
	    last four digits of account number
	    expiry date (if applicable)

Step 2: Show Checkout Form:
	Create a form, to show user's all stored cards (You need to create form similar to this  https://docs.simplepays.com/sites/default/files/one-click-checkout.png) and show the list of all the cards you have stored. You can take example of html from page "https://docs.simplepays.com/tutorials/server-to-server/one-click-payment-guide".

Step 3: Send Payment
 	When user click on pay button use method 'createTokenPayment' with the mentioned paramteres to complete the payment procedure.

deleteToken:

Method to make call for deleting the already existing user token Once stored, a token can be deleted against the registration.id:

* Requires:
* @param string userId
* @param string entityId
* @param string password
* @param int registrationId

createSyncPayment:

Method for making payment in a single step using server-to-server and receive the payment response synchronously.

* Requires:
* @param string userId
* @param string entityId
* @param string password
* @param float amount
* @param string currency
* @param string paymentBrand
* @param string paymentType
* @param int cardNumber
* @param string cardHolder
* @param int cardExpiryMonth
* @param int cardExpiryYear
* @param string cardcvv

createAsyncPayment:

Method to request for sending Initial Payment Request via Async method

* Requires:
* @param string userId
* @param string entityId
* @param string password
* @param float amount
* @param string currency
* @param string paymentBrand
* @param string shopperResultUrl
* @param string paymentType

6.getPaymentStatus:

Method to make request for payment status of both Async and Sync payments

* Requires:
* @param string userId
* @param string entityId
* @param string password
* @param string id

createInitialRecurringPayment:

Method to create token and make payment synchronously.

* Requires:
* @param string userId
* @param string entityId
* @param string password
* @param float amount
* @param string currency
* @param string paymentBrand
* @param string paymentType
* @param int cardNumber
* @param string cardHolder
* @param int cardExpiryMonth
* @param int cardExpiryYear
* @param string cardcvv

createRepeatedRecurringPayment:

Method to create token and make payment synchronously.

* Requires:
* @param string userId
* @param string entityId
* @param string password
* @param float amount
* @param string currency
* @param string paymentBrand
* @param string paymentType
* @param int cardNumber
* @param string cardHolder
* @param int cardExpiryMonth
* @param int cardExpiryYear
* @param string cardcvv

How simplepay works: https://docs.simplepays.com/tutorials/server-to-server

dployhub / simplepay

Maintainers

Details