POST /device/

Método: POST
URL: https://pos.b4bit.com/api/v1/device/
Autenticación: header X-Device-Id con la API Key de un dispositivo existente del comercio.

Body

Content-Type: application/json.

{
  "name": "caja-tienda-3"
}

Campo	Tipo	Requerido	Max	Descripción
`name`	string	✓	128	Nombre humano del dispositivo. Único por comercio recomendado.

Ejemplos

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

const res = await fetch('https://pos.b4bit.com/api/v1/device/', {
method: 'POST',
headers: {
  'X-Device-Id': process.env.B4BIT_API_KEY,
  'Content-Type': 'application/json',
},
body: JSON.stringify({ name: 'caja-tienda-3' }),
});
const device = await res.json();
console.log('Nueva API Key:', device.identifier);

import os, requests

r = requests.post(
  'https://pos.b4bit.com/api/v1/device/',
  headers={
      'X-Device-Id': os.environ['B4BIT_API_KEY'],
      'Content-Type': 'application/json',
  },
  json={'name': 'caja-tienda-3'},
)
device = r.json()
print('Nueva API Key:', device['identifier'])

Respuesta `200`

{
  "name": "caja-tienda-3",
  "identifier": "abcdef12-3456-7890-abcd-ef1234567890"
}

identifier es la nueva API Key del dispositivo recién creado. Guárdela: no se puede recuperar después.

Errores

403 — Falta o inválida la X-Device-Id.
500 — Error interno.

Flujo típico

Cree el dispositivo por API.
Copie el identifier devuelto a sus variables de entorno de producción.
En el dashboard, configure la notification_url del dispositivo y su fiat por defecto.
Genere la Secret Key (para firmar webhooks) desde el dashboard.

Alternativa

La forma más común de crear dispositivos es desde el dashboard web: Configuración → Comercio → Dispositivos. Use este endpoint solo si necesita crear dispositivos programáticamente (por ejemplo, onboarding automatizado de sucursales).