Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/troopers/mangopaybundle
Mangopay api implementation for Symfony
https://github.com/troopers/mangopaybundle
mangopay mangopay-api symfony symfony-bundle troopers
Last synced: 2 months ago
JSON representation
Mangopay api implementation for Symfony
- Host: GitHub
- URL: https://github.com/troopers/mangopaybundle
- Owner: Troopers
- License: mit
- Created: 2014-03-25T13:53:28.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2019-11-14T10:35:30.000Z (about 5 years ago)
- Last Synced: 2024-03-26T18:27:10.045Z (9 months ago)
- Topics: mangopay, mangopay-api, symfony, symfony-bundle, troopers
- Language: PHP
- Homepage: http://troopers.agency
- Size: 690 KB
- Stars: 27
- Watchers: 13
- Forks: 19
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](http://troopers.agency/?utm_source=mangopaybundle&utm_medium=github&utm_campaign=OpenSource)
[](https://gitter.im/troopers-MangopayBundle/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](https://packagist.org/packages/troopers/mangopay-bundle)
[](https://packagist.org/packages/troopers/mangopay-bundle)
[](https://packagist.org/packages/troopers/mangopay-bundle)
[](https://insight.sensiolabs.com/projects/4896b24c-74ee-4506-8c4c-842a9c660b66)
[](https://twitter.com/troopersagency)
=============
MangopayBundle
=============
## Description
This bundle provides integration of the official [SDK PHP for Mangopay api V2](https://github.com/Mangopay/mangopay2-php-sdk) into Symfony.
- This branch does support the [v2.01 API version](https://docs.mangopay.com/endpoints/v2.01).
- The v1 branch does support the [v2 API version](https://docs.mangopay.com/endpoints/v2).
## Configuration
```yaml
troopers_mangopay:
client_id: your_mangopay_client_id
client_password: your_mangopay_client_password
base_url: your_mangopay_base_url
```
## How to use it ?
The official sdk provides a "MangoMapApi" class which is a shortcut to all the "tools" like "ApiPayIns", "ApiWallets", "ApiUsers"...
You can access those "tools" through the service "troopers_mangopay.mango_api".
```php
$payIn = new PayIn();
$this->get('troopers_mangopay.mango_api')->PayIns->create($payIn);
```
## Helpers
Additionnaly, there is some helpers that handle most of the mangopay actions. Feel free to fork and implement yours.
### BankInformationHelper
It can register user BankInformations as it implements BankInformationInterface
```php
$bankInformation = new BankInformation();
$this->get('troopers_mangopay.bank_information_helper')->createBankAccount($bankInformation);
```
### PaymentHelper
It can register a CardPreauthorisation and execute it
```php
$cardRegistration = new CardRegistration();
$this->get('troopers_mangopay.payment_helper')->createPreAuthorisation($cardRegistration);
$cardPreAuthorisation = new CardPreAuthorisation();
$this->get('troopers_mangopay.payment_helper')->executePreAuthorisation($cardPreAuthorisation, $user, $wallet);
```
### PaymentDirectHelper
It can create a new direct payment
```php
$transaction = new Transaction();
$this->get('troopers_mangopay.payment_direct_helper')->createDirectTransaction($transaction);
```
### UserHelper
It can create a new user in mangopay as the User object implements the UserInterface
```php
$user = new User();
$this->get('troopers_mangopay.user_helper')->createMangoUser($user);
```
### WalletHelper
It can create a user wallet
```php
$user = new User();
$this->get('troopers_mangopay.wallet_helper')->createWalletForUser($user);
```
## General workflow
This is the general workflow for the mangopay payment page:
1. Displaying the payment form to user
2. Create mangopay user and the card registration through mangopay API
3. Call the tokenisation server to validate the user credit card, use 3d secure if needed, update the CardR
egistration with tokenized Card, create the PreAuthorisation then redirect the user to success page.
