Skill de integración

Si integra B4bit Pay con Claude Code, Claude Desktop o Cursor, instale el skill b4bit-pay-integrator. Claude reconoce el contexto (archivos como webhook.ts, cabeceras X-Device-Id, símbolos XRP/XLM/ALGO) y ofrece plantillas seguras, diagnóstico de firma HMAC y el checklist completo de go-live.

¿Qué hace el skill?

Cuando Claude detecta que está trabajando en código que toca B4bit Pay (por triggers como pos.b4bit.com, X-Device-Id, webhook HMAC, X-NONCE, payment_uri), activa automáticamente este skill y aplica:

Reglas de seguridad no negociables: comparación HMAC timing-safe (crypto.timingSafeEqual / hmac.compare_digest / hash_equals), nunca ==.
Plantillas listas de webhook handler para Node (Express), Python (Flask), PHP (Slim), Go (Gin) y Next.js (Route Handler) — todas con firma validada correctamente.
Mapeo de los 11 estados (NR, PE, AC, IA, CO, CA, EX, OC, FA, DE, CM) a los 4-5 estados típicos del merchant (pending / processing / cancelled / failed).
Detección de TAG/MEMO: si el flujo usa XRP, XLM o ALGO, Claude inserta el callout que hace visible el tag_memo en la UI del cliente (omisión = pérdida de fondos).
Checklist de go-live (11 ítems) ejecutado antes de permitirle marcar la integración como lista.
Diagnóstico de mismatch HMAC: si su firma no coincide, el skill guía por las causas típicas (secret mal decodificado, body reserializado, charset incorrecto).

Instalación

Instale el MCP server en su cliente de IA (sección siguiente).
Instale el skill en ~/.claude/skills/:
Ventana de terminal
```
npx @b4bit/b4bit-pay-mcp install-skill
```
Esto copia la carpeta b4bit-pay-integrator/ (plantillas, scripts, SKILL.md) a su directorio personal de skills.
Reinicie Claude Code / Claude Desktop / Cursor y abra un proyecto merchant. El skill se activará solo cuando detecte triggers relacionados con B4bit Pay.

Configurar el MCP server

El skill delega operaciones como “verifica esta firma” o “lista las monedas” al MCP server. Añádalo al cliente que use:

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

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

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

La API key se obtiene en Ajustes → Comercio → Dispositivos (pay.b4bit.com/settings/commerce/devices).

Qué puede pedirle a Claude

Una vez instalado, estas peticiones activan el skill automáticamente:

“Integra B4bit Pay en mi app Express.” → Genera el webhook handler con HMAC timing-safe + endpoint para crear orden + manejo de los 11 estados.
“Mi webhook devuelve 401 firma inválida, ¿qué está mal?” → Claude invoca verify_webhook del MCP con su nonce/body/signature reales y diagnostica el problema (secret decodificado como base64 en vez de hex, body reserializado, concatenación inversa…).
“¿Qué significa status=AC con safe=true?” → Invoca map_status y responde con el estado merchant correspondiente y si es seguro liberar producto.
“Quiero integrar XRP como moneda de entrada.” → Inserta el callout TAG/MEMO en la UI y valida que el tag_memo se renderice tan prominente como la address.
“Auditoría antes de producción.” → Ejecuta el go-live checklist sobre su repo y reporta ítems pendientes.

Herramientas del MCP que el skill usa

Tool	Caso
`list_currencies`	Validar símbolo de entrada antes de crear la orden.
`create_order`	Dry-run o crear orden real respetando todos los campos.
`get_order`	Consultar estado actual de un pago.
`list_orders`	Reconciliación por ventana de fechas.
`verify_webhook`	Reproducir el HMAC y diagnosticar mismatches.
`map_status`	Traducir `NR…CM` a pending/processing/cancelled/failed.
`probe_endpoint`	GET/POST arbitrario contra `pos.b4bit.com` (con dry-run).
`list_endpoints`	Referencia rápida de los 5 endpoints públicos.
`create_device`	Crear dispositivo (requiere confirmación explícita).

Verificación

Confirme que el skill está activo:

ls ~/.claude/skills/b4bit-pay-integrator/
# SKILL.md  references/  scripts/  templates/

Y pruebe en Claude: “¿Cuál es el test vector oficial del webhook de B4bit Pay?” — debería responder con el vector del SKILL.md y ofrecer reproducirlo con el MCP.

Recursos

Paquete npm @b4bit/b4bit-pay-mcp en npmjs.com

Quickstart Guía 5 min sin skill (manual).

Webhook — test vectors Vector oficial reproducible.

Errores comunes 403/404/429/500 y troubleshooting.