Documentación

Cómo funciona y cómo integrarlo

Todo lo necesario para que tu tienda cobre con Binance Pay: conectar tu cuenta, entender cómo se cobra y enlazar tu plataforma.

Módulo

WooCommerce

Plugin para WordPress. 10 minutos.

Pasarela

WHMCS

Para hosting y facturación recurrente.

Referencia

Conceptos

Cobro

Una solicitud de pago que tu tienda crea por cada pedido. Tiene un importe pedido (lo que vale el pedido), un importe a pagar (el que el comprador debe abonar, exacto), una fecha de caducidad (15 minutos por defecto) y un estado.

Estados de un cobro

Estado	Significado
Esperando	Creado y mostrado al comprador. Aún no hemos visto el pago.
Detectado	Vimos una transacción con el importe exacto en tu cuenta. Estamos confirmándola y enviando el aviso a tu tienda.
Pagado	Confirmado y aviso entregado (o en reintento). Puedes entregar el pedido.
Caducado	Pasaron los 15 minutos sin pago. El cobro se cierra y ya no admite pago.

Conectar tu cuenta de Binance

Necesitamos una clave de API de solo lectura. Con ella podemos ver tu historial de pagos; no podemos retirar, transferir ni operar.

Entra en Binance → Perfil → Gestión de API → Crear API → "Generada por el sistema".
Ponle un nombre, por ejemplo Pagos BI, y confirma con tu 2FA.
Revisa los permisos. Debe estar marcada únicamente Habilitar lectura. Deja desmarcadas "Habilitar trading spot", "Habilitar retiros" y todo lo demás.
Copia la clave y el secreto y pégalos en Conexión con Binance. Pulsa Probar conexión: te confirmamos que los permisos son solo de lectura.
Sube tu QR de Binance Pay (Binance → Pay → Recibir → guardar imagen) y pega tu Pay ID.

Comprobación rápida. Si la clave tuviera permiso de retiro, nuestro botón de prueba lo detecta y rechaza la conexión. Preferimos no tener ese permiso a que lo tengamos por error.

El importe se paga exacto

Cada cobro lleva un importe que el comprador debe abonar tal cual, sin redondear. La pantalla de pago lo muestra en grande y con botón de copiar para que no haya margen de error.

Si el importe no coincide, el cobro no se da por pagado.
Al caducar o pagarse, el cobro se cierra.

Avisos a tu tienda

Cuando confirmamos un pago, hacemos una petición POST a la dirección que configures, firmada con HMAC-SHA256. Si tu servidor no responde 2xx, reintentamos 6 veces con esperas crecientes (1, 5, 15, 60, 240 y 720 minutos). Todo queda en el detalle del cobro. Los detalles de firma están en la referencia de la API.