GET /orders/info/{identifier}

• Método: GET
• URL: https://pos.b4bit.com/api/v1/orders/info/{identifier}
• Autenticación: header X-Device-Id.

Parámetros

Path

Param	Tipo	Descripción
identifier	UUID v4	El identifier devuelto por POST /orders/.

Ejemplos

cURL

curl -H "X-Device-Id: $B4BIT_API_KEY" \
https://pos.b4bit.com/api/v1/orders/info/1040095a-737d-41a2-a2e1-d031d19ec8cd

Node

const id = '1040095a-737d-41a2-a2e1-d031d19ec8cd';
const res = await fetch(`https://pos.b4bit.com/api/v1/orders/info/${id}`, {
headers: { 'X-Device-Id': process.env.B4BIT_API_KEY },
});
const payment = await res.json();
console.log(payment.status, payment.safe);

Python

import os, requests

identifier = '1040095a-737d-41a2-a2e1-d031d19ec8cd'
r = requests.get(
  f'https://pos.b4bit.com/api/v1/orders/info/{identifier}',
  headers={'X-Device-Id': os.environ['B4BIT_API_KEY']},
)
payment = r.json()

Respuesta 200

La respuesta es un array con el (único) Payment correspondiente al identifier:

[
  {
    "identifier": "1040095a-737d-41a2-a2e1-d031d19ec8cd",
    "reference": "ORD-123",
    "created_at": "2026-04-17T10:00:00+02:00",
    "edited_at": "2026-04-17T10:12:45+02:00",
    "status": "CO",
    "fiat_amount": 125.02,
    "fiat": "MXN",
    "crypto_amount": 0.00245,
    "unconfirmed_amount": 0.0,
    "confirmed_amount": 0.00245,
    "received_amount": 125.02,
    "currency_id": "BTC",
    "merchant_device_id": 42,
    "merchant_device": "caja-tienda-3",
    "address": "bc1q...",
    "tag_memo": "",
    "url_ok": "https://tu-sitio.com/pago/ok",
    "url_ko": "https://tu-sitio.com/pago/error",
    "url_standby": null,
    "expired_time": "2026-04-17T11:00:00+02:00",
    "good_fee": true,
    "safe": true,
    "rbf": false,
    "percentage": 100.0,
    "language": "es",
    "notes": "Pedido de prueba",
    "internal_data": null,
    "transactions": [
      {
        "confirmed": true,
        "currency": "BTC",
        "amount": 0.00245,
        "tx_hash": "abc123...",
        "block": 834212,
        "created_at": "2026-04-17T10:08:30+02:00"
      }
    ]
  }
]

Precaución

fiat_amount está expresado en USDC, no en la divisa fiat del merchant. Es el valor liquidado internamente. Ejemplo: si creó la orden con expected_output_amount: 2500 y fiat: "MXN", la respuesta podría mostrar fiat_amount: ~125.02 — equivalente en USDC al importe MXN cobrado. Ver Campos del pago y FX rates.

Ver payment-fields para el detalle semántico de cada campo.

Casos de uso

1. Polling de estado cuando no puede recibir webhooks (por ejemplo en dev local sin túnel).
2. Reconciliación: tras un webhook dudoso, consulte este endpoint para validar el estado autoritativo.
3. Detalle para el cliente: exponer el estado actual de su pedido en su UI usando los campos percentage, status, unconfirmed_amount, confirmed_amount.

Errores

• 403 — Falta o inválida X-Device-Id.
• 404 — No existe ninguna orden con ese identifier en este dispositivo/comercio.
• 500 — Error interno.

Consejo

El campo safe es el que debe usar para decidir si liberar producto/servicio, no solo status. Un status: AC, safe: false todavía no es seguro aunque haya importe acreditado.