README

与支付网关 Todo Pago 集成的插件

• 一般注意事项
• 安装
• 配置
  • 插件配置
  • 混合表单
  • 获取配置数据
  • 最大分期付款配置
  • 新列和表
• 欺诈预防
  • 一般注意事项
  • 垂直零售注意事项
• 功能
  • 事务查询
  • 退货
• 参考表
  • 错误表
• 可用版本

一般注意事项

Todo Pago 支付插件为Magento商店提供了一种新的支付方式，将商店集成到支付网关。此插件的版本已在PHP 5.4以上和MAGENTO 2上进行了测试。

安装

使用Composer

composer require todopago/magento2-plugin

手动安装

A. 解压文件 magento2-plugin-master.zip。

B. 将所有内容复制到 app/code/Prisma/TodoPago 文件夹中。

然后，

1. 从控制台执行以下命令以配置Magento

php bin/magento module:enable Prisma_TodoPago
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy es_AR #idioma instalado de la tienda.

1. 从“系统 -> 缓存管理”刷新Magento缓存
2. 然后转到“商店 -> 配置 -> 销售 -> 支付方式”，并从 Todo Pago 选项卡进行配置。

注意：取消注释php.ini中的 extension=php_curl.dll，extension=php_soap.dll 和 extension=php_openssl.dll，因为连接到网关时使用了PHP API中的 SoapClient 类。

_返回首页

配置

插件配置

要进入配置菜单，请转到： 商店 -> 配置 并在左侧菜单中选择支付方式。在支付方式列表中会出现一个名为 Todo Pago 的选项卡。插件分为配置常规和两个更多子菜单。

_主菜单

_环境菜单

_状态菜单

_返回首页

混合表单

在插件配置中，还将提供向客户展示TodoPago集成站点的支付表单的可能性。为此，在配置中必须在“使用混合表单”字段中选择“是”：
_{在客户端，表单将显示如下：}

_返回首页

获取配置数据

您只需使用Todopago凭证登录即可获取插件配置数据。
a. 前往“使用登录自动完成”选项 >
b. 在弹出窗口中使用Todopago的电子邮件和密码登录。

c. 数据将自动加载到相应的环境（开发或生产）的“商户ID”和“安全码”字段中，然后只需点击“保存数据”按钮即可。
_返回首页

最大分期数配置

您可以通过“最大分期数”字段配置TodoPago表单提供的最大分期数。要考虑此值，必须启用“激活最大分期数”字段，并采用设定的最大分期数。如果已启用该字段且未指定分期数，则默认采用12期。

_返回首页

新列和新表

插件为了实现新功能并在框架内持久化，将创建新表和新列

新列

1. 在sales_order表中：todopagocostofinanciero。

新表

1. todoPago_transacciones表

_返回首页

欺诈预防

• 一般注意事项
• 面向零售行业的考虑因素

一般性考虑因素（针对所有行业，默认为零售行业）

插件通过框架的标准化值来验证买家的数据。主要使用Mage_Sales_Model_Order类的一个实例。要访问买家的数据，使用getBillingAddress()方法，它返回一个已实例化的对象，并使用以下方法：

   $objectManager = \Magento\Framework\App\ObjectManager::getInstance();
   $order = $objectManager->create('Magento\Sales\Model\Order')->load($id);	
-- Ciudad de Facturación: $order->getBillingAddress()->getCity();
-- País de facturación: $order->getBillingAddress()->getCountryId();
-- Código postal de facturación: $order->getBillingAddress()->getPostcode();
-- Teléfono del usuario al que se le emite la factura: $order->getBillingAddress()->getTelephone();
-- Provincia de la dirección de facturación: $order->getBillingAddress()->getRegion();
-- Domicilio de facturación: $order->getBillingAddress()->getStreet();
-- Email del usuario al que se le emite la factura: $order->getBillingAddress()->getEmail();
-- Nombre de usuario el que se le emite la factura: $order->getBillingAddress()->getFirstname();
-- Apellido del usuario al que se le emite la factura: $order->getBillingAddress()->getLastname();
-- Teléfono del usuario al que se le emite la factura: $order->getBillingAddress()->getTelephone();
-- Moneda: $order->getBaseCurrencyCode();
-- Total:  $order->getGrandTotal();
-- IP de la pc del comprador: $order->getRemoteIp();

其他使用的模型是Customer，通过getPasswordHash()方法从中提取用户（买家）的密码，以及sales_flat_invoice_grid表，其中查询卖家的交易。

面向零售行业的考虑因素

针对零售行业企业的考虑与一般考虑类似，不同之处在于使用getShippingAddress()方法，该方法返回一个对象，并使用以下方法：

   $objectManager = \Magento\Framework\App\ObjectManager::getInstance();
   $order = $objectManager->create('Magento\Sales\Model\Order')->load($id);	
-- Ciudad de envío de la orden: $order->getShippingAddress()->getCity();
-- País de envío de la orden: $order->getShippingAddress()->getCountry();
-- Mail del destinatario: $order->getShippingAddress()->getEmail();
-- Nombre del destinatario: $order->getShippingAddress()->getFirstname();
-- Apellido del destinatario: $order->getShippingAddress()->getLastname();
-- Número de teléfono del destinatario: $order->getShippingAddress()->getTelephone();
-- Código postal del domicio de envío: $order->getShippingAddress()->getPostcode();
-- Provincia de envío: $order->getShippingAddress()->getRegion();
-- Domicilio de envío: $order->getShippingAddress()->getStreet1();
-- Método de despacho: $order->getShippingDescription();
-- Código de cupón promocional: $order->getCuponCode();
-- Para todo lo referido productos: $order->getItemsCollection();
-- Método de despacho: $order->getShippingDescription();
-- Para todo lo referido productos: $order->getItemsCollection();

注意： $order->getItemsCollection()的结果值用作参考，以获取商品模型（catalog/product）的信息——通过getDescription()、getName()、getSku()、getQtyOrdered()、getPrice()等方法。

非常重要

省份：预防措施中普遍需要的其中一个数据是买家和发货地所在的省份字段，为此插件通过getRegion()方法使用订单表（sales_flat_order_address）中的区域字段值，无论是billingAddress还是shippingAddress。

特性

• 事务查询
• 退货

交易查询

插件创建了一个新的标签页，以便可以在Todo Pago系统中在线查询交易的特性。

_返回首页

退货

可以通过Magento的常规程序进行退货或退款。要这样做，请访问一个订单，然后通过菜单选择“发票”以生成关于账单的信用memo（借项通知）。在那里，您需要点击“退款”按钮，以便退货在线处理并由Todo Pago处理。

_返回首页

参考表

省份

省份

操作错误表

_返回首页

集成错误表

_返回首页

可用的版本

点击上面的链接获取模块安装和配置说明。

_返回首页