Glosario

Términos clave

Comercio (merchant) : La entidad legal que cobra en B4bit Pay. Agrupa uno o varios dispositivos y usuarios.

Dispositivo (device) : Un punto de cobro dentro de un comercio. Cada dispositivo tiene su propia API Key y Secret Key. Puede ser físico (TPV, caja) o virtual (sitio web, enlace de pago).

API Key (X-Device-Id) : UUID4 que identifica al dispositivo ante la API REST. Se envía en la cabecera X-Device-Id de cada petición.

Secret Key : Clave hexadecimal usada solo para verificar la firma HMAC-SHA256 de los webhooks entrantes. Nunca se envía en peticiones.

Pasarela (gateway) : La infraestructura de B4bit Pay que procesa los pagos. Se usa en dos modos: Redirect Gateway (hospedada por B4bit) y API Gateway (usted construye la UI).

Criptomoneda (cryptocurrency) : Activo digital basado en blockchain (BTC, ETH, USDT, etc.). En B4bit Pay cada combinación (moneda, red) tiene su propio símbolo.

Divisa fiat (fiat currency) : Moneda de curso legal (MXN, USD, EUR, etc.). B4bit Pay cobra y muestra los importes en fiat pero liquida en USDC internamente.

Stablecoin : Criptomoneda cuyo valor está anclado a un activo estable, generalmente el USD (USDT, USDC, DAI).

USDC : Stablecoin respaldada 1:1 por USD. B4bit Pay la usa internamente como moneda de liquidación.

Lightning Network / BTCL : Red de pagos off-chain sobre Bitcoin, prácticamente instantánea. En B4bit Pay se usa el símbolo BTCL. El flujo requiere invoice BOLT11 en vez de dirección.

TAG / MEMO : Identificador adicional requerido por XRP, XLM y ALGO para rutar el pago al destinatario correcto en wallets compartidas. Si no se envía, los fondos se pierden.

Webhook : Petición HTTP que B4bit Pay envía a su servidor cuando cambia el estado de un pago. Se firma con HMAC-SHA256.

HMAC (Hash-based Message Authentication Code) : Algoritmo para verificar autenticidad e integridad de un mensaje con una clave secreta compartida. B4bit Pay usa HMAC-SHA256.

Nonce (X-NONCE) : Unix timestamp que se incluye en el webhook para prevenir replay attacks. Rechace peticiones con nonce más antiguo que 15-20 segundos.

Reference : Campo opcional que el merchant incluye al crear una orden. Sirve para correlacionar la orden de B4bit Pay con su sistema interno (por ejemplo, el ID del pedido en su base de datos).

Input currency : La criptomoneda y red con la que el cliente paga. Si no se especifica al crear la orden, el cliente la elige en la pasarela.

Output amount (expected_output_amount) : El importe que usted cobra, en divisa fiat.

Input amount (expected_input_amount) : El importe equivalente en criptomoneda, calculado por B4bit Pay usando el rate al momento de crear la orden.

Safe : Campo booleano del payment. true indica que el pago tiene ≥1 confirmación blockchain y es seguro liberar producto/servicio.

Good fee : Indica si la comisión de red de la transacción entrante es adecuada. Si es false, puede que la confirmación tarde más.

RBF (Replace By Fee) : Mecanismo de Bitcoin para reemplazar una transacción pendiente por una con fee más alta. B4bit Pay lo detecta y marca el campo rbf cuando aplica.

KYB (Know Your Business) : Proceso de verificación de la identidad empresarial del merchant. En B4bit Pay activa tres niveles según el volumen operado.

LFPIORPI : Ley Federal para Prevención de Operaciones con Recursos de Procedencia Ilícita (México). B4bit Pay opera como “actividad vulnerable” bajo esta ley.