Necoyoad SOFTWARE
Admin
Mi Carrito 0
Necoyoad SOFTWARE
Inicio
Productos
Ofertas Flash
NecoPagos 0% FEE
Marcas Oficiales
Demo VPS LIVE
Blog & Noticias
Portafolio CASO
Ver Carrito (0) Panel de Control Administrador
GUÍA TÉCNICA OFICIAL V1.0

NecoPagos Gateway

Pasarela de pagos en criptomonedas autohospedada, no-custodial y con cero comisiones por transacción. Acepta USDT en cuatro cadenas de bloques principales con liquidación directa a tus billeteras.

1. Visión General

NecoPagos está concebido para empresas y comercios que desean eliminar intermediarios bancarios y procesadores que cobran de 1.5% a 5% por transacción. Al ser una solución 100% autohospedada (self-hosted), tus clientes pagan directo a direcciones generadas por tu pasarela y los fondos se liquidan automáticamente en tu billetera fría o caliente.

  • Cero comisiones continuas: Conservas el 100% del valor de cada transacción.
  • No-custodial: Las llaves privadas y mnemonics se cifran con AES-256-GCM y nunca salen de tu propio servidor.
  • Dos interfaces en React: Frontend de checkout para clientes y panel administrativo para comerciantes (Vite + Tailwind CSS).

2. Redes Blockchain & Confirmaciones

La pasarela monitorea en tiempo real los bloques de las redes configuradas mediante WebSockets y llamadas RPC distribuidas.

Red Estándar Token Confirmaciones Requeridas Token de Gas
BNB Smart Chain (BSC) BEP-20 15 Bloques BNB
Polygon ERC-20 20 Bloques POL / MATIC
Arbitrum One ERC-20 200 (L1 Finality) ETH
TRON TRC-20 19 Bloques TRX

3. Arquitectura del Sistema

El backend corre sobre Node.js 18+ con Express 5 y TypeScript compilado, persistencia en PostgreSQL 14+, caché volátil en Redis 6+ y cola de mensajería asíncrona en RabbitMQ 3.13.

+-------------------+ +--------------------+ | Cliente Checkout | <--> | Proxy Nginx / | <--> [Backend API Node.js] | (React Vite) | | Traefik | | +-------------------+ +--------------------+ | v +-------------------+ +--------------------+ +------------------+ | Admin Dashboard | <--> | PostgreSQL 14 | | RabbitMQ Queue | | (React Vite) | | (Datos & Cifrado) | | (Eventos Web3) | +-------------------+ +--------------------+ +------------------+

4. Despliegue con Docker Compose

Para levantar la infraestructura completa en tu propio VPS Linux en menos de 2 minutos:

# 1. Clonar o descomprimir el código fuente git clone [email protected]:yosietserga/crypto-payment-gateway.git cd crypto-payment-gateway # 2. Configurar variables de entorno seguras cp .env.docker.example .env.docker # 3. Levantar los 6 servicios integrados docker compose up -d # 4. Sembrar datos iniciales de demostración docker compose exec backend npm run seed-demo

5. Integración con WordPress / WooCommerce

El paquete incluye el plugin oficial de WordPress ubicado en plugins/woocommerce-crypto-payment-gateway/.

  1. Comprime la carpeta del plugin: npm run package:plugin.
  2. Sube el archivo ZIP resultante desde Plugins → Añadir Nuevo → Subir Plugin en WordPress.
  3. Activa la pasarela en WooCommerce → Ajustes → Pagos → NecoPagos Gateway.
  4. Ingresa la URL de tu API (ej. https://tudominio.com/api) y la llave secreta para firma HMAC.

6. SDK para Node.js & TypeScript

import { NecoPagosClient } from '@necoyoad/necopagos-sdk'; const client = new NecoPagosClient({ apiUrl: 'https://necoyoad.com/api/v1', apiKey: process.env.NECOPAGOS_KEY, secret: process.env.NECOPAGOS_SECRET }); // Crear una orden de cobro en USDT const invoice = await client.createInvoice({ amount: 399.00, currency: 'USD', token: 'USDT', network: 'BSC', orderId: 'ORD-2026-001', callbackUrl: 'https://tienda.com/api/webhooks/necopagos' }); console.log('Dirección de depósito:', invoice.depositAddress); console.log('Código QR:', invoice.qrCodeUrl);

7. Verificación de Webhooks con Firma HMAC

Cada evento de pago confirmado emite un POST webhook firmado mediante HMAC-SHA256 en la cabecera X-NecoPagos-Signature para prevenir ataques man-in-the-middle y falsificaciones.

$payload = file_get_contents('php://input'); $signature = $_SERVER['HTTP_X_NECOPAGOS_SIGNATURE'] ?? ''; $expected = hash_hmac('sha256', $payload, $webhookSecret); if (hash_equals($expected, $signature)) { // Firma criptográfica válida: procesar acreditación de orden $event = json_decode($payload, true); marcarOrdenComoPagada($event['order_id'], $event['tx_hash']); http_response_code(200); } else { http_response_code(401); }

¿Listo para desplegar en tu servidor?

Adquiere la licencia con código fuente completo o prueba la instancia interactiva.