README

英文说明

本模块为您的客户提供Atos SIPS支付系统，该系统在法国银行广泛使用，名称各异：Mercanet、E-Transactions、Citelis等。

安装

手动

使用后台管理界面中的模块页面上传存档以安装Atos模块。

您还可以将存档解压到<thelia root>/local/modules目录中。请确保模块目录名为Atos（例如，不是Atos-master）。

从后台管理界面的模块页面激活模块。

composer

$ composer require thelia/atos-module:~1.0

用法

在使用Atos模块之前，您必须对其进行配置。为此，请转到Thelia后台的“模块”选项卡，并激活Atos模块。

然后点击“配置”按钮，并输入所需信息。在大多数情况下，您将通过电子邮件收到您的商户ID，并收到下载证书的说明。

在保存配置时，模块会执行多个检查，特别是Atos二进制的执行权限。

在测试阶段，您可以定义允许在前端使用Atos模块的IP地址，以便在此测试阶段，您的客户无法使用Atos进行支付。

Atos后支付回调日志在配置页面中显示。

支付模板

您可以自定义支付页面templates/atos/payment.html，以提供更好的模板集成，但支付表单数据不能修改，因为它是由Atos二进制生成和签名的。

法语说明

Ce module permet à vos clients de payer leurs commande par carte bancaire via la plate-forme Atos SIPS, utilisée par de nombreuses banques françaises sous diverses dénominations commerciales: Mercanet, Citelis, E-Transactions, et bien d'autres.

安装

Manuellement

Installez ce module directement depuis la page Modules de votre back-office, en envoyant le fichier zip du module.

Vous pouvez aussi décompresser le module, et le placer manuellement dans le dossier <thelia_root>/local/modules. Assurez-vous que le nom du dossier est bien Atos, et pas Atos-master

composer

$ composer require thelia/atos-module:~1.0

Utilisation

Pour utiliser le module Atos, vous devez tout d'abord le configurer. Pour ce faire, rendez-vous dans votre back-office, onglet Modules, et activez le module Atos.

Cliquez ensuite sur "Configurer" sur la ligne du module, et renseignez les informations requises. Dans la plupart des cas, l'ID Marchand vous a été communiqué par votre banque par e-mail, et vous devez recevoir les instructions qui vous permettront de télécharger le certificat.

Le module réalise plusieurs vérifications de votre configuration, et vous signalera les problèmes éventuellement rencontrés. Il contrôle notamment que les exécutables Atos possèdent bien les permissions d'exécution.

Lors de la phase de test, vous pouvez définir les adresses IP qui seront autorisées à utiliser le module en front-office, afin de ne pas laisser vos clients payer leur commandes avec Atos pendant cette phase.

Template de paiement

Vous pouvez adapter la page de paiement qui se trouve dans templates/atos/payment.html, et l'adapter à votre template, mais la form de paiement en elle-même ne peut pas être modifiée, elle est générée et signée par le binaire Atos, et ne doit pas être modifiée.