README

概述

此软件包提供了一个简单的组件，用于为 Banque Populaire 的 Systempay API 创建支付表单。

安装

要安装 Laravel 模板 Systempay 组件，请运行

composer require frenchykiller/laravel-systempay

使用方法

要在页面中包含 Systempay 表单，只需在 blade 文件中添加组件

<x-systempay :request="['amount' => 25]" />

属性

接受以下属性

配置

组件附带默认配置文件，使其能够直接使用，但如果你希望自定义配置，可以使用以下命令发布配置文件

php vendor:publish --tag=systempay-config

默认情况下，位于 config/systempay.php 的配置文件包含以下信息

return [
    'default' => [
        'site_id' => env('SYSTEMPAY_SITE_ID', '73239078'),
        'password' => env('SYSTEMPAY_PASSWORD', 'testpassword_SbEbeOueaMDyg8Rtei1bSaiB5lms9V0ZDjzldGXGAnIwH'),
        'key' => env('SYSTEMPAY_KEY', 'testpublickey_Zr3fXIKKx0mLY9YNBQEan42ano2QsdrLuyb2W54QWmUJQ'),
        'env' => env('SYSTEMPAY_ENV', 'TEST'),
        'url' => 'https://api.systempay.fr/api-payment/V4/',
        'params' => [
            'currency' => 'EUR',
            'formAction' => 'PAYMENT',
            'strongAuthentication' => 'NO_PREFERENCE', //Setting this to DISABLED will let the card issuer decide whether 3DS2 is required or not. This will also remove any payment guarantee for the merchant.
            'transactionOptions' => [
                'cardOptions' => [
                    'paymentSource' => 'EC', //Setting this to CC (Call Center) will disable all 3DS checks. This will also shift liability for chargebacks to the merchant.
                ],
            ],
        ],
    ],
];

要更改默认配置，只需在配置文件或 .env 文件中设置 SYSTEMPAY_SITE_ID、SYSTEMPAY_PASSWORD 和 SYSTEMPAY_KEY 变量。这些值由 Systempay 提供。

如果你想向同一应用程序添加更多站点，只需在配置文件中添加新的条目，如下所示

return [
    'default' => [
        ...
    ],

    'site_name' => [
        'site_id' => 'your_site_id',
        'password' => 'your_site_password',
        'key' => 'your_site_key',
        'url' => 'https://api.systempay.fr/api-payment/V4/',
        'params' => [
            'currency' => 'USD', //required
            'formAction' => 'PAYMENT',
            'strongAuthentication' => 'ENABLED'
            //add other static params here
        ],
    ]

测试

默认情况下，该软件包设置为在测试环境中运行。要切换到生产环境，必须在 .env 文件中设置 SYSTEMPAY_SITE_ID、SYSTEMPAY_PASSWORD 和 SYSTEMPAY_KEY 变量，或者发布并更改配置文件，如“配置”部分所示

测试 / 编码标准

此软件包附带一个 Makefile，用于启动检查编码标准和单元测试

只需调用 make 以查看命令列表。

贡献

请参阅 contributing.md 了解详细信息和工作清单。

致谢

• Christopher Walker
• 所有贡献者

许可证

此软件包是免费软件，根据 MIT 许可证 的条款分发。