Note: This plugin is only for Peru, for that reason the documentation is in Spanish.

Este es la documentación oficial del plugin Woocommerce Payme Payment, este plugin es una pasarela de pago que acepta VISA, MASTERCARD, Diners Club y American Express. Estas funcionalidades son proveídas por Alignet.

 

Recuerda: Puedes enviar un email en inglés o español a support@letsgodev.com y la respuesta llegará en menos de 72 hours

 

Indice

  • Requerimientos
  • Instalar/Activar el Plugin
  • Proceso de Integración
  • Generar claves desde Alignet
  • Configurar el plugin
  • Filtros
  • Preguntas Frecuentes

 

Requerimientos

    • Woocommerce 2.6.x
    • Crear una cuenta en la web oficial de Payme.
    • Tener los siguientes datos desde Alignet
      • ID COMMERCE
      • ID ACQUIRER
      • ID WALLET
      • MCC ( Giro del negocio)
      • Llave VPOS (Generado desde el panel de Payme)
      • Llave Wallet (Generado desde el panel de Payme)

 

Instalar/Activar Plugin

Vamos a : Plugins > Agregar nuevo

 

install plugin

Subir Plugin

install plugin

Buscar el plugin en tu PC

install_plugin3

Luego, click en “activar” y podrás ver el plugin en la lista de activados

list_plugin

Listo!

 

Proceso de Integración

Es muy importante que tu comercio tenga, en su formulario de compra, los siguientes campos: campo nombres, campo apellidos, campos email, campo dirección, campo país y campo estado.

Paso1.

El comercio recibe de Alignet un zip con toda la documentación sobre la integración de esta pasarelas, además, ejemplos. También recibe sus códigos de accesos a test.

 

Paso2.

El comercio activa este plugin y llena todos las variables que recibió. Luego hace una cita con Alignet via Skype para hacer las pruebas correspondientes.

La cita consiste en enviar a Alignet todos los pantallazos necesarios en respuesta a cada caso que el manual PDF sugiere.

 

Paso3.

Si todo va bien con las pruebas en test, Alignet envia nuevos códigos de accesos para el ambiente de producción y se programa otra cita nueva via skype.

La cita consiste en enviar a Alignet todos los pantallazos necesarios en respuesta a cada caso que el manual PDF sugiere.

 

Generar claves desde Alignet

Antes de configurar el plugin, debemos generar las llaves desde el panel de Alignet. Para esto, ellos te deben enviar un email con la url de tu panel, tu usuario y tu clave.

payme1

 

payme2

 

Al ingresar al panel, podrás ver todas las opciones que Payme tiene para tu comercio, pero en este caso sólo vamos a visualizar la parte donde generamos nuestra clave, para ello en el panel de la izquierda vamos a dar click a “Llaves Públicas/Privadas” en la sección Administración.

 

Se abrirá esta sección a la derecha y le darás click en “Registrar Llaves“.

 

payme4

 

Luego de generarlas se desactivará la antigua clave y se activará la nueva, así que las descargamos (ambos: llaves pasarela y llaves Wallet).

Listo!

 

Configurar el Plugin

Para personalizar el plugin debes ir a la siguiente ruta:

Woocommerce > Ajustes > Finalizar Compra > Payme

 

Debemos llenar toda la información base para el correcto funcionamiento del plugin. Muchas de los campos son recibidos desde Alignet.

 

El campo imágen puede ir vacía pues el sistema le asigna uno por defecto.

payme5

 

    • ID COMMERCE, ID ACQUIRER, ID COMMERCE, ID WALLET, MCC son proporcionados por Alignet
    • Llave VPOS : Es generado desde el panel de Payme, en la sección de arriba se explica.
    • Llave WALLET : Es generado desde el panel de Payme, en la sección de arriba se explica.
    • Ambiente: Iniciamos con modo Test para las pruebas y finalmente cuando Alignet nos envíen los datos de producción marcamos la casilla modo producción.

 

 

Hay más opciones debajo titulada información avanzada, el cual si gusta puede personalizar a su medida.

 

payme6

    • Moneda: Es la moneda que dispone el comercio. Sólo una moneda por cada comercio.
    • Idioma: Es el idioma que mostrará el VPOS al cliente.
    • Mensajes: Son los mensajes que aparecerán en la página de “Gracias por su compra”.
    • Mostrar variables:  Esta opción debe estar marcado cuando aun se esta integrando la pasarela pues muestra todas las variables de retorno y así poder validar. Una vez entra en funcionamiento, es mejor desmarcarlo.
    • URL de retorno: Alignet nos pedirá esta URL

 

 

Filtros

Modificar variables de Wallet antes de ser enviadas a Payme.

Pata ello usaremos el filtro:  <?php add_filter("gowoo_vars_wallet",{function_name},10,2); ?>

 

Por ejemplo:

Antes de enviar los valores a Wallet, queremos cambiar el email a todos los clientes. Recuerden que si cambian un valor, también deben regenerar de nuevo “registerVerification” usando la función openssl_digest() .

 

Modificar variables VPOS antes de ser enviada a Payme

Para ello usaremos el filtro :  <?php add_filter("gowoo_vars_vpos",{function_name},10,2); ?>

 

Por ejemplo:

Sí no tenemos el campo apellidos pero si disponemos del campo nombre, entonces vamos a duplicarlo para que el VPOS no envíe apellido vació y nos de un error. Recuerden que si cambian un valor, también deben regenerar de nuevo “purchaseVerification” usando la función openssl_digest() .

 

Preguntas Frecuentes

  1. ¿Qué es Wallet?
    • Es como una billetera donde guardas tus tarjeta de crédito, con Wallet podrás hacer que tus compradores recurrentes no tengan que volver a tipear sus tarjetas, Wallet se las recordará.
  2. Que es VPOS?
    • Es la pasarela que se encarga de procesar la tarjeta del cliente y finalmente retorna valores al comercio.