JFIF x x C
C "
} !1AQa"q2#BR$3br
%&'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz
w !1AQaq"2B #3Rbrlaraskrill/composer.json 0000644 00000001176 15036433615 0011441 0 ustar 00 {
"name": "obydul/laraskrill",
"description": "LaraSkrill is a laravel plugin for processing payments through Skrill.",
"type": "library",
"license": "MIT",
"authors": [
{
"name": "Md Obydullah",
"email": "hi@obydul.me"
}
],
"require": {
"laravel/framework": ">=7.0"
},
"autoload": {
"psr-4": {
"Obydul\\LaraSkrill\\": "src/"
}
},
"extra": {
"laravel": {
"providers": [
"Obydul\\LaraSkrill\\LaraSkrillServiceProvider"
]
}
},
"minimum-stability": "dev"
}
laraskrill/src/SkrillRequest.php 0000644 00000000503 15036433615 0013021 0 ustar 00 vars[$name] = $value;
}
public function __get($name)
{
return $this->vars[$name];
}
public function toArray()
{
return $this->vars;
}
}
laraskrill/src/SkrillClient.php 0000644 00000004264 15036433615 0012617 0 ustar 00 request = $request;
else echo "Exception, you need to set SkrillRequest!
";
}
/**
* Generate SID
*/
public function generateSID()
{
// send request to skrill
return Http::withoutVerifying()
->withOptions(["verify" => false])
->post(self::PAY_URL, $this->request->toArray())
->body();
}
/**
* Generate payment URL
*/
public function paymentRedirectUrl($sid = null)
{
$this->sid = $sid;
if (!$this->sid) {
$this->sid = $this->generateSID();
}
return self::PAY_URL . "?sid={$this->sid}";
}
/**
* Prepare for full and partial refund
* @return bool|string
*/
public function prepareRefund()
{
// add required refund fields
$this->request->action = 'prepare';
return Http::withoutVerifying()
->withOptions(["verify" => false])
->post(self::REFUND_URL, $this->request->toArray())
->body();
}
/**
* Do full and partial refund
* @return bool|string
*/
public function doRefund()
{
// add action
$this->request->action = 'refund';
return Http::withoutVerifying()
->withOptions(["verify" => false])
->post(self::REFUND_URL, $this->request->toArray())
->body();
}
/**
* @return SkrillRequest
*/
public function getRequest()
{
return $this->request;
}
/**
* @param SkrillRequest $request
*/
public function setRequest($request)
{
$this->request = $request;
}
}
laraskrill/src/LaraSkrillServiceProvider.php 0000644 00000000416 15036433615 0015307 0 ustar 00 
## Introduction
By using this plugin you can process or refund payments from Skrill in your Laravel application. You may read this article and can see the output of this package. Article link: [Laravel Skrill Payment Gateway Integration with LaraSkrill](https://shouts.dev/articles/laravel-skrill-payment-gateway-integration-with-laraskrill)
Demo Laravel Project: [Skrill integration in Laravel with LaraSkrill](https://github.com/mdobydullah/laravel-skrill-integration-with-laraskrill)
## Installation
* Use the following command to install:
```bash
composer require obydul/laraskrill
```
* Laravel 5.5 uses package auto-discovery, so doesn't require you to manually add the ServiceProvider. If you don't use auto-discovery, add the service provider to your `$providers` array in `config/app.php` file like:
```php
Obydul\LaraSkrill\LaraSkrillServiceProvider::class
```
Installation completed.
## Configuration
* After installation, create a constructor.
```php
/**
* Construct.
*/
private $skrilRequest;
public function __construct()
{
// skrill config
$this->skrilRequest = new SkrillRequest();
$this->skrilRequest->pay_to_email = 'demoqco@sun-fish.com'; // your merchant email
$this->skrilRequest->return_url = 'RETURN URL';
$this->skrilRequest->cancel_url = 'CANCEL URL';
$this->skrilRequest->logo_url = 'https://cdn.shouts.dev/images/shoutsdev.png'; // optional
$this->skrilRequest->status_url = 'IPN URL or Email';
$this->skrilRequest->status_url2 = 'IPN URL or Email'; // optional
}
```
#### API/MQI password
To make a refund, we need the API/MQI password. In your Skrill account, go to Settings > Developer Settings > Change MQI/API password.
## Usage
Following are some ways through which you can access the LaraSkrill provider:
```php
// Import the class namespaces first, before using it directly
use Obydul\LaraSkrill\SkrillClient;
use Obydul\LaraSkrill\SkrillRequest;
// Create object instance
$request = new SkrillRequest();
$client = new SkrillClient($request);
// Methods
$sid = $client->generateSID();
$client->paymentRedirectUrl($sid);
$refund_prepare_response = $client->prepareRefund();
$do_refund = $client->doRefund();
```
#### Make a Payment
```php
// create object instance of SkrillRequest
$this->skrilRequest->amount = '10.26';
$this->skrilRequest->currency = 'USD';
$this->skrilRequest->language = 'EN';
$this->skrilRequest->prepare_only = '1';
$this->skrilRequest->merchant_fields = 'site_name, customer_email';
$this->skrilRequest->site_name = 'Your Website';
$this->skrilRequest->customer_email = 'customer@shouts.dev';
$this->skrilRequest->detail1_description = 'Product ID:';
$this->skrilRequest->detail1_text = '101';
// you can also pass your unique transaction id (optional)
$this->skrilRequest->transaction_id = 'SHOUTSTX0001';
// create object instance of SkrillClient
$client = new SkrillClient($this->skrilRequest);
$sid = $client->generateSID(); //return SESSION ID
// handle error
$jsonSID = json_decode($sid);
if ($jsonSID != null && $jsonSID->code == "BAD_REQUEST")
return $jsonSID->message;
// do the payment
$redirectUrl = $client->paymentRedirectUrl($sid); //return redirect url
return redirect()->to($redirectUrl); // redirect user to Skrill payment page
```
#### Refund
```php
// Create object instance of SkrillRequest
$prepare_refund_request = new SkrillRequest();
// config
$prepare_refund_request->email = 'merchant_email';
$prepare_refund_request->password = 'api_password';
$prepare_refund_request->refund_status_url = 'refund_status_url';
// request
$prepare_refund_request->transaction_id = 'MNPTTX0001';
$prepare_refund_request->amount = '5.56';
$prepare_refund_request->refund_note = 'Product no longer in stock';
$prepare_refund_request->merchant_fields = 'site_name, customer_email';
$prepare_refund_request->site_name = 'Your Website';
$prepare_refund_request->customer_email = 'customer@example.com';
// do prepare refund request
$client_prepare_refund = new SkrillClient($prepare_refund_request);
$refund_prepare_response = $client_prepare_refund->prepareRefund(); // sid or error code
// refund requests
$refund_request = new SkrillRequest();
$refund_request->sid = $refund_prepare_response;
// do refund
$client_refund = new SkrillClient($refund_request);
$do_refund = $client_refund->doRefund();
dd($do_refund); // response
```
## Note
#### Table 1: LaraSkrill Config Parameters
| Field | Description | Example |
| --- | --- | --- |
| merchant_email | Email address of your Skrill merchant account. | demoqco@sun-fish.com |
| api_password | Your MD5 API/MQI password. | 60cede4a5aee9a3827f212ba45f88c61
| return_url | URL to which the customer is returned if the payment is successful. | http://example.com/payment_completed.html |
| cancel_url | URL to which the customer is returned if the payment is cancelled or fails. If no cancel URL is provided the Cancel button is not displayed. | http://example.com/payment_cancelled.html |
| status_url, refund_status_url | URL to which the transaction details are posted after the payment process is complete. Alternatively, you may specify an email address where the results are sent. If the status_url is omitted, no transaction details are sent | http://example.com/process_payment.php or mailto:info@example.com
| logo_url | The URL of the logo which you would like to appear in the top right of the Skrill page. The logo must be accessible via HTTPS or it will not be shown. | https://www.example.com/logo.jpg (max length: 240) |
#### Checkout Parameters
There are many parameters of Skrill checkout. Please take a look at the page 13. [Skrill Quick Checkout Integration Guide - v7.9](https://www.skrill.com/fileadmin/content/pdf/Skrill_Quick_Checkout_Guide.pdf)
`Note:` 'pay_to_email', 'return_url', 'cancel_url', 'status_url' and 'logo_url' are already included in the config file. You can add other fields at checkout without these fields.
#### Table 2: Refund Parameters
| Field | Description | Required | Example
| --- | --- | --- | --- |
| transaction_id | Your transaction ID to be refunded. | Yes | MNPSK09789
| amount | Amount to refund in the currency used by the merchant account. This field is only used for partial refunds. | No | 5.56
| refund_note | Refund note sent to the customer. This note forms part of the email sent to the customer to inform them that they have received a refund. If no ‘amount’ value is submitted, the refund will be for the full amount of the original transaction. | No | Product no longer in stock
| merchant_fields | A comma-separated list of field names that are passed back to your server when the refund payment is confirmed (maximum 5 fields). | No | Field1,Field2
| Field1 | An additional field you can include, containing your own unique parameters. | No | Value1
| Field2 | An additional field you can include, containing your own unique parameters. | No | Value2
More parameters: You can add more fields. Please take a look at the page 24. [Skrill Automated Payments Interface (API) Guide - v3.0](https://www.skrill.com/fileadmin/content/pdf/Skrill_Automated_Payments_Interface_Guide.pdf)
`Note:` 'action', 'email', 'password', 'status_url' are already included. You can add other fields at refund without these fields.
**Skrill IPN (status_url):** If you want to get data from 'status_url' instead of receiving email, then use this code to your ipn listener: [Skrill IPN by Md. Obydullah](https://gist.github.com/mdobydullah/8b0399c5c6368c05d98239837a20fb19)
## Information
- [Skrill Quick Checkout Integration Guide](https://www.skrill.com/fileadmin/content/pdf/Skrill_Quick_Checkout_Guide.pdf) - version 8.1
- [Skrill Automated Payments Interface (API) Guide](https://www.skrill.com/fileadmin/content/pdf/Skrill_Automated_Payments_Interface_Guide.pdf) - version 3.0
- Skrill test merchant email: demoqco@sun-fish.com, demoqcoflexible@sun-fish.com, demoqcofixedhh@sun-fish.com
- MQI/API password and secret word: **mqi: skrill123, secretword: skrill**
- Skrill test card numbers: VISA: **4000001234567890** | MASTERCARD: **5438311234567890**
## License
The MIT License (MIT). Please see [License File](https://github.com/mdobydullah/laraskrill/blob/master/LICENSE) for more information.
## Others
`Note:` I've taken the main concept from [skrill-quick](https://github.com/mikicaivosevic/skrill-quick) and thank you, [Mikica Ivosevic](https://github.com/mikicaivosevic).
In case of any issues, kindly create one on the [Issues](https://github.com/mdobydullah/laraskrill/issues) section.
Thank you for installing LaraSkrill.
laraskrill/LICENSE 0000644 00000002047 15036433615 0007722 0 ustar 00 Copyright (c) 2019-present, LaraSkrill
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.