POST /device/

• Method: POST
• URL: https://pos.b4bit.com/api/v1/device/
• Authentication: X-Device-Id header with an existing merchant device’s API Key.

Danger

This endpoint creates a persistent resource. Use it carefully — every call adds a device to the merchant that you will have to delete manually from the dashboard if it was a test.

Body

Content-Type: application/json.

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

Field	Type	Required	Max	Description
name	string	✓	128	Human-readable device name. Unique per merchant recommended.

Examples

cURL

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/

Node

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);

Python

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'])

200 response

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

• identifier is the new API Key of the freshly created device. Save it: it cannot be recovered later.

Errors

• 403 — Missing or invalid X-Device-Id.
• 500 — Internal error.

Typical flow

1. Create the device via API.
2. Copy the returned identifier into your production environment variables.
3. In the dashboard, configure the device’s notification_url and default fiat.
4. Generate the Secret Key (to sign webhooks) from the dashboard.

Alternative

The most common way to create devices is from the web dashboard: Settings → Merchant → Devices. Use this endpoint only if you need to create devices programmatically (for example, automated branch onboarding).