Cómo probar pagos cripto sin dinero real

Antes de pasar una tienda, un panel de facturación o un bot a cripto, quieres ver que todo el flujo funciona: se crea la factura, el cliente elige una moneda, el pago se confirma y tu sistema marca el pedido como pagado. Con SnapEX Pay puedes hacer todo eso sin enviar ni una sola moneda.

Qué es una factura de prueba

Una factura de prueba es una factura normal de SnapEX Pay con environment en test. Pasa por los mismos estados y envía los mismos webhooks que una factura real, con data.environment en "test" en cada evento. Nunca cambia tu saldo real.

No hay claves API de prueba aparte: usas la misma clave y solo cambias un campo de la petición.

Crea una factura de prueba con la API

Añade "environment": "test" a la petición que crea la factura:

curl -sS -X POST https://pay.snapex.pro/api/v1/merchant/invoices \
  -H "Authorization: Bearer <your API key>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: order-15-test" \
  -d '{
    "amount_usd": "15.00",
    "environment": "test",
    "external_id": "order-15"
  }'

La clave necesita el permiso invoices.write. La respuesta contiene el enlace de pago, exactamente igual que en una factura real.

O créala en el panel del comercio

En el panel, abre Invoices y cambia el modo a Test. Las facturas que crees ahí son de prueba, y la lista muestra solo facturas de prueba, así que nunca se mezclan con pagos reales.

Págala

Abre el enlace de pago. La página muestra una etiqueta Test. Elige cualquier moneda y red: la página muestra una dirección de prueba (no una real) y unos 10 segundos después el pago se confirma solo. No hace falta enviar nada.

Qué revisar de tu lado

• Entrega de webhooks. Tu endpoint recibe invoice.paid con data.environment = "test". Comprueba que la firma se verifica y que una entrega repetida del mismo Webhook-Id no marca el pedido como pagado dos veces.
• Estado del pedido. El pedido en tu sistema pasa a pagado solo con invoice.paid.
• Producción y prueba van por separado. Asegúrate de que tu código ignore los eventos de prueba cuando pases a producción, o de que guarde los pedidos de prueba aparte.

Modo de prueba en los módulos listos

Los módulos de WHMCS, BILLmanager, WooCommerce, CS-Cart, FOSSBilling, Paymenter y Remnawave tienen un modo de prueba que crea facturas de prueba. Mientras está activo, en WHMCS solo los administradores con sesión iniciada ven el botón de pago y en WooCommerce solo los gestores de la tienda ven el método; en BILLmanager y CS-Cart limitas el método de prueba a un cliente o grupo de usuarios de prueba. Haz un pedido, págalo en la página de SnapEX Pay, comprueba que el pedido pasa a pagado y luego desactiva el modo de prueba. Las guías de instalación en pay.snapex.pro describen este paso para cada módulo.

Después, a producción

Quita "environment": "test" (o desactiva el modo de prueba en el módulo) y las siguientes facturas serán reales. Los pagos de prueba nunca se aplican a pedidos reales.

Referencia completa de la API: documentación de la API de SnapEX Pay.