En esta nota (14 secciones)
En corto: integrar Mercado Pago a tu sistema significa que el cliente pague y que tu sistema se entere solo, sin que nadie mire el extracto: se genera el cobro, el cliente paga en el entorno de Mercado Pago y un aviso automático le confirma a tu sistema que el pago entró, para marcar el pedido o la cuota como pagado. Lo que más se subestima no es el botón de pago, sino ese aviso y qué hace tu sistema cuando llega tarde, llega repetido o no llega.
La nota explica las formas de cobrar, qué ocurre en cada paso, los casos que hay que prever y cuánto trabajo implica.
Las formas de cobrar más comunes
Forma | Cómo funciona | Cuándo conviene |
|---|---|---|
Link de pago | Generas un enlace por cobro y lo envías por WhatsApp o correo | Cobros puntuales, cuotas, presupuestos |
Checkout en tu sitio o sistema | El cliente elige pagar y es llevado al formulario de Mercado Pago | Tiendas, reservas, pedidos |
Suscripciones | Cobro recurrente automático | Cuotas mensuales, membresías |
Código QR | Cobro en el mostrador o en el reparto | Comercio físico |
La más usada en sistemas de gestión es el checkout con redirección. Según la documentación de Checkout Pro, el cliente decide pagar en tu sitio, es dirigido al formulario de Mercado Pago, paga con sus medios guardados o nuevos y vuelve a tu sitio o a la dirección que definas. Los medios disponibles dependen de cada país y se detallan en la documentación del país donde operas. Mercado Pago opera en varios países de la región, y cada uno tiene su propia documentación y medios de pago.
El recorrido de un cobro, paso a paso
- Tu sistema crea el cobro con el monto, la descripción y una referencia propia (por ejemplo, el número de pedido).
- El cliente es llevado a Mercado Pago y paga.
- Vuelve a tu sistema, que le muestra una pantalla de resultado.
- Mercado Pago avisa a tu sistema, por separado, que el pago cambió de estado.
- Tu sistema confirma consultando el pago y recién entonces lo marca como cobrado.
El paso 3 y el paso 4 son distintos y es la causa de muchos errores. El cliente puede volver a tu sitio sin que el pago esté confirmado (por ejemplo, un pago pendiente), o puede cerrar la ventana antes de volver y pagar igual. Por eso el estado real nunca debe salir de la pantalla de retorno: sale del aviso.
El aviso automático: lo que hay que hacer bien
Mercado Pago lo llama webhook: un mensaje automático que envía a una dirección de tu sistema cada vez que ocurre algo. Según su documentación de notificaciones:
- Se configura desde el panel de tu aplicación, o al momento de crear cada cobro. Si se define en el cobro, tiene prioridad sobre el panel.
- Cada aviso incluye una firma que permite comprobar que viene de Mercado Pago y no de un tercero. Si no coincide, hay que rechazarlo.
- Tu sistema debe responder que lo recibió, en un máximo de 22 segundos. Si no, Mercado Pago reintenta cada 15 minutos y luego espaciando los intentos.
- El aviso avisa que algo cambió; el detalle se consulta después a Mercado Pago.
- El panel muestra los avisos enviados y su estado, lo que ayuda a recuperar lo que falló.
Para un dueño de negocio, la traducción es esta: el sistema tiene que ser capaz de recibir el mismo aviso dos veces sin cobrar dos veces, y de recibir uno atrasado sin pisar un estado más reciente.
Los casos que hay que prever
Caso | Qué debería pasar |
|---|---|
Pago aprobado | Se marca como cobrado y se dispara lo que sigue (entrega, recibo, confirmación) |
Pago pendiente | El pedido queda en espera; no se entrega todavía |
Pago rechazado | Se avisa al cliente y se le permite reintentar |
Aviso repetido | Se ignora el duplicado |
Aviso que no llega | Un proceso periódico consulta los pagos pendientes y los concilia |
Devolución | Se registra, se ajusta el saldo y se informa al cliente |
Contracargo o disputa | Se marca para revisión de una persona |
Cliente que paga de más o de menos | Se detecta la diferencia y se deriva |
Los tres últimos no suelen estar en la primera versión de un presupuesto barato, y son los que generan trabajo manual meses después.
La conciliación
Aunque todo funcione, conviene que el sistema compare cada día lo que él marcó como cobrado con lo que Mercado Pago informa como acreditado. Esa conciliación es la red de seguridad: si algún aviso se perdió, aparece al día siguiente y no al cierre del mes.
Costos que no son de desarrollo
Mercado Pago cobra una comisión por cada operación, que varía según el país, el medio de pago y el plazo de acreditación. Antes de definir tus precios, revisa las condiciones vigentes en tu país, porque cambian y pueden representar una parte relevante del margen, sobre todo con tarjeta y cuotas. Una alternativa para evitar comisiones en cobros grandes es ofrecer también transferencia bancaria y conciliarla en el sistema. Si operas en varios países o con clientes del exterior, evalúa también una pasarela global como Stripe.
Cuánto trabajo implica
Depende de qué hay alrededor del cobro:
Alcance | Qué incluye | Referencia de esfuerzo |
|---|---|---|
Cobro simple | Link o checkout, aviso, estado de pago | Pocos días |
Cobro con conciliación y devoluciones | Lo anterior más consulta periódica, reintentos y manejo de devoluciones | Algunas semanas |
Cobros recurrentes | Suscripciones, reintentos por fallo, avisos al cliente | Más, por la cantidad de casos |
Como parte de un proyecto mayor, la integración de cobros suele incorporarse al alcance y no se presupuesta por separado. El precio de Atomix para un proyecto con cobros integrados es de USD 5.000 a 10.000, con una demo funcional gratis en 24 a 48 horas antes de cotizar. Para entender cómo se arma el costo de una conexión entre sistemas, mira cuánto cuesta integrar dos sistemas.
Antes de empezar, define esto
- Qué se cobra y cuándo: pago total, seña, cuotas, recurrente.
- Qué pasa cuando se aprueba: qué proceso se dispara en tu operación.
- Quién es el titular de la cuenta: la de tu empresa, no la del desarrollador.
- Quién concilia y cada cuánto.
- Qué país o países y, con eso, qué medios de pago estarán disponibles.
Y una buena práctica: prueba todo el recorrido con las credenciales de prueba antes de cobrar un solo peso real. La documentación ofrece una dirección de notificaciones de prueba separada de la de producción, justamente para eso.
Si el cobro va dentro de un sistema de gestión, la nota cómo elegir un sistema de gestión ayuda a ordenar qué más necesita. Y si te interesa que el sistema se conecte con otros servicios, conoce el servicio de desarrollo de software a medida de Atomix.
Preguntas frecuentes
¿Puedo cobrar sin que el cliente salga de mi sistema?
Hay formas de integrar el formulario de pago dentro de tu página, pero la opción con redirección es la más simple y la que menos riesgo tiene. Para la mayoría de los sistemas de gestión alcanza y sobra.
¿Qué pasa si el cliente paga y el sistema no se entera?
Para eso existen la consulta periódica y la conciliación diaria: el sistema revisa los pagos pendientes y los actualiza. Es parte de una integración bien hecha, no un extra.
¿Se puede cobrar en cuotas o con suscripción?
Sí. Los cobros recurrentes tienen sus propias reglas y más casos a prever, como el fallo de una tarjeta o el cambio de monto, así que se presupuestan aparte.
¿Necesito una cuenta especial para integrar?
Necesitas una cuenta de Mercado Pago verificada y crear una aplicación en su panel de desarrolladores, que te da las credenciales. Conviene que esa cuenta sea de tu empresa.
¿Mercado Pago es la única opción?
No. Depende de tu país y de tus clientes. En algunos casos conviene ofrecer varias formas de pago y que el sistema las concilie todas en un mismo lugar.
Si quieres revisar cómo integrar los cobros en tu operación, puedes agendar una llamada.