Conexión con el banco

Por qué conectar el banco

Sin banco, un pago se confirma por lo que muestra la foto del comprobante. Con el banco conectado, se confirma por lo que de verdad entró en tu cuenta. Un comprobante editado, repetido o de otra cuenta no confirma nada, y los pagos buenos se aprueban solos en minutos, sin que tengas que mirar tu banca en línea.

Hay dos formas de conectarlo, y se pueden tener las dos a la vez:

Usa una cuenta solo para el bot

Conexión directa con Banco de Venezuela

La pestaña Banco empieza con una línea («Dos formas de que los pagos se confirmen solos. Con una basta.») y el aviso de usar una cuenta solo para el bot, una sola vez. Debajo, la sección Conexión con el banco, con la insignia Recomendada o, ya encendida, Activa con BDV: «El banco confirma los pagos directamente: el pago móvil en el momento y las transferencias cada pocos minutos. No depende de ningún teléfono». Se permite un banco por negocio. Es igual en el panel y en la app.

1. Saca la clave de la API en BDVenLínea Empresas

   Ruta: Consultas → Otras Consultas → Conciliación Automática → Ver API.

2. Rellena los datos en Ajustes → Pagos → Banco

   Clave de la API

   Secreta. Después de guardarla solo se ven los últimos 4 caracteres (••••XXXX).

   Cuenta del comercio

   20 dígitos, empieza por 0102. Si no, «esa cuenta no es de Banco de Venezuela (empieza por 0102)».

   RIF de la empresa (opcional)

   Por ejemplo J000000000. Si lo pones, se descartan los avisos dirigidos a otro RIF.

   Clave del webhook

   La genera el sistema. No la escribes tú.

3. Pulsa «Guardar datos del banco» y luego «Probar conexión»

   Resultado de la prueba	Qué significa
   El banco respondió: hoy no hay ingresos en esa cuenta todavía.	Todo bien; simplemente no hubo movimientos hoy.
   El banco respondió: N ingresos en esa cuenta hoy.	Todo bien.
   El banco rechazó la clave de la API…	La clave está mal copiada o fue revocada. Genera otra en BDVenLínea.
   No hubo respuesta del Banco de Venezuela…	El banco no está respondiendo ahora. Prueba más tarde.

4. Enciende «Validar pagos con el banco»

   Solo se deja encender con los datos completos; si falta algo, dice «Para activar Banco de Venezuela falta: …».

5. Pide al banco el aviso instantáneo del pago móvil

   Ver la sección siguiente. Mientras tanto, todo funciona por el barrido de movimientos.

Quitar el banco borra la clave y la cuenta guardadas. Si la última consulta al banco falló, lo verás como «Última consulta al banco: …».

Conexión directa con Bancaribe

Cuando hay más de un banco disponible, arriba de la sección aparece el selector Banco. Elige Bancaribe y la sección pasa a pedir sus datos. Si no ves el selector, Bancaribe todavía no está habilitado en tu cuenta: escríbenos.

Bancaribe solo ofrece estos servicios a empresas (clientes jurídicos) afiliadas a sus API. Las credenciales te las entrega el banco al afiliarte.

Con Bancaribe un pago puede confirmarse por tres vías, y se complementan:

• Aviso del banco, al instante. Se activa con el Servicio de Notificación de Transacciones: avisa de transferencias, pago móvil y depósitos. Al guardar tus datos, la sección te muestra la URL del webhook y la Clave del webhook (ApiKey) con sus botones de copiar, y los pasos: afiliar la cuenta en Mi Conexión Bancaribe Jurídica, registrar allí la URL y la clave, y enviar a tu ejecutivo del banco la URL y la IP del servidor para que la autoricen.
• Consulta de la referencia. Cuando el cliente manda su comprobante o su referencia (6 dígitos o más), se le pregunta al banco por ese pago en el momento, en el día del pedido. Solo cuenta si el banco lo tiene con fecha de ese día y posterior al pedido: la captura de un pago viejo no confirma un pedido nuevo. Necesita el hash de operaciones.
• Revisión de movimientos, cada pocos minutos. Recoge lo que no haya llegado por las otras dos. Necesita el hash de movimientos. Los movimientos de Bancaribe no dicen quién pagó, así que se cruzan por referencia y monto.

Probar conexión comprueba que el banco acepta las credenciales y, si pusiste el hash de movimientos, consulta los ingresos de hoy. Sin ningún hash te lo dice: «Falta al menos un hash (movimientos u operaciones) para poder consultar pagos».

Cómo conseguir los datos de tu banco

Cada banco trae el desplegable Cómo conseguir los datos, abierto mientras no hayas guardado nada y plegado después: dónde se piden las credenciales de ese banco y, si el banco publica un correo para ello, el correo con sus botones Copiar y Escribir al banco. Todos estos bancos dan acceso a sus API solo a empresas (clientes jurídicos).

Conexión directa con Mercantil

Elige Mercantil en el selector Banco. Mercantil da acceso a sus API a clientes con cuenta corriente afiliados a Mercantil en Línea Empresas: te registras en el Portal API Mercantil, creas tu aplicación y el banco te envía las credenciales por correo. El aviso de pagos se pide aparte a tu ejecutivo.

• Aviso del banco, al instante. Al guardar, la sección te muestra la URL del webhook con su botón de copiar y los pasos: pedir la afiliación al Servicio de Notificación de Pagos, darle al banco esa URL y pegar aquí la MasterKey. Avisa de pago móvil, C2P y débito inmediato.
• Sin revisión de movimientos. Mercantil no ofrece una consulta de los movimientos de la cuenta, así que las transferencias no se ven por el banco: se confirman por el comprobante, como siempre.

Probar conexión hace una búsqueda al banco para comprobar el Client ID, el código de comercio y la clave secreta. El aviso instantáneo solo se comprueba con un pago real: haz uno de prueba a la cuenta.

Conexión directa con Banco Plaza

Elige Banco Plaza en el selector. Las credenciales se piden a Plaza Open APIs (el formulario de su portal o PlazaOpenAPIs@bancoplaza.com): para conciliar hacen falta Comprobación de Pagos P2P/P2C y Consulta de movimientos. Un ejecutivo te entrega el Client ID y el Client Secret.

Banco Plaza no avisa por su cuenta: se le pregunta. Cuando el cliente manda su referencia (6 dígitos o más), se le pregunta al banco por ella en el momento; y cada 2 minutos se revisan los pagos móviles recibidos y los movimientos de la cuenta, que es donde se ven las transferencias. Un pago móvil sale en las dos consultas con referencias distintas, pero se cuenta una sola vez.

Conexión directa con BNC

Elige BNC Banco Nacional de Crédito en el selector. El acceso a la API de Pagos Electrónicos se pide en tu agencia comercial del BNC. El banco te entrega el Client GUID y la Master Key; además van el RIF de la empresa y la Cuenta del comercio (20 dígitos, empieza por 0191).

Igual que con Banco Plaza, el BNC no avisa: se le pregunta por la referencia que manda el cliente y se revisan los movimientos de la cuenta cada 2 minutos. Probar conexión abre sesión con el banco, consulta el saldo para comprobar que la cuenta es de ese RIF y cuenta los ingresos de hoy.

Las dos vías por las que entra un pago

El correo al banco, ya redactado

Con la conexión guardada aparece el desplegable Aviso instantáneo del pago móvil (plegado: es un extra). Dentro, en el bloque El correo, ya escrito. Solo cópialo., el panel redacta la solicitud de alta con el nombre del negocio, el RIF, el teléfono del pago móvil (sacado de tus métodos de pago) y la dirección a la que el banco debe avisar. Lo que falte aparece como __________ con el aviso «Faltan por rellenar…».

Botones: Copiar el correo, Copiar el asunto, Copiar los destinatarios y Abrir en mi correo. Los destinatarios los muestra el propio panel.

Cómo se cruza un ingreso con un pedido

1. Por referencia

   Iguales, o una termina en la otra, con al menos 6 dígitos. Si el cliente mandó solo los últimos dígitos por texto, bastan 4.

2. Por monto, solo si ya hay comprobante

   El ingreso coincide en bolívares (±0,01) con lo que el cliente dijo que pagó, con lo que le falta al pedido o con su total. Así también se cruzan los abonos. Sin comprobante nunca se cruza solo por monto: si dos pedidos cuestan lo mismo, confirmaría el equivocado. Si el cliente dio solo los últimos dígitos (menos de 6), lo que dice haber pagado no cuenta: el ingreso tiene que ser el total del pedido o lo que le falta.

3. Si hay dudas, no se confirma

   Si varias referencias parciales encajan, se desempata por monto. Si sigue ambiguo, queda para que lo revises tú.

• Un pago reportado espera su ingreso hasta el final del siguiente día hábil (de lunes a viernes, sin feriados nacionales ni bancarios), y nunca menos de 12 horas: una transferencia desde otro banco del viernes por la noche que se acredita el lunes se confirma sola. Si el ingreso llegó antes que el comprobante, se buscan los ingresos de las últimas 12 horas.
• El ingreso tiene que haber llegado después del pedido (con 15 minutos de margen). Un ingreso de antes que nadie usó —una venta de mostrador, el pago de otro cliente— no confirma un pedido nuevo aunque el cliente diga su referencia.
• Cada ingreso paga una sola vez. Si apruebas a mano un pago con referencia (6 dígitos o más), o lo cobras con Registrar cobro o en la puerta, el aviso del banco con esa referencia queda gastado, llegue antes o después.
• Un pedido con algún producto por debajo de su precio de catálogo (una promoción de tus instrucciones que aplicó el asistente) no se confirma solo: lo apruebas tú, y el aviso del pago te lo dice.
• Los avisos repetidos del banco se descartan por referencia.
• Al confirmar, el monto del banco manda sobre el del comprobante, y la fecha del ingreso es la del banco.
• El pago aparece Aprobado por El cruce con el banco y te llega «✅ Pago móvil confirmado — … Validado automáticamente con la notificación del banco» (o «💰 … recibido (pago parcial)» si fue un abono).
• Si el ingreso es más de lo que debe el pedido y el cliente tiene otros pedidos que deben, lo que sobra se aplica a ellos (ver Pagos múltiples).
• El anticipo de una cita funciona igual: al cruzarse, la cita queda confirmada y el cliente recibe «¡Pago confirmado! ✅ Tu cita … quedó confirmada».

Avisos del banco en el teléfono

Cualquier banco Solo Android La app de AtiendeFácil lee la notificación de tu banco en el teléfono y la envía a tu cuenta. Del texto se saca el monto (junto a «Bs»), la referencia y el teléfono que pagó. No hace falta instalar ninguna otra app.

1. Enciende «Validar pagos con los avisos del banco»

   En el bloque Avisos del banco en el teléfono, desde el panel web o desde la app. «El pedido se marca pagado cuando el banco avisa del ingreso, no solo con el comprobante. Da igual cuál de los dos llegue primero».

2. Abre la app en el teléfono Android donde llegan los avisos del banco

   Tiene que ser ese teléfono, con tu sesión iniciada. Ve a Más → Ajustes → Pagos.

3. Enciende «Este teléfono lee los avisos»

   La app te explica qué va a leer y te lleva a los ajustes de Android para conceder el Acceso a notificaciones. Si falta, verás «Falta el permiso «Acceso a notificaciones». Sin él no se lee ningún aviso» con el botón Dar acceso a las notificaciones.

4. Elige la app de tu banco

   Pulsa Añadir app, búscala por su nombre y tócala. Puedes añadir varias. Hasta que elijas una no se envía nada.

5. Si tu banco avisa por SMS, elige la app de mensajes y escribe el remitente

   En Solo de este remitente pon el número o el nombre desde el que escribe tu banco, exactamente como sale en el aviso. En la app de mensajes (SMS, WhatsApp…) es obligatorio: por ahí te escribe cualquiera, así que sin remitente no se envía ningún aviso suyo, y solo cuentan los que vienen de ese remitente exacto. En la app de tu banco es opcional.

Diferencias entre la web y la app

Las dos permiten configurar la conexión directa y encender o apagar los avisos del banco para el negocio. En las dos están en la pestaña Banco de Pagos; en la app, con los botones Guardar datos, Probar conexión, Quitar («Se borran la clave y la cuenta guardadas»), Copiar URL y Copiar clave.

Leer los avisos solo se puede en Android: iPhone no permite que una app lea las notificaciones de otra, y un navegador tampoco. Si usas iPhone, necesitas un teléfono Android donde lleguen los avisos del banco, o la conexión directa.

Preguntas frecuentes