跳转到主要内容

添加对法国使用的Caisse-AP支付协议的支持

项目描述

Beta License: AGPL-3 OCA/l10n-france Translate me on Weblate Try me on Runboat

此模块为Odoo销售点添加了通过IP支持的Caisse AP协议。

Caisse AP协议是一种供应商无关的协议,在法国用于销售点和支付终端之间的通信。它由Ingenico支付终端、Verifone支付终端和其他品牌的支付终端实现。此协议由一个名为Association du paiement的法国协会设计,缩写为AP。请注意,Caisse-AP协议由在法国部署的Ingenico支付终端使用,但不由在其他国家部署的相同型号的Ingenico支付终端使用!

此模块支持与支付终端的双向链接

  1. 它将金额发送到支付终端

  2. 它等待支付事务结束

  3. 它解析支付终端的响应,该响应提供支付状态:在成功的情况下,支付行将自动验证;在失败的情况下,将显示错误消息,Odoo用户可以重试或删除支付行。

Caisse-AP协议最初是为串行和USB编写的。自从Caisse AP协议版本3.x以来,它也支持IP。当通过IP使用时,客户端(销售点)和服务器(支付终端)通过原始TCP套接字交换简单的ASCII编码文本数据。

Caisse-AP协议有一个重要的缺点:因为它使用原始TCP套接字,所以无法从纯JS代码中使用。因此,销售点的JS代码无法自己生成查询并发送到支付终端。在这个模块中,销售点的JS代码向Odoo服务器发送一个查询,该服务器打开到支付终端的原始TCP套接字。这意味着,如果Odoo服务器不在LAN上而是在互联网上的某个地方,并且支付终端在LAN上有一个私有IP地址,您需要在防火墙上设置一个TCP端口转发规则,以将Odoo服务器的TCP连接重定向到支付终端。

目录

配置

在菜单 销售点 > 配置 > 支付方式 中,在对应于卡支付的支付方式上

  • 选择适当的会计科目,它应该是一个银行会计科目(而不是现金会计科目,否则“使用支付终端”字段将不可见)

  • 字段 使用支付终端:选择 Caisse AP over IP (仅限法国)

  • 字段 Caisse-AP支付终端IP地址:设置支付终端的IP地址

  • 字段 Caisse-AP支付终端端口:设置支付终端的TCP端口(默认为8888)

  • 字段 支付方式:设置 (如果使用连接到支付终端的支票打印机(例如Ingenico i2200)进行支票支付,则值 支票 是用于 支票 支付方式的)

问题追踪器

问题在 GitHub Issues 上跟踪。在遇到问题的情况下,请先检查是否已经报告了您的问题。如果您是第一个发现它的人,请通过提供详细和受欢迎的 反馈 来帮助我们解决问题。

请不要直接联系贡献者以获取支持或技术问题的帮助。

鸣谢

作者

  • Akretion

贡献者

其他鸣谢

本模块的开发得到了 Camptocamp 的财务支持。

维护者

本模块由OCA维护。

Odoo Community Association

OCA,即Odoo社区协会,是一个非营利组织,其使命是支持Odoo功能的协作开发并促进其广泛使用。

当前 维护者

alexis-via

本模块是GitHub上 OCA/l10n-france 项目的组成部分。

欢迎您贡献力量。有关如何贡献的信息,请访问 https://odoo-community.org/page/Contribute

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源代码发行版

此版本没有提供源代码发行版文件。请参阅 生成发行版存档的教程

构建发行版

由以下支持