Sandbox

Cómo testar sin mover dinero real

1. Use importes mínimos

Cree órdenes con el mínimo permitido por cada moneda (lo encuentra en el campo min_amount de GET /currencies). En general, 1 MXN o equivalente.

2. Deje expirar las órdenes de prueba

Si crea una orden y no paga, automáticamente expirará en 15-60 minutos (pasa a EX) o en 24 h (CA). No genera coste.

3. Use el endpoint `POST /orders/` sin `input_currency`

Esto crea la orden pero no fuerza a un flujo de pago concreto; el cliente elegiría en la pasarela. Si usted es el “cliente” de la prueba, simplemente cierre la pestaña y deje que expire.

4. Use un dispositivo dedicado a pruebas

Cree un dispositivo nuevo llamado pruebas-integracion (o similar). Úselo solo para integraciones. Si pasa algo, puede desactivarlo sin afectar su operativa real.

Verificación del webhook sin esperar

Para verificar que su implementación HMAC es correcta sin depender de tráfico real, use los test vectors oficiales. Son datos determinísticos; su código debe producir la misma firma que espera el test.

Creación de un dispositivo de prueba por API

curl -X POST \
  -H "X-Device-Id: $B4BIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "pruebas-integracion"}' \
  https://pos.b4bit.com/api/v1/device/

La respuesta incluye un nuevo identifier (API Key del dispositivo recién creado). Úselo en sus tests locales y desactívelo desde el dashboard cuando termine.

Alternativas mientras llega un sandbox

Mocks locales con msw o nock en Node, responses en Python, http_mock en PHP. Mockee los endpoints según los schemas OpenAPI.
Reproducir webhooks manualmente: construya un POST con nonce actual, firme con su Secret, envíelo a su endpoint local (con ngrok / cloudflared si necesita URL pública).

Roadmap

La disponibilidad de un entorno sandbox público está en el roadmap de B4bit Pay. Suscríbase al changelog para recibir el aviso cuando se habilite.