🛒

Guía de Instalación

Tienda TienPYC v2.1.3 - ¡Súper Fácil!

📋

¿Qué Necesitas Antes de Empezar?

Antes de instalar tu tienda, asegúrate de tener estas cosas listas:

🌐

Un Hosting Web

Un lugar donde vivirá tu tienda en internet (como cPanel, Hostinger, etc.)

🔗

Un Dominio

La dirección de tu tienda (ejemplo: www.mitienda.com)

🗄️

Base de Datos MySQL

Donde se guardarán todos los datos de tu tienda

📁

El Archivo ZIP

El instalador que descargaste (tienda-tienpyc-instalador-v2.1.3.zip)

💡 Consejo

Si no tienes hosting, te recomendamos Hostinger o Namecheap porque son económicos y fáciles de usar.

🚀

Instalación Paso a Paso

¡Vamos a instalar tu tienda! Sigue estos pasos uno por uno:

1

Entra a tu cPanel

Abre tu navegador y ve a la dirección de tu cPanel. Normalmente es algo como:

https://tudominio.com:2083

Ingresa tu usuario y contraseña que te dio tu hosting.

🖥️

Pantalla de login de cPanel

2

Sube el Archivo ZIP

Busca el icono de "Administrador de Archivos" (File Manager) y haz clic.

  1. Ve a la carpeta public_html (o donde quieras instalar)
  2. Haz clic en "Cargar" (Upload) arriba
  3. Selecciona el archivo tienda-tienpyc-instalador-v2.1.3.zip
  4. Espera a que suba completamente (100%)
💡 ¿Dónde instalar?
  • public_html = Tu tienda estará en www.tudominio.com
  • public_html/tienda = Tu tienda estará en www.tudominio.com/tienda
3

Extrae el ZIP

Ahora vamos a descomprimir el archivo:

  1. Haz clic derecho sobre el archivo ZIP
  2. Selecciona "Extract" o "Extraer"
  3. Confirma que se extraiga en la misma carpeta
  4. ¡Listo! Verás todas las carpetas y archivos
✅ Deberías ver estas carpetas:

admin/, customer/, includes/, templates/, uploads/, assets/, cron/, database/

4

Crea la Base de Datos

Vuelve al inicio de cPanel y busca "Bases de datos MySQL":

  1. Crear base de datos: Escribe un nombre (ej: mitienda_db) y haz clic en "Crear"
  2. Crear usuario: Escribe un nombre de usuario y una contraseña segura
  3. Agregar usuario a la base de datos: Selecciona el usuario y la base de datos, marca "TODOS LOS PRIVILEGIOS" y guarda
⚠️ ¡Importante!

Anota estos datos en un papel, los necesitarás en el siguiente paso:

  • Nombre de la base de datos
  • Usuario de la base de datos
  • Contraseña de la base de datos
5

Ejecuta el Instalador

¡Ahora viene la parte divertida! Abre tu navegador y ve a:

https://tudominio.com/install.php

Verás un asistente bonito que te guiará. Solo sigue los pasos:

  1. Bienvenida: Haz clic en "Iniciar Instalación"
  2. Requisitos: Verifica que todo esté en verde ✅
  3. Base de datos: Ingresa los datos que anotaste antes
  4. Tu tienda: Escribe el nombre de tu tienda y tu email
  5. API TienPYC: Si tienes token, ingrésalo (o salta este paso)
  6. Instalar: Haz clic en "Completar Instalación"
🎉 ¡Felicidades!

Si todo salió bien, serás redirigido al panel de administración de tu tienda.

6

Elimina el Instalador

Por seguridad, debes eliminar el archivo install.php:

  1. Ve al Administrador de Archivos de cPanel
  2. Busca el archivo install.php
  3. Haz clic derecho y selecciona "Eliminar"
⚠️ ¿Por qué eliminarlo?

Si alguien encuentra ese archivo, podría reinstalar tu tienda y borrar todos tus datos. ¡Mejor prevenir!

🔗

Conectar con TienPYC.com

Para que tu tienda funcione completamente, necesitas conectarla con TienPYC.com. Esta conexión te permite:

📦

Obtener Productos

Acceso al catálogo de cuentas de streaming, gaming y más

🔄

Sincronización

Stock y precios actualizados automáticamente

🚀

Entrega Automática

Las credenciales se entregan al cliente al instante

💰

Precios Mayoristas

Accede a precios especiales para revendedores

1

Crea tu Cuenta en TienPYC.com

Primero necesitas una cuenta de revendedor:

  1. Ve a https://app.tienpyc.com
  2. Haz clic en "Registrarse"
  3. Completa tus datos (nombre, email, contraseña)
  4. Verifica tu email haciendo clic en el enlace que te envían
  5. Inicia sesión en tu nueva cuenta
💡 ¿Ya tienes cuenta?

Si ya tienes una cuenta en TienPYC.com, simplemente inicia sesión y continúa al paso 2.

2

Obtén tu Token de API

El token es como una "llave secreta" que conecta tu tienda con TienPYC:

  1. Dentro de tu cuenta de TienPYC, ve a "Configuración" o "Mi Perfil"
  2. Busca la sección "API Token" o "Token de Acceso"
  3. Haz clic en "Generar Token" si no tienes uno
  4. Copia el token (es un código largo como: eyJ0eXAiOiJKV1QiLCJhbGc...)
⚠️ ¡Guarda tu Token en un lugar seguro!

El token es como una contraseña. No lo compartas con nadie. Si crees que alguien lo tiene, genera uno nuevo.

3

Configura el Token en tu Tienda

Ahora conecta tu tienda con TienPYC:

  1. Ve al panel de administración de tu tienda: https://tudominio.com/admin
  2. Ve a "Configuración" en el menú lateral
  3. Busca la sección "API TienPYC" o "Integración TienPYC"
  4. Pega tu token en el campo correspondiente
  5. Haz clic en "Guardar"
⚙️

Admin → Configuración → API TienPYC → Pegar Token

4

Verifica la Conexión

Para asegurarte de que todo funciona:

  1. Después de guardar el token, busca un botón de "Probar Conexión" o "Verificar"
  2. Si ves un mensaje verde de "Conexión exitosa", ¡todo está listo!
  3. Si hay error, verifica que el token esté bien copiado (sin espacios extra)
✅ ¡Conexión Establecida!

Ahora tu tienda puede comunicarse con TienPYC para obtener productos y procesar ventas automáticamente.

5

Importa los Productos

Con la conexión lista, puedes traer productos de TienPYC a tu tienda:

  1. Ve a "Admin → Productos"
  2. Busca el botón "Importar de TienPYC" o "Sincronizar"
  3. Selecciona las categorías que quieres importar (Netflix, Spotify, etc.)
  4. Haz clic en "Importar"
  5. ¡Los productos aparecerán en tu tienda con precios y descripciones!
💡 Personaliza los precios

Los productos se importan con precio sugerido, pero puedes cambiar el precio de venta para ajustar tu margen de ganancia.

🎯 ¿Cómo Funciona una Venta?

Cuando un cliente compra en tu tienda, esto es lo que pasa automáticamente:

  1. Cliente paga: El cliente elige un producto y paga con su billetera o método de pago
  2. Tu tienda procesa: Se crea el pedido y se descuenta del saldo del cliente
  3. TienPYC entrega: La API de TienPYC envía las credenciales automáticamente
  4. Cliente recibe: El cliente ve sus credenciales en "Mis Compras" al instante
  5. Tú ganas: La diferencia entre tu precio de venta y el precio mayorista es tu ganancia
💰 Ejemplo de Ganancia

Si compras Netflix a $10,000 COP en TienPYC y lo vendes a $15,000 COP en tu tienda, ganas $5,000 COP por cada venta. ¡Automático!

⚙️

Configuración Inicial de tu Tienda

Ya tienes tu tienda instalada. Ahora vamos a configurarla para que se vea increíble:

1

Entra al Panel de Administración

Para administrar tu tienda, ve a:

https://tudominio.com/admin

Ingresa con el email y contraseña que pusiste durante la instalación.

2

Personaliza tu Tienda

Ve a Configuración en el menú lateral y ajusta:

Opción ¿Qué es? Ejemplo
Nombre de la tienda El nombre que verán tus clientes Mi Tienda Streaming
Logo La imagen de tu marca Sube una imagen PNG o JPG
Color principal El color de los botones y detalles #8b5cf6 (morado)
Tema Modo claro u oscuro Oscuro (se ve más moderno)
WhatsApp Tu número para soporte +57 300 123 4567
💡 Consejo de diseño

El tema oscuro con un color brillante como verde neón (#39ff14) o morado (#8b5cf6) se ve muy profesional para tiendas de streaming.

📦

Agregar Productos

¡Hora de agregar lo que vas a vender!

1

Primero: Crea Categorías

Las categorías organizan tus productos. Ve a Admin → Categorías:

  1. Haz clic en "Nueva Categoría"
  2. Escribe el nombre (ej: "Netflix", "Spotify", "Gaming")
  3. Elige un icono y color
  4. Guarda
📺

Streaming

Netflix, Disney+, HBO

🎵

Música

Spotify, Apple Music

🎮

Gaming

Xbox, PlayStation, Steam

2

Ahora: Agrega Productos

Ve a Admin → Productos → Nuevo Producto:

Campo ¿Qué poner?
Nombre Netflix Premium 1 Mes
Categoría Streaming
Precio 15000 (en tu moneda base)
Descripción Cuenta Netflix Premium por 30 días, 4K Ultra HD
Imagen Sube una imagen atractiva del producto
Tipo Cuenta compartida / Cuenta completa / Código
💡 Tip para vender más

Usa imágenes de alta calidad y descripciones claras. Los clientes compran más cuando entienden exactamente qué están comprando.

💳

Configurar Métodos de Pago

Para que tus clientes puedan pagarte, configura los métodos de pago:

1

Ve a Admin → Pagos

Aquí verás todos los métodos de pago disponibles. Los más comunes son:

💰

Billetera

Los clientes cargan saldo y pagan con él. ¡Ya viene activado!

🏦

Transferencia

Pago directo a tu cuenta bancaria con comprobante

📱

Nequi / Daviplata

Pagos móviles populares en Colombia

🪙

Criptomonedas

USDT, Bitcoin (requiere configuración adicional)

2

Configura Transferencia Bancaria

Haz clic en "Transferencia" y completa:

  • Nombre del banco: Bancolombia, Davivienda, etc.
  • Tipo de cuenta: Ahorros o Corriente
  • Número de cuenta: Tu número de cuenta
  • Titular: Tu nombre completo
  • Instrucciones: "Envía el comprobante por WhatsApp"
💡 Consejo

Puedes agregar una imagen con el código QR de tu banco para que los clientes paguen más fácil.

💰

Configurar Monedas

Tu tienda puede mostrar precios en diferentes monedas. ¡Muy útil si tienes clientes de varios países!

1

Ve a Admin → Monedas

Verás tu moneda principal (la que configuraste al instalar). Para agregar más:

  1. Haz clic en "Agregar Moneda Popular"
  2. Selecciona las monedas que necesites (USD, MXN, PEN, etc.)
  3. ¡Listo! Las tasas se actualizan automáticamente
2

Monedas Disponibles

El sistema incluye más de 22 monedas de habla hispana:

País Moneda Símbolo
🇨🇴 ColombiaCOP$
🇲🇽 MéxicoMXN$
🇦🇷 ArgentinaARS$
🇵🇪 PerúPENS/
🇨🇱 ChileCLP$
🇩🇴 Rep. DominicanaDOPRD$
🇺🇸 Estados UnidosUSD$
🇪🇸 EspañaEUR
✅ Tasas Automáticas

Las tasas de cambio se actualizan automáticamente cada hora usando APIs de internet. ¡No tienes que hacer nada!

👥

Gestionar Clientes

Tus clientes se registran solos en tu tienda. Aquí te explico cómo gestionarlos:

1

Ver Clientes

Ve a Admin → Clientes para ver todos los registrados:

  • Nombre y email
  • Fecha de registro
  • Saldo en billetera
  • Cantidad de pedidos
2

Aprobar Depósitos

Cuando un cliente carga saldo a su billetera, debes aprobarlo:

  1. Ve a Admin → Depósitos
  2. Verás los depósitos pendientes con el comprobante
  3. Verifica que el pago sea correcto
  4. Haz clic en "Aprobar"
  5. ¡El saldo se acredita automáticamente!
💡 Conversión Automática

Si un cliente deposita en una moneda diferente (ej: DOP) y tu tienda usa COP, el sistema convierte automáticamente al aprobar. ¡Magia!

🛍️

Gestionar Pedidos

Cuando un cliente compra algo, recibes un pedido. Así los gestionas:

1

Ver Pedidos

Ve a Admin → Pedidos. Verás una lista con:

  • Número de pedido: #12345
  • Cliente: Nombre y email
  • Productos: Qué compró
  • Total: Cuánto pagó
  • Estado: Pendiente, Procesando, Completado
2

Procesar un Pedido

Haz clic en un pedido para ver los detalles y procesarlo:

  1. Revisa qué producto compró el cliente
  2. Entrega el producto (credenciales, código, etc.)
  3. Cambia el estado a "Completado"
  4. El cliente recibirá una notificación
🎉 ¡Venta completada!

El dinero ya está en tu cuenta y el cliente tiene su producto. ¡Así de fácil!

Preguntas Frecuentes

🔴 ¿Olvidé mi contraseña de admin?

Puedes resetearla desde la base de datos o contactar soporte técnico.

🔴 ¿Cómo cambio el logo?

Ve a Admin → Configuración y sube una nueva imagen en la sección "Logo".

🔴 ¿Las tasas de cambio no se actualizan?

Ve a Admin → Monedas y haz clic en "Actualizar Tasas". Si el problema persiste, verifica que tu servidor tenga acceso a internet.

🔴 ¿Cómo configuro los Cron Jobs?

En cPanel, ve a "Cron Jobs" y agrega estas tareas:

0 * * * * php /home/usuario/public_html/cron/update_exchange_rates.php */5 * * * * php /home/usuario/public_html/cron/retry_sales.php 0 0 * * * php /home/usuario/public_html/cron/expire_subscriptions.php

Cambia /home/usuario/public_html/ por la ruta real de tu instalación.

🔴 ¿Cómo hago una copia de seguridad?

En cPanel:

  1. Ve a "Backup" o "Copia de seguridad"
  2. Descarga la copia de la base de datos
  3. Descarga la carpeta de archivos
  4. Guárdalos en un lugar seguro

🔴 ¿Cómo configuro el archivo .htaccess?

El archivo .htaccess ya viene incluido en el instalador. Pero si tienes problemas o necesitas reemplazarlo, usa este código:

# TienPYC E-Commerce Platform # Compatible con Apache 2.2 y 2.4 <IfModule mod_rewrite.c> Options -MultiViews -Indexes RewriteEngine On RewriteBase / # Bloquear acceso a archivos sensibles RewriteRule ^config\.php$ - [F,L] RewriteRule ^\.env$ - [F,L] RewriteRule ^composer\.(json|lock)$ - [F,L] RewriteRule ^package\.json$ - [F,L] # Proteger carpetas sensibles RewriteRule ^includes/ - [F,L] RewriteRule ^logs/ - [F,L] RewriteRule ^database/ - [F,L] # Permitir acceso directo a webhooks RewriteRule ^webhook/wompi/?$ webhook/wompi.php [L] RewriteRule ^webhook/coinpal/?$ webhook/coinpal.php [L] # Permitir acceso a archivos de instalación RewriteRule ^(install|check_requirements)\.php$ - [L] # Permitir archivos estáticos RewriteCond %{REQUEST_FILENAME} -f RewriteRule \.(css|js|jpg|jpeg|png|gif|webp|svg|ico|woff|woff2|ttf|eot)$ - [L] # Route all requests through index.php RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php?route=$1 [QSA,L] </IfModule> # Set default charset AddDefaultCharset UTF-8 # php -- BEGIN cPanel-generated handler, do not edit # Set the "ea-php83" package as the default "PHP" programming language. <IfModule mime_module> AddHandler application/x-httpd-ea-php83 .php .php8 .phtml </IfModule> # php -- END cPanel-generated handler, do not edit
💡 ¿Cómo crear/editar el .htaccess?
  1. Ve al Administrador de Archivos de cPanel
  2. Haz clic en "Configuración" (arriba a la derecha)
  3. Marca "Mostrar archivos ocultos" y guarda
  4. Busca el archivo .htaccess en tu carpeta de instalación
  5. Haz clic derecho → "Editar"
  6. Pega el código de arriba y guarda
⚠️ Importante sobre RewriteBase

Si tu tienda está en una subcarpeta (ej: tudominio.com/tienda), cambia RewriteBase / por RewriteBase /tienda/

Lista de Verificación Final

Antes de abrir tu tienda al público, verifica que hayas completado todo:

🎉 ¡Tu tienda está lista!

Ahora puedes compartir el link con tus clientes y empezar a vender. ¡Mucho éxito!

🏠 Ir a Mi Tienda ⚙️ Panel de Admin