Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bahiazul/redsys-virtual-pos
Redsys Virtual POS is an unofficial standalone PHP library to handle payments through the spanish payment service Redsys.
https://github.com/bahiazul/redsys-virtual-pos
composer handle-payments library package php pos redsys redsys-virtual-pos standalone standalone-php-library tpv unofficial
Last synced: 21 days ago
JSON representation
Redsys Virtual POS is an unofficial standalone PHP library to handle payments through the spanish payment service Redsys.
- Host: GitHub
- URL: https://github.com/bahiazul/redsys-virtual-pos
- Owner: bahiazul
- License: mit
- Created: 2014-10-20T09:44:34.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2021-04-05T12:46:12.000Z (over 3 years ago)
- Last Synced: 2024-11-16T08:47:05.589Z (about 1 month ago)
- Topics: composer, handle-payments, library, package, php, pos, redsys, redsys-virtual-pos, standalone, standalone-php-library, tpv, unofficial
- Language: PHP
- Size: 9.58 MB
- Stars: 4
- Watchers: 3
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Redsys Virtual POS
[](https://travis-ci.com/bahiazul/redsys-virtual-pos)
[](https://packagist.org/packages/bahiazul/redsys-virtual-pos)
[](https://packagist.org/packages/bahiazul/redsys-virtual-pos)
[](https://packagist.org/packages/bahiazul/redsys-virtual-pos)
[](https://packagist.org/packages/bahiazul/redsys-virtual-pos)
**Redsys Virtual POS** is an _unofficial_ standalone PHP library to handle payments through the spanish payment service Redsys.
> **NOTE:** This library its still under development and its functionality is subject to change.
## Prerequisites
- PHP >=5.4.0 <8.0
## Installation
Installation is recommended through [Composer](https://getcomposer.org/).
```
$ composer require bahiazul/redsys-virtual-pos
```
## Sample
Go to the `sample` folder an run the following command in a terminal to start PHP's built-in web server:
```
# install dependencies
$ composer install
# start the server
$ php -S 0.0.0.0:8000
```
Then open your browser and go to [here](http://localhost:8000/).
If you want to test the online (async) response, replace `localhost` with your public IP or hostname, making sure that your machine is accesible through the port 8000 (you can use another port if you want).
## Usage
Basic usage:
```php
use Bahiazul\RedsysVirtualPos\Message\WebRequest;
use Bahiazul\RedsysVirtualPos\Field\Currency;
use Bahiazul\RedsysVirtualPos\Field\TransactionType;
$secret = 'Mk9m98IfEblmPfrpsawt7BmxObt98Jev';
$merchantCode = '999008881';
$terminal = '871';
// The Environment object holds connection details
$env = new Bahiazul\RedsysVirtualPos\Environment\DevelopmentEnvironment();
$env->setSecret($secret);
// Setup the Parameters for the Request
$params['Amount'] = '145'; // €1,45
$params['Order'] = strval(time());
$params['MerchantCode'] = $merchantCode;
$params['Currency'] = Currency::EUR;
$params['TransactionType'] = TransactionType::STANDARD;
$params['Terminal'] = $terminal;
$params['MerchantName'] = 'Test Store'; // optional
$params['ProductDescription'] = 'Product Description'; // optional
$params['UrlOk'] = 'http://localhost:8000/success.php'; // optional
$params['UrlKo'] = 'http://localhost:8000/failure.php'; // optional
// Generate the Request
$webRequest = new WebRequest($env);
$webRequest->setParams($params);
// Generate the form
$submitBtn = "
";
$wrForm = $webRequest->getForm([], $submitBtn);
// Render the HTML form w/ Submit button
echo $wrForm;
```
See `sample/index.php` and `sample/response.php` for more detailed examples.
## Test
Run the following command in a terminal:
```
# install dependencies
$ composer install
# run the tests
$ phpunit
```
## Changelog
See [CHANGELOG.md](CHANGELOG.md)
## Authors
- [Javier Zapata](https://javi.io) ([Twitter](https://twitter.com/jzfgo))
## License
MIT