Plugin para Spree

Vende productos físicos y digitales en una tu tienda en línea con Conekta y todas las herramientas de Spree para comercio electrónico.

1 Introducción

Spree es una solución que te permite crear una tienda en línea con una gran cantidad de herramientas disponibles dentro de tu app realizada con Ruby on Rails. A diferencia de otras plataformas de ecommerce, Spree es completamente open-source, por lo cual puedes modificar cualquier parte del código.

Con esta integración, podrás procesar cargos con Conekta directamente en tu tienda de Spree.

Compatibilidad Versiones de Spree

Este plugin ha sido probado para la versión 3 de Spree. Nuestro soporte no es garantizado para otras versiones de Spree.


2 Beneficios

Spree ofrece los siguientes beneficios al utilizar su plataforma:

  • Gratis: Integra Spree sin ningún costo.
  • Flexible: Modifica el código de Spree para crear una tienda a la medida.
  • Conekta-Ready: Procesa tarjetas de crédito y débito, genera órdenes de pago para OXXO, SPEI y Banorte.
  • Actualizaciones automáticas: Opera con actualizaciones automáticas de estatus a “Pagado”.
  • Notificaciones por correo: Envía notificaciones automáticas a tus clientes cuando hayan efectuado su pago.

3 Prerrequisitos

  1. Tener una cuenta en Conekta. Si aún no tienes una, puedes abrirla aquí.
  2. Tener instalado Spree en tu sitio.
  3. Tener conocimiento técnico.

4 Integración Paso a Paso

Integrar la terminal virtual de pagos Conekta a Spree es muy sencillo. Recuerda que es necesario tener nivel técnico para integrarlo. Solo sigue los siguientes pasos:

  1. Agrega la extensión de Conekta a tu Gemfile:

    gem 'spree_conekta', github: 'conekta/spree_conekta', branch: '3-0-stable'

  2. Corre las siguientes instrucciones para instalar la gema:

    bundle install
    rails g spree_conekta:install

  3. En el administrador de tu tienda, dirígete a la sección de configuración > payment methos > new

    Y selecciona el método que ocupas, según tus necesidades:

    Para tarjeta de crédito y débito:
    Spree::BillingIntegration::ConektaGateway::Card

    Para pagos en efectivo:
    Spree::BillingIntegration::ConektaGateway::Cash

    Para pagos Banorte:
    Spree::BillingIntegration::ConektaGateway::Bank

    Para pagos a Meses Sin Intereses con tarjeta de crédito:
    Spree::BillingIntegration::ConektaGateway::MonthlyPayment

    Para procesar con meses sin intereses, debes configurar las opciones que aceptarás dentro del inicializador de spree (config/spree.rb)
    Spree::Conekta.configure do |config|
    config.installment_options = [3] # Ejemplo: [3, 6] , [3, 6, 12]
    config.installment_default = 3 # Ejemplos: 6 12
    end

  4. Dependiendo del método de pago, puede pedirte uno o dos campos:

    En el campo de Auth Token debes ingresar tu key privada; para Public Auth Token hay que ingresar tu key pública.


5 Configurando Notificaciones

El plugin de Conekta para Spree te permite poder cambiar el estatus de un pedido a “Pagado” automáticamente en cuanto el pago sea realizado exitosamente. Para poder hacerlo, sigue los siguientes pasos:

  1. Ingresa a tu admin Conekta e ingresa a la sección de Webhooks y da clic en el botón “Crear Webhooks”.

  2. Ingresa la siguiente URL http://midominio.com/conekta/payments/, cambiando “midominio.com” por el dominio real de tu tienda Spree dentro del campo para crear el webhook. Valida que los campos de “Prueba” y “Producción” estén habilitados. Da clic en el botón de habilitar.

  3. ¡Listo! A partir de ahora podrás recibir notificaciones automáticas de pago.

Recuerda que si tienes alguna duda, puedes ponerte en contacto con nosotros al correo soporte@conekta.io donde podremos ayudarte con la integración.