Preguntas frecuentes

General

¿Qué es B4bit Pay?

Una pasarela de pagos que permite a su comercio aceptar criptomonedas y recibir el saldo equivalente en USD automáticamente. Ver cómo funciona.

¿Cuánto cuesta?

0.95% por operación. Sin cuotas mensuales ni cargos ocultos. Ver comisiones.

¿Necesito conocimientos técnicos?

No. Para cobros básicos basta con crear una cuenta, un comercio y usar el QR único o los links de pago. La integración API es opcional.

Pagos

¿Qué criptomonedas acepto?

13+ criptomonedas principales en múltiples redes. La lista autoritativa siempre está en GET /currencies. Ver criptomonedas aceptadas.

¿Un pago puede expirar?

Sí. El estado EX (Expired) aparece cuando no se recibe el pago en 15 o 60 minutos según la red. Si pasa más de 24h sin recibir pago, pasa a CA (Cancelled).

¿Qué pasa si el cliente paga un importe menor?

El pago queda en estado IA (Insufficient Amount) o OC (Out of Condition). No libere producto. El caso se gestiona manualmente por soporte.

¿Y si paga un importe mayor?

El estado puede llegar a CO (Completed) sin problemas. El excedente queda acreditado.

¿Puedo hacer refunds?

La API no tiene endpoint de refund por ahora. Si su cliente requiere una devolución, el flujo es off-chain manual vía support@b4bit.com. Registre el caso usando el campo reference del pago original para trazabilidad. Ver refunds.

API

¿Dónde obtengo mi API Key?

En el dashboard: Configuración → Comercio → Dispositivos. Cada dispositivo tiene su propia API Key (X-Device-Id) y Secret Key.

¿La API Key y la Secret Key son lo mismo?

No. La API Key (X-Device-Id) va en el header de las peticiones REST. La Secret Key se usa solo para verificar HMAC de webhooks. Nunca las mezcle.

¿Hay entorno sandbox?

Ver sandbox. En producción puede testar con importes mínimos (1 MXN) y cancelar antes de que el cliente pague, pero no hay un sandbox aislado público en este momento.

¿Cuáles son los rate limits?

2000 peticiones/día por dispositivo, 60/minuto, 15/minuto en endpoints estrictos. Ver rate limits.

¿Cómo pruebo mi implementación de HMAC?

Use los test vectors oficiales del webhook — pegue el secret, nonce y body en su función y confirme que produce la firma esperada.

Webhooks

¿Cuántas veces intenta B4bit Pay enviarme un webhook?

Una sola vez. Confirmado contra el código del backend: no hay retry logic. Si su endpoint está caído, el webhook se pierde. Combine con reconciliación periódica vía GET /orders/. Ver webhook ordering.

¿Qué HTTP status debe devolver mi servidor?

200 OK rápidamente (< 5 segundos). Procese la lógica pesada de forma asíncrona.

¿Y si mi servidor está caído?

Peligro

El webhook se pierde (no hay retry). Mitigue con: (a) alta disponibilidad del endpoint, (b) reconciliación nocturna por GET /orders/, (c) consultas puntuales a GET /orders/info/{identifier} para órdenes que nunca recibieron callback.

¿Por qué mi firma no coincide?

Cinco causas comunes:

1. No decodificó la Secret Key desde hex a bytes antes de calcular el HMAC.
2. Parseó el body JSON y lo reserializó (debe usar el body crudo tal cual llegó).
3. Añadió un trailing newline al body.
4. Concatenó en el orden equivocado (debe ser nonce + body, no al revés).
5. Comparó con == en lugar de timing-safe.

Verifique con los test vectors y la tool verify_webhook del MCP.

Retiros

¿Cuánto tarda un retiro?

Depende de la red. En redes rápidas (Polygon, Arbitrum, Tron) puede tardar minutos; en Ethereum, según congestión.

¿Puedo retirar en cualquier cripto?

Sí, en las mismas redes que soporta B4bit Pay para cobros. Ver retiro de fondos.

Cuenta

¿Puedo tener múltiples usuarios en mi comercio?

Sí. Hay tres roles: Administrador, Administrador de Solo Lectura y Operador. Ver perfiles de usuario.

¿Dónde escribo si tengo un problema?

A support@b4bit.com (L-V 9-19h CDMX) o en el portal de soporte.