Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shurjopay-plugins/raw-php

Sample code for PHP demonstration
https://github.com/shurjopay-plugins/raw-php

Last synced: about 1 month ago
JSON representation

Sample code for PHP demonstration

Awesome Lists containing this project

README

        

![image](https://user-images.githubusercontent.com/57352037/170198396-932692aa-3354-4cf0-abc1-2b8ef43a6de3.png)
# ShurjoPay

Shurjopay raw-php integration steps
## Prerequisite
To integrate ShurjoPay you need few credentials to access shurjopay:
```
:param prefix: Any string not more than 5 characters. It distinguishes the stores of a merchant.
:param currency: ISO format,(only BDT and USD are allowed).
:param return_url: Merchant should provide a GET Method return url to verify users initiated transaction status.
:param cancel_url: Merchant should provide a cancel url to redirect the user if he/she cancels the transaction in midway.
:param client_ip: User's ip
:param username: Merchant Username provided by shurjopay.
:param password: Merchant Password provided by shurjopay.
:param post_address: Live shurjopay version 2 URL.
```

> 📝 **NOTE** For shurjoPay version 2 live engine integration's all necessary credential will be given to merchant after subscription completed on shurjoPay gateway.

### PHP shurjoPay(V2) Plugin ###
This repository is to integrate shurjoPay with Raw PHP.


### How do I get set up? ###
## Step 1: ##
Upload all the files of this repository to your web root(i.e. localhost or your-domain-name).
It is recommended to create a shurjopay folder and upload the files within it.
(i.e. localhost//shurjopay/index.php OR your-domain-name/shurjopay/index.php)
Go to browser and point the folder (i.e. localhost/shurjopay/ )your need.

## Step 2: ##
Set up the config.php file with the live credentials given to you after getting on-boarded with shurjoPay.
For example:
define('USERNAME','');
define('PASSWORD','');
define('TESTMODE', FALSE);
define('PREFIX','NOK');

Note that, if you are trying to integrate with sandbox then do not change anything in config.php.

## Step 3: ##
Change the $return_url before passing the checkout form data.
For reference, check the sp.php file.
For example: $return_url = 'http://localhost//shurjopay/return.php';
(You can customize the return.php file with the necessary front-end utilities if you like to.)

## Step 4: ##
Call the "generate_shurjopay_form($payload)" function and pass the necessary checkout datas as an array parameter in it.
For reference, check the sp.php file.
Example of the $payload:
$payload = array(
'currency' => 'BDT',
'return_url' => $return_url,
'cancel_url' => $return_url,
'amount' => $amount,
// Order information
'prefix' => 'NOK',
'order_id' => '42',
'discsount_amount' => 0,
'disc_percent' => 0,
// Customer information
'client_ip' => '127.0.0.1',
'customer_name' => 'CUSTOMER NAME',
'customer_phone' => '01818555555',
'email' => '[email protected]',
'customer_address' => 'Dhaka',
'customer_city' => 'Dhaka',
'customer_state' => 'Dhaka',
'customer_postcode' => '1207',
'customer_country' => 'Bangladesh',
'value1' => 'value1',
'value2' => 'value2',
'value3' => 'value3',
'value4' => 'value4'
);

### Postmane Documentations

This document will illustrate the overall request and response flow.
URL : https://documenter.getpostman.com/view/6335853/U16dS8ig

### Who do I talk to? ###
For any technical assistance please contact to: https://shurjopay.com.bd/#contacts