在收银台中管理与第三方提供商的信用卡付款

M3 Business Engine中存在一种解决方案，以支持使用第三方提供商在收银台中进行信用卡付款。该解决方案使得外部系统能够从现金付款。打开 (OIS215) 中执行信用卡交易。

注意

如果所选第三方提供商的 JavaScript 不是为客户开发的，则 CenPOS 将用作第三方提供商。

如需 CenPOS 的详细信息，请参阅在收银台中管理使用 CenPos 的信用卡付款。

准备工作

要通过外部第三方提供商从收银台管理信用卡付款，请满足以下先决条件：

  • 保护每种实现的操作环境和到其特定信用卡管理软件的界面。
  • 定义配置信用卡管理界面中列出的设置。
  • 将所使用的收银台定义为实际收银台（收银台类型 = 1），并且在收银台。打开 (OIS210) 中激活外部管理的信用卡付款字段。
  • 验证 (OIS215) 中使用的付款方式在 AR 付款方式。打开 (CRS076) 中定义为信用卡付款方式。
  • (OIS215) 的 B 和 D 屏幕针对外部第三方提供商使用 H5 中的脚本进行个性化设置。
  • 定义电子邮件地址。打开 (CRS111) 中的客户电子邮件地址（类型 01）。
  • 将用户。打开 (MNS150) 中的公司和分部设置为 (OIS215) 中连接收银台的公司和分部。

限制

  • 如果执行部分付款，则在使用 OIS215MI LstLineCrCrd 时，不会将部分已付发票的税务信息发送给第三方提供商。
  • 未翻译从第三方提供商提供的结果消息。
  • 该功能只能在 H5 客户端中激活。
  • OIS215MI LstCrCrd：如果要处理贷方金额，则不会列出发票信息。

指定现金付款和信用卡

在 (OIS215) 中指定信用卡的付款方法时，如果已对所使用的收银台激活外部管理的信用卡付款字段，则 M3 会根据连接第三方 ID。打开 (CRS439) 以及信用卡接口设置。打开 (CRS434) 中的设置检查是否存在第三方 ID。

如果第三方提供商存在，则这些字段将显示在 (OIS215) 中并且可在 JavaScript 中用于第三方提供商的接口：

  • 付款号
  • 第三方提供商和第三方 ID
  • 信用卡编号
  • 结果
  • 电子邮件（指定付款方的客户电子邮件地址（类型 01）是默认值，但可以进行更改。）
  • 发送单据
  • 卡选项 - 此字段在 AR 付款方式。打开 (CRS076) 中设置，并且在值不等于零时显示该字段。

指定要支付的发票和支付的现金，并单击 Enter 启动第三方提供商系统。在第三方提供商系统中，指定信用卡明细，然后单击“提交”。自动显示现金付款。打开 (OIS215) ，并更新金额。从第三方提供商检索的信用卡编号显示在“信用卡编号”字段中。完成所有付款后，在收银台中按照正常流程验证付款。

用从第三方提供商检索的结果代码和消息显示交易的结果。如果检索到错误代码，则不执行任何付款更新。

第三方提供商、第三方 ID、交易类型、卡片类型、卡号后四位数字和卡上的名称都更新到收银台表 (OPAYMH) 上，并可通过创建一个可配置的视图在现金付款。显示 (OIS219) 中显示。

还可以为以下字段添加值并将它们保存在收银台表 OPAYMH 中：

  • 信用卡付款方法
  • PAN 序号
  • 应用程序标识符
  • 授权代码
  • 终端 ID
  • 验证方法
  • 信用卡交易时间
  • 附加信息。

可以在收银台 XML 收据打印输出 OIS213PF 上配置这些字段。

只要未在 (OIS215) 中验证付款，就可以删除现有的付款（无效交易）。在 (OIS215/D) 中确认删除信用卡付款时，将启动第三方提供商系统并且会发生无效交易。

注意

如果已经使用第三方提供商进行信用卡付款，则在未验证付款的情况下，无法退出现金付款。打开 (OIS215)。在退出 (OIS215) 之前，必须执行作废。

OIS215MI 中的 API 交易 AddVoid 可用于保存 (OIS215) 中第三方提供商的作废交易。作废记录无法删除，其金额未包含在总计中。在 (OIS215) 中验证付款后，作废交易的记录将以交易类型 (CDTT) “12 - 作废”保存到收银台付款表 OPAYMH 中，并且可以在 (OIS219) 中查看。在收银台。验证 (OIS217) 中验证收银台时，作废记录将直接转到状态 PTST “80-分类账和总账已更新”，但不执行记账。已将来自第三方提供商的关于作废交易的响应信息添加到 XML 流以用于打印输出配置目的。

已使用第三方提供商执行付款时，无法删除已付款的发票，因为有关发票的信息将传输至第三方提供商。

如果因为没有从信用卡软件中打印而必须从 M3 BE 打印拒收的付款或签名收据，则可以使用收银台 API OIS215MI 中的 API 交易 PrtCCReceipt。

API 交易将触发称为 OIPRTR 的打印输出，其中 API 交易中的输入数据在 XML 打印输出元数据中可用于配置目的。付款方的姓名和地址以及收银台名称等信息将根据输入数据进行检索，并在 XML 元数据中提供。

可以通过 API 交易覆盖打印机设置。输入参数“打印机”可用于覆盖输出媒体选择。打开 (MNS205) 和收银台。打开 (OIS210) 中的打印机设置，方法是指定将使用的打印机。可用作输入的可用打印机在印表机。打开 (CRS290) 中定义。

信用卡详细信息可以在收银台收据打印输出 OIS213PF 上以 XML 配置。

技术解决方案

已在 (OIS215) 中执行个性化设置，而且指定了接收的现金并按下 Enter 键时，将运行 JavaScript 以创建第三方提供商的 URL。

JavaScript 可以从 (OIS215) 视图（付款编号、付款方、第三方提供商、第三方 ID、电子邮件、发送单据和已收现金）中获取一些信息，并且可以从各种 API 程序中检索其他信息。

使用的 API 程序

  • CRS610MI 获取地址
  • OIS215MI LstCrCrd（检索已支付的发票的信息）
    注意

    如果要处理贷方金额，则不列出发票信息。

  • OIS215MI ValidateCCdata 在启用第三方提供商之前检查不正确输入。如果显示警告或终止消息，则 API 程序将报告 NOK，并且您将返回到 (OIS215)。
  • CRS434MI Get3rdPartyId

当从第三方提供商检索响应 URL 时，用使用 OIS215MI AddPayment 从第三方提供程序检索的信息更新M3 Business Engine。

使用 OIS215MI Add3rdpResult 更新结果代码和消息。

此表显示 JavaScript 中支持的所有交易类型

交易类型

描述

贷方

在付款金额为负值的情况下使用。

销售

在付款金额为正值的情况下使用。

Void

在 (OIS215/D) 屏幕中单击按钮的情况下使用。
相关主题