Guía de Instalación - Sphere IT Consulting
  • 🇺🇸 +(254) 306-2888       🇵🇪 +(511) 692-1392

Guía de Instalación

Guía de Instalación
1. INTRODUCCIÓN

Esta guía proporciona instrucciones detalladas para la instalación y configuración de la aplicación Culqi Payment Gateway para tiendas BigCommerce. Esta integración permite a los comercios peruanos aceptar pagos con tarjetas de crédito y débito a través de la pasarela de pagos Culqi.

1.1 Acerca de Culqi

Culqi es una pasarela de pagos líder en Perú que permite a los negocios procesar transacciones de forma segura y eficiente. Ofrece múltiples opciones de pago, incluyendo tarjetas de crédito, tarjetas de débito y otros métodos de pago alternativos.

1.2 Beneficios de la Integración
  • Procesamiento seguro de pagos con tecnología PCI DSS Nivel 1
  • Integración sencilla con el Marketplace de BigCommerce
  • Soporte para múltiples métodos de pago peruanos
  • Interfaz de pago responsive y optimizada
  • Panel de administración completo en el Dashboard de Culqi
2. REQUISITOS PREVIOS

Antes de iniciar el proceso de instalación, asegúrese de cumplir con los siguientes requisitos:

2.1 Cuenta de BigCommerce
  • Tienda BigCommerce activa con plan Standard, Plus, Pro o Enterprise
  • Acceso de administrador a la tienda BigCommerce
2.2 Cuenta de Culqi
  • Cuenta Culqi activa (https://culqipanel.culqi.com/)
  • Verificación del negocio completada en Culqi
  • PUBLICKEY (Clave Pública) de Culqi
  • SECRETKEY (Clave Secreta) de Culqi
2.3 Información Requerida
  • RUC de la empresa
  • Datos de la cuenta bancaria para la liquidación de fondos
  • Dirección de correo electrónico activa para notificaciones
3. PROCESO DE INSTALACIÓN

Siga estos pasos para instalar la aplicación Culqi Payment Gateway en su tienda BigCommerce:

Paso 1: Acceder al Marketplace de BigCommerce
  • Inicie sesión en el panel de administración de su tienda BigCommerce
  • Desde el menú lateral izquierdo, navegue a Apps > Marketplace
  • En la barra de búsqueda, escriba “Culqi” y presione Enter
Paso 2: Instalar la Aplicación
  • Haga clic en la aplicación “Culqi Payment Gateway”
  • Revise la información de la aplicación, sus características y requisitos
  • Haga clic en el botón “Instalar” o “Obtener esta app”
  • Cuando se le solicite, haga clic en “Confirmar” para autorizar los permisos requeridos
Paso 3: Otorgar Permisos

La aplicación solicitará los siguientes permisos:

  • Leer y modificar métodos de pago
  • Leer información de pedidos
  • Crear y actualizar transacciones
  • Acceder a la información de la tienda

Importante: Todos los permisos solicitados deben ser concedidos para que la aplicación funcione correctamente.

4. CONFIGURACIÓN DE CREDENCIALES

Una vez instalada la aplicación, debe configurar sus credenciales de Culqi:

4.1 Obtener Credenciales de Culqi
  • Inicie sesión en su cuenta de Culqi en https://culqipanel.culqi.com/
  • Desde el menú lateral, diríjase a Development > API Keys
  • Encontrará dos tipos de claves:
    • Claves de Prueba (Test Keys): Utilizadas para pruebas sin procesar pagos reales
    • Claves de Producción (Live Keys): Utilizadas para procesar pagos reales
  • Copie las siguientes credenciales:
CredencialDescripción
PUBLICKEYClave pública – utilizada en el frontend de la tienda
SECRETKEYClave secreta – utilizada en el backend para procesar pagos

Advertencia de Seguridad: Nunca comparta su SECRETKEY públicamente. Manténgala segura y confidencial en todo momento.

4.2 Ingresar Credenciales en BigCommerce
  • En el panel de administración de BigCommerce, vaya a Apps > My Apps
  • Ubique “Culqi Payment Gateway”
  • Complete los siguientes campos:
    • Public Key: Pegue su PUBLICKEY de Culqi
    • Secret Key: Pegue su SECRETKEY de Culqi
  • Haga clic en “Guardar” para almacenar la configuración
SOPORTE Y CONTACTO

Si necesita asistencia adicional durante o después de la instalación, nuestro equipo de soporte está disponible para ayudarle:

Sphere IT Consulting – Soporte

Para consultas relacionadas con la integración, configuración o problemas técnicos: