Dispositivos

Un dispositivo representa un punto de cobro (físico o virtual) dentro de su comercio. Cada dispositivo tiene sus propias credenciales y configuración.

Creación automática

Al crear un comercio, B4bit Pay genera automáticamente un dispositivo con el mismo nombre. Esto permite empezar a cobrar inmediatamente sin configuración adicional.

Múltiples dispositivos

Puede crear todos los dispositivos que necesite según su operación: un dispositivo por caja, por sucursal, por vendedor, por sitio web. No hay límite técnico.

Credenciales del dispositivo

Cada dispositivo expone dos claves que encontrará en el dashboard (Configuración → Comercio → Dispositivos):

• API Key (X-Device-Id) — UUID4 que identifica al dispositivo ante la API REST. Úsela en la cabecera X-Device-Id de todas las peticiones.
• Secret Key — clave hexadecimal usada exclusivamente para verificar la firma HMAC-SHA256 de los webhooks. Nunca la exponga en el frontend ni en logs.

Peligro

La API Key y la Secret Key son secretos. No las compile en el código cliente, no las commitee a git y no las comparta por canales no seguros. Rótelas si sospecha que han sido expuestas.

Configuración por dispositivo

Cada dispositivo tiene su propia configuración:

• Fiat por defecto (fiat_default): moneda en la que se cobra si la orden no especifica otra (MXN por defecto).
• URL de notificación (notification_url): endpoint de su servidor donde B4bit Pay enviará los webhooks. Debe ser HTTPS y responder HTTP 200 rápido.
• Alias URL del QR único: personalice la URL pública de cobro del dispositivo (ver QR único).

Asociación con usuarios

Puede asociar operadores y administradores de solo lectura a dispositivos concretos. Un operador asociado a la “caja 3” solo podrá solicitar pagos contra ese dispositivo, no contra otros.

Siguientes pasos

• Autenticación en la API — cómo usar la X-Device-Id.
• Webhook — cómo recibir notificaciones de pago firmadas con la Secret Key.
• Perfiles de usuario — roles y asociación a dispositivos.