Si ya está explorando OxaPaylo más probable es que esté buscando una forma fiable de aceptar pagos criptográficos en su sitio web, sin complejidad, retrasos ni riesgos adicionales. Esta guía se basa en la experiencia real de implementación y le muestra exactamente cómo empezar, ya sea configurando un enlace de pago, instalando un plugin o integrando la API completa.
Antes de empezar: Lista de comprobación previa a la integración
Antes de sumergirte en los pasos de integración, asegúrate de tener preparado lo siguiente:
- Un sitio web funcional (WordPress, SaaS o backend personalizado).
- Acceso de administrador para instalar plugins o editar el código del backend.
- Un objetivo empresarial: ¿aceptas criptomonedas para productos, suscripciones o donaciones?
- Su cuenta OxaPay creada y verificada (no necesita KYC/KYB).
- Opcional: Acceso de desarrollador si tiene previsto utilizar la API.
Asegúrese de que su plataforma y su equipo están técnicamente preparados para admitir transacciones criptográficas directamente en su sitio web, con o sin la participación de desarrolladores.
🧭 Consejo: Si no estás seguro de qué método utilizar (plugin o API), consulta la tabla comparativa del final.
Etapa 1: Crear una cuenta OxaPay y acceder a su API
Antes de comenzar la integración, necesitará una cuenta OxaPay verificada. Esto es lo que debe hacer:
- Regístrate en oxapay- No se requiere KYC/KYB.
- Vaya a su Panel de control > Configuración de la API.
- Copia tu Clave API del comerciante y anota tu Callback Secret.
Estas credenciales son la base de una conexión segura entre su sitio web y OxaPay, y el primer paso para poder aceptar pagos criptográficos en su sitio web con total control.
🔒 Consejo para desarrolladores:
Para una mayor seguridad, rote sus claves API periódicamente y guárdelas en variables de entorno, no en su código base.
Seguridad de las API de pago: Buenas prácticas para la seguridad de las claves API
Paso 2: Elegir el método de integración adecuado
OxaPay soporta múltiples formas de integrar pagos criptográficos en su sitio. Elija en función de su tipo de sitio web y su capacidad técnica:
1. Integración de plugins (sin necesidad de código)
Ideal para plataformas de comercio electrónico y facturación como WooCommerce, WHMCS y Blesta. OxaPay también es compatible con plataformas adicionales-.explore todos los plugins e integraciones de pagos criptográficos para su negocio.
Cómo hacerlo:
- Instale el plugin desde Página de documentación de OxaPay.
- Pega tu API Key en los ajustes.
- Establezca sus monedas preferidas y el tiempo de espera del pago.
- Hecho. Estás en directo.
⏱ Tiempo de instalación: ~15 minutos
2. Integración de API (para desarrolladores)
Si está ejecutando una plataforma personalizada, utilizará API REST de OxaPay para crear facturas y gestionar las transacciones con un control total del backend.
Puntos finales básicos que utilizará:
- POST /api/crear-factura
- GET /api/factura-comprobación
- Webhook: POST callback con verificación HMAC
Flujo básico:
- Su backend genera una factura con el importe, el tipo de moneda y la URL de redireccionamiento.
- OxaPay devuelve una dirección de pago única.
- El cliente paga mediante monedero o código QR.
- OxaPay confirma la transacción y envía un webhook firmado a su URL de devolución de llamada.
La integración suele requerir entre 80 y 150 líneas de código backend.
Ambos métodos están diseñados para ayudarle a aceptar pagos criptográficos en su sitio web de forma fiable, tanto si utiliza un complemento como si crea un backend totalmente personalizado. Para obtener más información sobre el funcionamiento de la API y lo que puede hacer con ella, consulte nuestra guía completa sobre la API. API de criptopago y casos de uso.
📦 Rincón del desarrollador - Ejemplos de código Python
importar peticiones
importar hmac, hashlib
API_KEY = "tu-api-clave"
CALLBACK_SECRET = "tu-secreto"
datos_factura = {
"importe": 49.99,
"moneda": "USDT",
"callback_url": "https://your-site.com/payment-callback"
}
response = requests.post("https://api.oxapay.com/api/create-invoice", json=invoice_data, headers={"Authorization": API_KEY})
print(respuesta.json())
def verificar_firma(datos, firma):
return hmac.new(CALLBACK_SECRET.encode(), data.encode(), hashlib.sha256).hexdigest() == firma
📘 Devolución de llamada simplificada:
Asegúrese de que su punto final de devolución de llamada es de acceso público y devuelve HTTP 200 OK.
Puede registrar las entradas POST para verificar la estructura y probar la lógica de validación de la firma.
Paso 3: Personalizar el comportamiento de pago
Puede ajustar la forma en que OxaPay gestiona los pagos en su sitio:
- Auto Convert: Convierte instantáneamente las criptomonedas recibidas a USDT .
- Plazo de facturación: Defina el periodo de validez de las facturas.
- Recuperación de los impagos: Permitir a los usuarios completar los pagos si envían menos de lo requerido.
- Lengua y marca: Personalice el título, el logotipo y el idioma de la página de pago.
Se puede acceder a estos ajustes a través del panel de control o de los parámetros de la API durante la creación de la factura.
El ajuste de estas opciones garantiza que sus clientes disfruten de una experiencia coherente al aceptar pagos criptográficos en su sitio web, en consonancia con su marca y sus necesidades operativas.
⚙️ Consejo avanzado para desarrolladores:
Para aplicar la marca de forma dinámica, pase un campo custom_logo_url, language y redirect_after durante la creación de la factura a través de la API.
🔗 ¿Te interesa crear una experiencia de pago criptográfica de marca? Obtenga más información en Cómo crear una pasarela de pago personalizada.
Paso 4: Pruebe la integración antes de ponerla en marcha
Pruebe siempre su aplicación utilizando La caja de arena de OxaPay medio ambiente:
- Cree facturas de prueba con importes ficticios.
- Simule confirmaciones de pago utilizando monederos de prueba.
- Valide que las devoluciones de llamada llegan a su servidor y activan la lógica correcta (por ejemplo, marcar un pedido como pagado).
🔐 Consejo para desarrolladores:
Utilice la firma HMAC enviada en cada devolución de llamada para verificar la autenticidad utilizando su secreto de devolución de llamada. Registra los intentos de verificación fallidos para controlar posibles usos indebidos.
🛠 Solución de problemas comunes:
- ¿Factura caducada? Amplía el tiempo de espera en los ajustes o permite la regeneración rápida.
- ¿Transacción mal pagada? Active "Recuperación de impagados" para que los clientes puedan completar el resto.
- ¿No ha recibido ninguna llamada? Asegúrese de que el endpoint de su servidor es público y acepta peticiones POST correctamente.
🧪 Consejo sobre pruebas:
Puede simular pagos utilizando monederos de prueba como TronLink o MetaMask en redes de prueba. OxaPay proporciona un modo sandbox dedicado para la experimentación segura. Las pruebas adecuadas reducen las tasas de fracaso y garantizan que su sistema esté realmente listo para aceptar pagos criptográficos en su sitio web en condiciones reales.
Paso 5: Comience a aceptar criptomonedas en su sitio web
Una vez finalizadas las pruebas:
- Cambie sus facturas del modo "sandbox" al modo "live".
- Supervise las confirmaciones de pago en el panel OxaPay.
- Ya está listo para aceptar pagos criptográficos en su sitio web, de forma segura, en tiempo real y con total visibilidad a través del panel OxaPay.
🌟 Lo que experimentan sus clientes
- Una pantalla de pago limpia y adaptada a dispositivos móviles.
- Visualización en tiempo real del código QR y la dirección del monedero.
- Temporizador de cuenta atrás para la validez de la factura.
- Confirmación automática del éxito del pago.
✨ Estos elementos visuales y funcionales aumentan la confianza y reducen los abandonos.
💸 Tu primer pago en criptomonedas (Tutorial)
Este es el flujo de su primera transacción:
- Usted crea una factura a través de un plugin o API.
- El cliente ve una página de pago totalmente personalizada.
- Pagan utilizando su monedero criptográfico (escaneando el QR o pegando la dirección).
- OxaPay confirma la transacción y actualiza su sistema mediante callback.
- Verás la confirmación en tu panel de control.
La mayoría de los pagos basados en TRON o BSC se confirman en menos de 60 segundos.
🧩 Consejos para el éxito a largo plazo
- Active la retirada automática a su monedero de intercambio o almacenamiento en frío.
- Comprobar semanalmente el historial de transacciones para conciliar las facturas.
- Utilice el seguimiento de los impagos para mejorar la tasa de recuperación.
- Eduque a su equipo de asistencia sobre el estado de los pagos y la caducidad de las facturas.
- Ajuste la marca y los idiomas en función de la ubicación del usuario.
📊 Comparación de métodos de integración
| Método | Tiempo de preparación | Complejidad | Lo mejor para |
| Plugin | ~15 min | Bajo | WooCommerce, WHMCS, Blesta |
| API REST | 1-3 horas | Medio | SaaS, aplicaciones web personalizadas, backend |
Conclusión: Creado para la sencillez. Listo para escalar.
Con OxaPay, puede aceptar pagos criptográficos en su sitio web sin necesidad de escribir código blockchain complejo o depender de terceros custodios. El proceso es rápido, seguro y escalable, desde sencillos plugins hasta el control total de la API.
🎯 ¿Listo para empezar?
¿Listo para la acción? Empiece con el Pasarela de criptopago OxaPay o sumérjase en nuestro Documentación de la API para crear una solución a medida para su empresa.
