API Referencia
undefined

Descarga nuestro plugin.

Descargar Plugin

Compatibilidad

  • OpenCart >= 3.x
  • PHP >= 5.6 and <= 7.0

Recuerda

  1. Contar con tu Api Key y Shared Secret
  2. Contar con OpenCart instalado en tu sitio
  3. Contar con un sitio 'https' seguro

Onepay OpenCart

Onepay

Descripción

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

Requisitos

  1. Debes tener instalado previamente alguna versión de OpenCart 3

Instalación del Plugin

  1. Dirígete a https://github.com/TransbankDevelopers/transbank-plugin-opencart-onepay/releases y descarga la última versión disponible del plugin.

    Una vez descargado el plugin, ingresa a la página de administración de OpenCart (usualmente en http://misitio.com/admin, http://localhost/admin) y dirígete a Extensions / Installer, indicado a continuación:

    Paso 1

  2. Haz click sobre el botón "Upload" y selecciona el archivo que descargaste en el paso anterior. Al finalizar aparecerá que fue instalado exitosamente.

    Paso 2

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 OpenCart (usualmente en http://misitio.com/admin, http://localhost/admin) e ingresa usuario y clave.

  2. Dentro del sitio de administración dirígete a (Extensions / Extensions) y filtra por "Payments".

    Paso 3

  3. Busca hacia abajo el plugin "Transbank Onepay".

    Paso 4

  4. Presiona el botón verde "+" para instalar el plugin.

    Paso 5

  5. Cambiará a color rojo.

    Paso 6

  6. Presiona el botón para editar el plugin

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

    • Estado: Al activarlo, Onepay estará disponible como medio de pago. Ten la precaución de que se encuentre seleccionada 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#JF@$AYZ

  • Guardar los cambios presionando el botón save

    paso7

  • 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 8

Refrescar el sistema de modificaciones de OpenCart

  1. Dirígete a (Extensions / Modifications) y selecciona el plugin "Transbank Onepay" indicado a continuación:

    Paso 9

  2. Con el plugin "Transbank Onepay" seleccionado presiona el botón "Refresh" save de la parte superior derecha.

OpenCart indicará que las modificaciones han sido exitosas sobre el plugin:

Paso 10

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

    demo 1

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

    demo 2

  • Agrega al carro de compras un producto:

    demo 3

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

    demo 4

  • Ingresa los datos que te pida como dirección, método de envío y luego selecciona método de pago Transbank Onepay, luego presiona el botón [Continue]

    demo 5

  • Luego presiona el botón [Confirm Order]

    demo 6

  • 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 (En este ejemplo 8660 - 7579):

    demo 7

  • En otra ventana del navegador, ingresa al emulador de pagos desde https://onepay.ionix.cl/mobile-payment-emulator/, utiliza test@onepay.cl 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":

    demo 8

  • 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 exitoso presionando el botón PRE_AUTHORIZED.

    demo 9

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

    demo 10

    demo 11

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

    demo 12

    demo 13