Skip to content

Latest commit

 

History

History
294 lines (263 loc) · 17.4 KB

README.md

File metadata and controls

294 lines (263 loc) · 17.4 KB

WooCommerce- módulo Todo Pago (v1.6.0)

Plug in para la integración con gateway de pago Todo Pago

Consideraciones Generales

El plug in de pagos de Todo Pago, provee a las tiendas WooCommerce 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.3 en adelante y WordPress 3.7.5 con WooCommerce 2.3.5.

Instalación

  1. Descomprimir el archivo woocommerce-plugin-master.zip.
  2. Copiar carpeta woocommerce-plugin-master al directorio de plugins de wordpress ("raíz de wordpress"/wp-content/plugins).
  3. Renombrarla woocommerce-plugin-master por woocommerce-plugin.

Observaciónes:

  1. 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. Descomentar: extension=php_openssl.dll del php.ini

2. En caso de tener conflictos con Jquery por los diferentes temas, descomentar la siguiente linea que se encuentra al final del index.php ```php // add_action('init', 'my_init'); ```
[Volver a inicio](#inicio)

##Configuración

####Activación La activación se realiza como cualquier plugin de Wordpress: Desde Plugins -> Plugins instalados -> activar el plugin de nombre TodoPago para WooCommerce.

####Configuración plug in Para llegar al menu de configuración del plugin ir a: WooCommerce -> Ajustes y seleccionar Finalizar Compra de la solapa de configuraciones que aparece en la parte superior. Entre los medios de pago aparecerá la opción de nombre Todopago.
imagen de configuracion


Menú principal
imagen de configuracion

Menú ambiente
imagen de configuracion
imagen de configuracion

Meenú estados y menú servicios
imagen de configuracion

  • Estado de transacción iniciada: Se setea luego de completar los datos de facturación y presionar el botón "Realizar el pedido".
  • Estado de transacción aprobada: Se setea luego de volver del formulario de pago de Todo Pago y se obtiene una confirmación del pago.
  • Estado de transacción rechazada: Se setea luego de volver del formulario de pago de Todo Pago y se obtiene un rechazo del pago.

Redirección final de transacción (a partir de v 1.4.2) imagen de configuracion

Volver a inicio

####Formulario Hibrido En la configuracion del plugin tambien estara la posibilidad de mostrarle al cliente el formulario de pago de TodoPago integrada en el sitio. Para esto , en la configuracion se debe seleccionar la opcion Integrado en el campo de seleccion de fromulario imagen de configuracion

Del lado del cliente el formulario se vera asi:
imagen de configuracion
El formulario tiene dos formas de pago, ingresando los datos de una tarjeta ó utilizando la billetera de Todopago. Al ir a "Pagar con Billetera" desplegara una ventana que permitira ingresar a billetera y realizar el pago.
imagen de configuracion


[Volver a inicio](#inicio)

####Obtener datos de configuracion Se puede obtener los datos de configuracion del plugin con solo loguearte con tus credenciales de Todopago.
a. Ir a la opcion Obtener credenciales
imagen de configuracion
b. Loguearse con el mail y password de Todopago.
c. Los datos se cargaran automaticamente en los campos Merchant ID y Security code en el ambiente correspondiente y solo hay que hacer click en el boton guardar datos y listo.
imagen de configuracion
Volver a inicio

####Configuración de Maximo de Cuotas Se puede configurar la cantidad máxima de cuotas que ofrecerá el formulario de TodoPago con el campo cantidad máxima de cuotas. Para que se tenga en cuenta este valor se debe habilitar el campo Habilitar máximo de cuotas y tomará el valor fijado para máximo de cuotas. En caso que esté habilitado el campo y no haya un valor puesto para las cuotas se tomará el valor 12 por defecto. imagen de configuracion

Volver a inicio


## Prevención de Fraude - [Consideraciones Generales](#cons_generales) - [Consideraciones para vertical RETAIL](#cons_retail)

####Consideraciones Generales (para todas las verticales, por defecto RETAIL) El plugin, toma valores estándar del framework para validar los datos del comprador. Principalmente se utiliza una instancia de la clase WC_Order.

   $order = new WC_Order($order_id);
-- Ciudad de Facturación: $order -> billing_city;
-- País de facturación: $order -> billing_country;
-- Identificador de Usuario: $order -> customer_user;
-- Email del usuario al que se le emite la factura: $order -> billing_email;
-- Nombre de usuario el que se le emite la factura: $order -> billing_first_name;
-- Apellido del usuario al que se le emite la factura: $order -> billing_last_name;
-- Teléfono del usuario al que se le emite la factura: $order -> billing_phone;
-- Provincia de la dirección de facturación: $this -> getStateCode($order -> billing_state);
-- Domicilio de facturación: $order -> billing_address_1;
-- Complemento del domicilio. (piso, departamento): $order -> billing_address_2;
-- Moneda: 'ARS'; //Moneda Fija
-- Total:  $order -> order_total;
-- IP de la pc del comprador: $order -> customer_ip_address;

####Consideraciones para vertical RETAIL Las consideración para el caso de empresas del rubro RETAIL son similares a las consideraciones generales ya que se obtienen del mismo objeto de clase WC_Orden

-- Ciudad de envío de la orden: $order -> shipping_city;
-- País de envío de la orden: $order -> shipping_country;
-- Mail del destinatario: $order -> shipping_email;
-- Nombre del destinatario: $order -> shipping_first_name;
-- Apellido del destinatario: $order -> shipping_last_name;
-- Número de teléfono del destinatario: $order -> shipping_phone;
-- Código postal del domicio de envío: $order -> shipping_postcode;
-- Provincia de envío: getStateCode($order -> shipping_state);
-- Domicilio de envío: $order -> billing_address_1;

####Nuevos Atributos en los productos Para efectivizar la prevención de fraude se han creado nuevos atributos de producto dentro de la categoria "Prevención de Fraude".
imagen de configuracion


Estos campos no son obligatorios aunque si requeridos para Control de Fraude

Volver a inicio

Características


#### Consulta de Transacciones Se puede consultar on line las características de la transacción en el sistema de Todo Pago al hacer click en el número de orden en la parte de Status de las Operaciones.
![imagen de configuracion](https://raw.githubusercontent.com/TodoPago/imagenes/master/woocommerce/6-%20status%20de%20las%20operaciones.png)
![imagen de configuracion](https://raw.githubusercontent.com/TodoPago/imagenes/master/woocommerce/7-%20detalle%20status.png)

[Volver a inicio](#inicio)

Devoluciones

Es posible realizar devoluciones o reembolsos mediante el procedimiento habitual de WooCommerce. Para ello dirigirse en el menú a WooCommerce->Pedidos, "Ver" la orden deseada (Esta debe haber sido realizada con TodoPago) y encontrará una sección con el título Pedido Productos, dentro de esta hay un botón Reembolso al hacer click ahí nos solicitará el monto a reembolsar y nos dará la opción de Reembolsar con TodoPago.
Devolución

Volver a inicio

Tablas de Referencia

######Provincias ######Tabla de errores

Provincias

ProvinciaCódigo
CABAC
Buenos AiresB
CatamarcaK
ChacoH
ChubutU
CórdobaX
CorrientesW
Entre RíosE
FormosaP
JujuyY
La PampaL
La RiojaF
MendozaM
MisionesN
NeuquénQ
Río NegroR
SaltaA
San JuanJ
San LuisD
Santa CruzZ
Santa FeS
Santiago del EsteroG
Tierra del FuegoV
TucumánT
[Volver a inicio](#inicio)

Tabla de errores

Id mensajeMensaje
1081Tu saldo es insuficiente para realizar la transacción.
1100El monto ingresado es menor al mínimo permitido
1101El monto ingresado supera el máximo permitido.
1102La tarjeta ingresada no corresponde al Banco indicado. Revisalo.
1104El precio ingresado supera al máximo permitido.
1105El precio ingresado es menor al mínimo permitido.
2010En este momento la operación no pudo ser realizada. Por favor intentá más tarde. Volver a Resumen.
2031En este momento la validación no pudo ser realizada, por favor intentá más tarde.
2050Lo sentimos, el botón de pago ya no está disponible. Comunicate con tu vendedor.
2051La operación no pudo ser procesada. Por favor, comunicate con tu vendedor.
2052La operación no pudo ser procesada. Por favor, comunicate con tu vendedor.
2053La operación no pudo ser procesada. Por favor, intentá más tarde. Si el problema persiste comunicate con tu vendedor
2054Lo sentimos, el producto que querés comprar se encuentra agotado por el momento. Por favor contactate con tu vendedor.
2056La operación no pudo ser procesada. Por favor intentá más tarde.
2057La operación no pudo ser procesada. Por favor intentá más tarde.
2059La operación no pudo ser procesada. Por favor intentá más tarde.
90000La cuenta destino de los fondos es inválida. Verificá la información ingresada en Mi Perfil.
90001La cuenta ingresada no pertenece al CUIT/ CUIL registrado.
90002No pudimos validar tu CUIT/CUIL. Comunicate con nosotros acá para más información.
99900El pago fue realizado exitosamente
99901No hemos encontrado tarjetas vinculadas a tu Billetera. Podés adherir medios de pago desde www.todopago.com.ar
99902No se encontro el medio de pago seleccionado
99903Lo sentimos, hubo un error al procesar la operación. Por favor reintentá más tarde.
99970Lo sentimos, no pudimos procesar la operación. Por favor reintentá más tarde.
99971Lo sentimos, no pudimos procesar la operación. Por favor reintentá más tarde.
99977Lo sentimos, no pudimos procesar la operación. Por favor reintentá más tarde.
99978Lo sentimos, no pudimos procesar la operación. Por favor reintentá más tarde.
99979Lo sentimos, el pago no pudo ser procesado.
99980Ya realizaste un pago en este sitio por el mismo importe. Si querés realizarlo nuevamente esperá 5 minutos.
99982En este momento la operación no puede ser realizada. Por favor intentá más tarde.
99983Lo sentimos, el medio de pago no permite la cantidad de cuotas ingresadas. Por favor intentá más tarde.
99984Lo sentimos, el medio de pago seleccionado no opera en cuotas.
99985Lo sentimos, el pago no pudo ser procesado.
99986Lo sentimos, en este momento la operación no puede ser realizada. Por favor intentá más tarde.
99987Lo sentimos, en este momento la operación no puede ser realizada. Por favor intentá más tarde.
99988Lo sentimos, momentaneamente el medio de pago no se encuentra disponible. Por favor intentá más tarde.
99989La tarjeta ingresada no está habilitada. Comunicate con la entidad emisora de la tarjeta para verificar el incoveniente.
99990La tarjeta ingresada está vencida. Por favor seleccioná otra tarjeta o actualizá los datos.
99991Los datos informados son incorrectos. Por favor ingresalos nuevamente.
99992La fecha de vencimiento es incorrecta. Por favor seleccioná otro medio de pago o actualizá los datos.
99993La tarjeta ingresada no está vigente. Por favor seleccioná otra tarjeta o actualizá los datos.
99994El saldo de tu tarjeta no te permite realizar esta operacion.
99995La tarjeta ingresada es invalida. Seleccioná otra tarjeta para realizar el pago.
99996La operación fué rechazada por el medio de pago porque el monto ingresado es inválido.
99997Lo sentimos, en este momento la operación no puede ser realizada. Por favor intentá más tarde.
99998Lo sentimos, la operación fue rechazada. Comunicate con la entidad emisora de la tarjeta para verificar el incoveniente o seleccioná otro medio de pago.
99999Lo sentimos, la operación no pudo completarse. Comunicate con la entidad emisora de la tarjeta para verificar el incoveniente o seleccioná otro medio de pago.

Versiones Disponibles##

Version del Plugin Estado Versiones Compatibles
v1.6.0 Stable (Current version) WordPress 3.7.5
WooCommerce 2.3.5

Click on the links above for instructions on installing and configuring the module.

Volver a inicio