symfony-bundle fxpay

twodudes/fxpay

Payment gateway

FXPay

Payment gateway designed with forex in mind. Currently work in progres..., _(*1)

Installation

Installation with composer:, _(*2)

composer require twodudes\fxpay

How does it work?

The system consists of:, _(*3)

MerchantConfig - stores the merchant configuration for the given vendor, _(*4)

HandlerStrategy - describes the strategy of dealing with the vendor, _(*5)

Request:

PaymentRequest - stores the request parameters, you want to send to the vendor, _(*6)

RequestBuilder - builds the array of parameters, needed to be passed to the vendor, _(*7)

Response:

ResponseValidator - validates the response, based on the merchants rules, _(*8)

ResponseBuilder - builds the payment response object, containing information about the transaction, once you got the merchant notification from the vendors system, _(*9)

For the workflow check the TwoDudes\FXPay\HandlerStrategy\FormWithRedirectStrategy, _(*10)

I don't want to read, give me a sample

Check the tests, _(*11)

How to use the event manager?

There is a build in events system. You can use the built in event manager (the simpliest possible), or include your own one, if you want, _(*12)

$this->strategy = new FormWithRedirectStrategy($config);
$this->strategy->setEventManager(new EventManager());

If you want your custom event manager, just make sure, that it implements the TwoDudes\FXPay\Events\EventManagerInterface, _(*13)

What event do you have?

Creating Request:, _(*14)

AfterRequestBuildEvent - fires, once the request builder built the params to generate the form. Here you can modify the generated params, _(*15)

AfterFormBuildEvent - fires, once the html content with the hidden form was built. Here you can modify the form html., _(*16)

Processing response:, _(*17)

BeforeProcessResponseEvent - fires before any processing took place., _(*18)

AfterBuildVendorResponseEvent - fires in the very end, once the VendorResponse is ready., _(*19)

How to attach a new event

$this->strategy->getEventManager()->attach(BeforeProcessResponseEvent::getName(), function(BeforeProcessResponseEvent $event) {
    $params = $event->getParams();
    ...
    do something with the params
    ...
    $event->setParams($params);
});