Referencia API

Resumen

Base URL: https://pos.b4bit.com/api/v1
Autenticación: header X-Device-Id: <api-key> en cada petición
Formato: application/json (recomendado). POST /orders/ también admite multipart/form-data como alternativa histórica.
OpenAPI 3: /openapi/b4bit-pay.openapi.json — descargable para herramientas
Redoc oficial: https://pos.b4bit.com/redoc

Endpoints

GET /currencies Lista criptomonedas disponibles.

POST /device/ Crea un dispositivo del comercio.

GET /orders/ Lista pagos por rango de fechas.

POST /orders/ Crea una nueva orden de pago.

GET /orders/info/{id} Detalle completo de un pago.

Páginas de referencia

Autenticación Cómo usar X-Device-Id.

Modos de integración Redirect Gateway vs API Gateway.

Estados de pago NR, PE, AC, IA, CO, CA, EX, OC, FA, DE, CM.

Rate limits 2000/día, 60/min, 15/min strict.

Paginación start/end YYYY/MM/DD, default 7d.

Idempotencia El campo reference como clave única.

Errores 403, 404, 429, 500 y troubleshooting.

Sandbox Entorno de pruebas y alternativas.

Webhook — test vectors 4 casos HMAC reproducibles.

Webhook — ordering Garantías de orden y duplicados.

Reembolsos Flujo off-chain manual.

Tasas de cambio (FX) Bloqueo de rate y liquidación en USDC.

Campos del pago safe, good_fee, rbf, balance_based.

Campos KYC Datos personales opcionales del cliente final.

Quickstart Guía Express 5 min + go-live checklist.

Skill de integración Claude Code + MCP. Plantillas seguras y diagnóstico HMAC.

Integración con Claude / Cursor / clientes MCP

Si usa Claude Desktop, Claude Code o cualquier cliente del Model Context Protocol, puede instalar el paquete oficial @b4bit/b4bit-pay-mcp y Claude podrá listar monedas, crear órdenes, consultar pagos y verificar firmas de webhook sin que usted escriba código HTTP.

{
  "mcpServers": {
    "b4bit-pay": {
      "command": "npx",
      "args": ["-y", "@b4bit/b4bit-pay-mcp"],
      "env": { "B4BIT_API_KEY": "<tu-api-key>" }
    }
  }
}

Herramientas expuestas: list_currencies, create_order, get_order, list_orders, verify_webhook, map_status, probe_endpoint, list_endpoints, create_device.

Además, instale el skill con npx @b4bit/b4bit-pay-mcp install-skill para que Claude Code detecte automáticamente cuándo está integrando B4bit Pay y aplique plantillas seguras + checklist de go-live.

Código fuente: github.com/B4bit-Official/b4bit-pay-mcp.