Si ya está explorando OxaPay, chances are you’re looking for a reliable way to accept crypto payments on your website, without complexity, delays, or extra risk. This guide is built from real implementation experience and shows you exactly how to get started, whether you’re setting up a payment link, installing a plugin, or integrating the full API.
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.
These credentials are the foundation of a secure connection between your website and OxaPay, and the first step toward being able to accept crypto payments on your website with full control.
🔒 Consejo para desarrolladores:
For better security, rotate your API keys periodically and store them in environment variables, not in your codebase.
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 for e-commerce and billing platforms like WooCommerce, WHMCS, and Blesta. OxaPay also supports additional platforms, 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.
Both methods are built to help you accept crypto payments on your website reliably, whether you’re using a plugin or building a fully custom backend. For a deeper look into how the API works and what you can build with it, see our full guide on the 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.
Fine-tuning these options ensures your customers enjoy a consistent experience as they accept crypto payments on your website, aligned with your branding and operational needs.
⚙️ 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.
- You’re now ready to accept crypto payments on your website, securely, in real time, and with full visibility through the OxaPay dashboard.
🌟 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.
With OxaPay, you can accept crypto payments on your website without writing complex blockchain code or depending on third-party custodians. The process is fast, secure, and built to scale, from simple plugins to full API control.
🎯 ¿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.
