This plugin allows you to integrate Payplug payment with Sylius platform app including payment features and refunding orders.
In the channel settings, the base currency must be set to EUR because the payment gateway only works in this currency.
In local environment, the plugin will not work properly because you will not be notified of the status of payments from the payment gateway.
You need to make some adjustments in order to make our plugin worked normally due to a dependency to refund-plugin. Please follow those requirements:
To generate "Credit memos" when refunding, your server need to have the WKHTMLTOPDF binary as explain in refund-pluging documentation # Pre-requirements
| Version | |
|---|---|
| PHP | ^8.2 |
| Sylius | ^2.0 |
composer config extra.symfony.allow-contrib true
composer require payplug/sylius-payplug-plugincomposer recipes:install payplug/sylius-payplug-plugin --forceThis automatically registers the bundle, copies configuration files, and sets up assets (on Sylius 2.1+).
bin/console doctrine:migrations:migrateparameters:
locale: fr_FR
sylius_refund.supported_gateways:
- payplug
- payplug_oney
- payplug_bancontact
- payplug_apple_pay
- payplug_american_express- App\Entity\Customer\Customer
<?php
declare(strict_types=1);
namespace App\Entity\Customer;
use Doctrine\ORM\Mapping as ORM;
use PayPlug\SyliusPayPlugPlugin\Entity\CardsOwnerInterface;
use PayPlug\SyliusPayPlugPlugin\Entity\Traits\CustomerTrait;
use Sylius\Component\Core\Model\Customer as BaseCustomer;
/**
* @ORM\Entity
* @ORM\Table(name="sylius_customer")
*/
#[ORM\Entity]
#[ORM\Table(name: 'sylius_customer')]
class Customer extends BaseCustomer implements CardsOwnerInterface
{
use CustomerTrait;
}- App\Entity\Payment\PaymentMethod
<?php
declare(strict_types=1);
namespace App\Entity\Payment;
use Doctrine\ORM\Mapping as ORM;
use PayPlug\SyliusPayPlugPlugin\Entity\Traits\PaymentMethodTrait;
use Sylius\Component\Core\Model\PaymentMethod as BasePaymentMethod;
use Sylius\Component\Payment\Model\PaymentMethodTranslationInterface;
/**
* @ORM\Entity
* @ORM\Table(name="sylius_payment_method")
*/
#[ORM\Entity]
#[ORM\Table(name: 'sylius_payment_method')]
class PaymentMethod extends BasePaymentMethod
{
use PaymentMethodTrait;
protected function createTranslation(): PaymentMethodTranslationInterface
{
return new PaymentMethodTranslation();
}
}- App\Entity\Payment\Payment
<?php
declare(strict_types=1);
namespace App\Entity\Payment;
use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\ORM\Mapping as ORM;
use PayPlug\SyliusPayPlugPlugin\Entity\Traits\PaymentTrait;
use Sylius\Component\Core\Model\Payment as BasePayment;
/**
* @ORM\Entity
* @ORM\Table(name="sylius_payment")
*/
#[ORM\Entity]
#[ORM\Table(name: 'sylius_payment')]
class Payment extends BasePayment
{
use PaymentTrait;
}php bin/console translation:extract en PayPlugSyliusPayPlugPlugin --dump-messages
php bin/console translation:extract fr PayPlugSyliusPayPlugPlugin --dump-messagesbin/console cache:clear🎉 You are now ready to add Payplug Payment method.
In your back-office, go to Configuration > Payment methods, then click on Create and choose "Payplug".
If you want to follow the logs in the production environment, you need to add the configuration in config/packages/prod/monolog.yaml, logs should be in var/log/prod.log which can be searched after the phrase [Payum] or [Payplug]:
monolog:
handlers:
...
payum:
level: debug
type: stream
path: "%kernel.logs_dir%/%kernel.environment%.log"Run the below command to see what Symfony services are shared with this plugin:
$ bin/console debug:container payplug_sylius_payplug_pluginSee How to contribute.
This library is under the MIT license.
For better Oney integration, you can check the Oney enhancement documentation.
Since 1.11.0, the plugin supports the authorized payment feature. You can check the Authorized Payment documentation.