gordalina/ifmb-bundle

Ifthensoftware IFmb integration into Symfony2

IfmbBundle

The IfmbBundle provides integration of ifthensoftware's Multibanco Payments library into the Symfony2 framework., _(*1)

Installation

Require gordalina/ifmb-bundle to your composer.json file:, _(*2)

{
    "require": {
        "gordalina/ifmb-bundle": "~1"
    }
}

Register the bundle in app/AppKernel.php:, _(*3)

// app/AppKernel.php
public function registerBundles()
{
    return array(
        // ...
        new Gordalina\Bundle\IfmbBundle\GordalinaIfmbBundle(),
    );
}

Enable the bundle's configuration in app/config/config.yml:, _(*4)

``` yaml, <sub>(*5)</sub>

app/config/config.yml

gordalina_ifmb: anti_phishing_key: 0000-0000-0000-0000 backoffice_key: 15i6cnl28vj4ock84co0gssggo480cso8oo4wok8oso8c0w4s8 sandbox: false # it defaults to %kernel.debug%, <sub>(*6)</sub>

Configure the bundle's routing in `app/config/routing.yml`:

``` yaml
# app/config/routing.yml
gordalina_ifmb:
    resource: "@GordalinaIfmbBundle/Resources/config/routing.yml"
    prefix:   /<your prefix>

The callback URL that you need to provide to ifthensoftware will be your http://domain.com/<your prefix>/ifmb/payment-notification, <sub>(*7)</sub>

Usage

This bundle registers a gordalina_ifmb.refmb service which is an instance of RefMb. You'll be able to generate Multibanco References from this service., <sub>(*8)</sub>

It also registers a gordalina_ifmb.client service which is an instance of Client you can use this service to fetch payments from the gateway., <sub>(*9)</sub>

Testing

Setup the test suite using Composer:, <sub>(*10)</sub>

$ composer install --dev

Run it using PHPUnit:, <sub>(*11)</sub>

$ vendor/bin/phpunit