Plug in para la integración con gateway de pago Todo Pago
- Consideraciones Generales
- Instalación
- Configuración
- Configuración plug in
- Datos adiccionales para prevención de fraude
- Consulta de transacciones
- Tablas de referencia
El plug in de pagos de Todo Pago, provee a las tiendas OpenCart de un nuevo método de pago, integrando la tienda al gateway de pago. La versión de este plug in esta testeada en PHP 5.4-5.3 y Opencart 2.0.0.0 a 2.0.1.1 (No es comapatible con versiones aneriores).
Por requerimientos del medio de pago el plugin configurará l código postal como obligatorio para Argentina. Los clientes que NO tengan código postal configurado NO podrán pagar.
- Descomprimir el archivo opencart-plugin-master.zip.
- Copiar carpeta 'catalog' y 'admin' al root de opencart con los mismos nombres.
- Luego ir a 'extensions->payments' y ir a la opción Todo Pago e instalar.
Observación:
Descomentar: extension=php_soap.dll del php.ini, ya que para la conexión al gateway se utiliza la clase SoapClient del API de PHP.
Volver a inicio
- Descomprimir el archivo opencart-plugin-master.zip.
- Copiar carpeta 'catalog' y 'admin' al root de opencart con los mismos nombres.
- Luego ir a 'extensions->payments' y ir a la opción Todo Pago y editar
- AL hacerlo aparecerá un mensaje informando la necesidad de upgradear el plugin y un botón "upgrade" en lugar del de "guardar".
Observación:
Descomentar: extension=php_soap.dll del php.ini, ya que para la conexión al gateway se utiliza la clase SoapClient del API de PHP.
Volver a inicio
configuración plug in. ####Configuración plug in Para llegar al menu de configuración ir a: System->Configuration y seleccionar Paymenth Method en el menú izquierdo. Una vez instalado el plug in, ir a 'extensions->payments' y ir a la opción Todo Pago, hacer click en el lápiz, para comenzar a configurar. La configuracion del Plug in esta dividido en 5 solapas (GENERAL, AMBIENTE TEST, AMBIENTE PRODUCCION, ESTADO DEL PEDIDO) y una solapa adiccional (Status de la Operación) que se utiliza para ver el estado de la orden (transacción) de manera on line.
Menú principal
El plug in para lograr las nuevas funcionalidades y su persistencia dentro del framework creará nuevas tablas, columnas y atributos:
#####Nuevas Columnas:
- en tabla order: todopagoclave.
####Consideraciones Generales (para todas las verticales, por defecto RETAIL) El plug in, toma valores estándar del framework para validar los datos del comprador. Principalmente se utiliza una instancia de la clase checkout/order. Para acceder a los datos del comprador se utiliza el metodo $this->model_checkout_order->getOrder($order_id) que devuelve un array:
$this->load->model('checkout/order');
$order = $this->model_checkout_order->getOrder($order_id);
-- Ciudad de Facturación: $order['payment_city'];
-- País de facturación: $order['payment_iso_code_2'];
-- Identificador de Usuario: $order['customer_id'];
-- Email del usuario al que se le emite la factura: $order['email'];
-- Nombre de usuario el que se le emite la factura: $order['payment_firstname'];
-- Apellido del usuario al que se le emite la factura: $order['payment_lastname'];
-- Teléfono del usuario al que se le emite la factura: $order['telephone'];
-- Provincia de la dirección de facturación: $order['payment_zone_code'];
-- Domicilio de facturación: $order['payment_address_1'];;
-- Complemento del domicilio. (piso, departamento): $order['payment_address_2'];
-- Moneda: $order['currency_code'];
-- Total: $order['total'];
-- IP de la pc del comprador: $order['ip'];
Otros de los modelos utlilizados es Customer del cual a través del método getPasswordHash(), se extrae el password del usuario (comprador) y la tabla sales_flat_invoice_grid, donde se consultan las transacciones facturadas al comprador. ####Consideraciones para vertical RETAIL Las consideración para el caso de empresas del rubro RETAIL son similares a las consideraciones generales con la diferencia de se utiliza el método getShippingAddress() que devuelve un objeto y del cual se utilizan los siguientes métodos;
-- 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();
nota: el valor resultante de $order->getItemsCollection(), se usan como referencias para conseguir información del modelo catalog/producto - a través de los métodos getDescription(), getName(), getSku(), getQtyOrdered(), getPrice()-.
####Muy Importante
Provincias: uno de los datos requeridos para prevención común a todos los verticales es el campo provinicia/state tanto del comprador como del lugar de envío, para tal fin el plug in utiliza el valor del campo región de las tablas de la orden.
Volver a inicio
El plug in crea un nuevo tab para poder consultar on line las características de la transacción en el sistema de Todo Pago.
Volver a inicio
######Provincias
Provincias
Provincia | Código |
---|---|
CABA | C |
Buenos Aires | B |
Catamarca | K |
Chaco | H |
Chubut | U |
Córdoba | X |
Corrientes | W |
Entre Ríos | R |
Formosa | P |
Jujuy | Y |
La Pampa | L |
La Rioja | F |
Mendoza | M |
Misiones | N |
Neuquén | Q |
Río Negro | R |
Salta | A |
San Juan | J |
San Luis | D |
Santa Cruz | Z |
Santa Fe | S |
Santiago del Estero | G |
Tierra del Fuego | V |
Tucumán | T |