API Referencia
undefined

Descarga nuestro plugin.


Compatibilidad

  • Magento >= 2.0
  • PHP >= 5.6 and < 7.0

Recuerda

  1. Contar con tu llave privada y pública
  2. Contar con Magento2 instalado en tu sitio
  3. Contar con un sitio 'https' seguro

Onepay Magento

Onepay

Descripción

Este plugin oficial ha sido creado para que puedas integrar Onepay fácilmente en tu comercio, basado en Magento2.

Requisitos

  1. Debes tener instalado previamente Magento2 y asegurarte de tener Composer instalado.
  2. Tus credenciales de Magento Market a mano. Si no sabes cuales son tus credenciales puedes revisar esta guia: https://devdocs.magento.com/guides/v2.2/install-gde/prereq/connect-auth.html

Instalación del Plugin

Nota: En este punto composer podría pedirte si lo requiere tus creedenciales de magento2.

En tu directorio de Magento2, ejecutar el comando:

composer require transbank/onepay-magento2

Paso 7

Cuando finalice, ejecutar el comando:

magento module:enable Transbank_Onepay --clear-static-content

Paso 8

Cuando finalice, ejecutar el comando:

magento setup:upgrade && magento setup:di:compile && magento setup:static-content:deploy

Paso 9

Una vez realizado el proceso anterior, Magento2 debe haber instalado el plugin Onepay. Cuando finalice, debes activar el plugin en el administrador de Magento2.

Configuración

Este plugin posee un sitio de configuración que te permitirá ingresar credenciales que Transbank te otorgará y además podrás generar un documento de diagnóstico en caso que Transbank te lo pida.

Para acceder a la configuración, debes seguir los siguientes pasos:

  1. Dirígete a la página de administración de Magento2 (usualmente en http://misitio.com/admin, http://localhost/admin) e ingresa usuario y clave.

    Paso 10

  2. Dentro del sitio de administración dirígete a (Stores / Configuration).

    Paso 11

  3. Luego a sección (Sales / Payments Methods).

    Paso 12

  4. Elegir el país Chile

    Paso 13

  5. Bajando al listado de métodos de pagos verás Onepay

    Paso 14

  6. ¡Ya está! Estás en la pantalla de configuración del plugin, debes ingresar la siguiente información:

    • Enable: Al activarlo, Onepay estará disponible como medio de pago. Ten la precaución de que se encuentre marcada esta opción cuando quieras que los usuarios paguen con Onepay.
    • Endpoint: Ambiente hacia donde se realiza la transacción.
    • APIKey: Es lo que te identifica como comercio.
    • Shared Secret: Llave secreta que te autoriza y valida a hacer transacciones.

    Las opciones disponibles para Endpoint son: "Integración" para realizar pruebas y certificar la instalación con Transbank, y "Producción" para hacer transacciones reales una vez que Transbank ha aprobado el comercio. Dependiendo de cual Endpoint se ha seleccionado el plugin usará uno de los dos set de APIKey y Shared Secret según corresponda.

Credenciales de Prueba

Para el ambiente de Integración, puedes utilizar las siguientes credenciales para realizar pruebas:

  • APIKey: dKVhq1WGt_XapIYirTXNyUKoWTDFfxaEV63-O5jcsdw
  • Shared Secret: ?XW#WOLG##FBAGEAYSNQ5APD#[email protected]$AYZ

  • Guardar los cambios presionando el botón [Save Config]

    Paso 15

  • Además, puedes generar un documento de diagnóstico en caso que Transbank te lo pida. Para ello, haz click en "Generar PDF de Diagnóstico", y automáticamente se descargará dicho documento.

    Paso 17

Configuración de magento2 para Chile CLP

El plugin solamente funciona con moneda chilena CLP dado esto magento2 debe estar correctamente configurado para que que se pueda usar Onepay.

  1. Ir a la sección de administración (Stores / General / Country Option) y elegir Chile tal como se muestra en la siguiente imagen, luego guardar los cambios.

    Paso 1

  2. Ir a la sección de administración (Stores / Currency Setup / Country Option) y elegir Chile tal como se muestra en la siguiente imagen, luego guardar los cambios.

    Paso 2

  3. Ir a la sección de administración (Stores / Currency) y verificar en las dos secciones (Currency Rates y Currency Symbols) que CLP se encuentre activo.

    Paso 3

    Paso 4

    Paso 5

Prueba de instalación con transacción

En ambiente de integración es posible realizar una prueba de transacción utilizando un emulador de pagos online.

  • Ingresa al comercio

    Paso 1

  • Ya con la sesión iniciada, ingresa a cualquier sección para agregar productos

    Paso 4

  • Agrega al carro de compras un producto:

    Paso 5

  • Selecciona el carro de compras y luego presiona el botón [Proceed to Checkout]:

    Paso 6

  • Selecciona método de envío y presiona el botón [Next]

    Debes asegurarte que tu dirección de envio sea en Chile.

    Paso 7

  • Selecciona método de pago Transbank Onepay, luego presiona el botón [Place Order]

    Paso 8

  • Una vez presionado el botón para iniciar la compra, se mostrará la ventana de pago Onepay, tal como se ve en la imagen. Toma nota del número que aparece como "Código de compra", ya que lo necesitarás para emular el pago en el siguiente paso:

    Paso 9

  • En otra ventana del navegador, ingresa al emulador de pagos desde https://onepay.ionix.cl/mobile-payment-emulator/, utiliza [email protected] como correo electrónico, y el código de compra obtenido desde la pantalla anterior. Una vez ingresado los datos solicitados, presiona el botón "Iniciar Pago": * Paso 10

  • Si todo va bien, el emulador mostrará opciones para simular situaciones distintas. Para simular un pago exitoso, presiona el botón PRE_AUTHORIZED. En caso de querer simular un pago fallido, presiona le botón REJECTED. Simularemos un pago exitóso presionando el botón PRE_AUTHORIZED.

    Paso 11

  • Vuelve a la ventana del navegador donde se encuentra Magento2 y podrás comprobar que el pago ha sido exitoso.

    Paso 12

  • Además si accedes al sitio de administración seccion (Sales / Ordes) se podrá ver la orden creada y el detalle de los datos entregados por Onepay.

    Paso 13

    Paso 14

    Paso 15