Clase 04 · Módulo 08
Cobrar con Mercado Pago Checkout Pro
Cobrar con Mercado Pago Checkout Pro
Qué logras en esta clase
Diriges a Claude Code para integrar el cobro con Checkout Pro de forma segura.
- Entiendes qué es una preferencia de pago y quién la crea.
- Guardas las credenciales donde corresponde.
- Sabes probar el cobro y revisar que el precio salga del servidor.
02
Qué es Checkout Pro
Checkout Pro es el producto de Mercado Pago que cobra por redirección: el comprador sale de tu web, paga en un entorno de Mercado Pago y vuelve a tu sitio.
Los datos de la tarjeta se escriben allá. Tu web nunca los ve ni los guarda, y eso te quita la parte más delicada de la seguridad de un cobro.
03
El recorrido de un cobro
Todo parte en tu servidor. El navegador solo recibe una dirección a la cual ir.
04
Dónde se crea el cobro
La preferencia se crea en el servidor, con el precio de tu catálogo.
05
Lo que necesitas antes de empezar
- Una cuenta de Mercado Pago a nombre de quien vende.
- Una aplicación creada en el Panel del desarrollador de Mercado Pago.
- Las credenciales de esa aplicación.
- Una función de servidor en tu proyecto, como la del formulario del módulo 7.
- El catálogo y la tabla de pedidos de las clases anteriores.
Los requisitos para activar el cobro real pueden cambiar: léelos en la documentación de Checkout Pro.
06
El Access Token es un secreto
El Access Token es la credencial que crea cobros. Quien lo tenga opera a nombre de tu cuenta.
- Va en una variable de entorno sin prefijo público, como viste en el módulo 7.
- Nunca en el código, en el repositorio ni en el navegador.
- En producción se carga en el panel de tu alojamiento.
07
Qué es una preferencia
Una preferencia es la descripción de un cobro: qué se vende, a qué precio y a dónde vuelve el comprador al terminar.
Tu servidor la crea con una petición POST /checkout/preferences a la API de Mercado Pago. La respuesta trae, entre otros datos, init_point: la dirección de pago a la que rediriges al comprador.
Cada intento de compra genera una preferencia nueva.
08
Los campos que debes reconocer
| Campo | Qué es |
|---|---|
| Ítems | Los productos, con cantidad y precio |
back_urls | Direcciones de tu sitio a las que vuelve el comprador |
external_reference | Tu número de pedido |
notification_url | Dirección donde Mercado Pago avisa del pago |
init_point | Viene en la respuesta: la dirección de pago |
La lista completa y el formato exacto están en la referencia oficial.
09
Lo que hace tu función, paso a paso
- Recibe identificadores, cantidades y datos del comprador.
- Valida los datos.
- Lee precios, estado y stock desde el catálogo.
- Calcula el total con despacho.
- Crea el pedido con estado «creado».
- Crea la preferencia con esos ítems y el número de pedido.
- Devuelve
init_pointal navegador.
Si algo falla en los pasos 2 a 4, no se crea nada y el navegador recibe el motivo.
10
SDK oficial o llamada directa
| Camino | Ventaja | Costo |
|---|---|---|
SDK oficial mercadopago | Menos código; maneja los detalles de la API | Una dependencia más que actualizar |
| Petición HTTP directa | Sin dependencias | Escribes y mantienes más |
Un SDK es un paquete que envuelve una API para usarla desde tu lenguaje. El de Node pide Node 18 o superior. Consulta la versión vigente con npm view mercadopago version.
11
No memorices la API
Los nombres de campos cambian. Haz que Claude lea la referencia vigente antes de escribir.
12
Cómo pedirlo a Claude
Trabaja en modo plan y entrega el diseño ya decidido.
En el plan revisa de dónde sale el precio, dónde se lee el Access Token y qué pasa si Mercado Pago responde con error.
13
Redirigir al comprador
Cuando el navegador recibe init_point, lleva al comprador a esa dirección. Desde ahí la pantalla es de Mercado Pago: medios de pago, datos y confirmación.
Mientras tu función responde, deshabilita el botón y muestra que se está procesando. Evitas pedidos duplicados por doble clic.
14
Las direcciones de retorno
En back_urls indicas a qué páginas de tu sitio vuelve el comprador al terminar. Son las páginas de retorno que diseñaste en la clase 3.
15
Probar sin dinero real
Mercado Pago separa el modo de prueba del modo de producción: su panel distingue, por ejemplo, la dirección de avisos de prueba de la de producción.
Los pasos exactos (qué credenciales usar, cómo obtener cuentas de prueba y cómo simular un pago aprobado o rechazado) cambian con el panel y no se detallan aquí. Compruébalos en la fuente: la guía de Checkout Pro, sección de pruebas.
16
Qué probar antes de cobrar de verdad
- Un pago aprobado, de punta a punta.
- Un pago rechazado.
- El comprador cierra la pestaña sin pagar.
- Un producto agotado o desactivado.
- Un carrito con el precio manipulado desde el navegador.
Después de las pruebas, haz una compra real pequeña con tu propia tarjeta y devuélvela.
17
El aviso de pago necesita una dirección pública
Mercado Pago no puede llamar a localhost: tu computador no es visible desde internet.
Para probar el recorrido completo usa una vista previa publicada de tu proyecto, como verás en el módulo 10. En local puedes probar hasta la redirección al pago.
18
Comisiones y plazos del dinero
Cada cobro aprobado descuenta una comisión. Su monto y el plazo en que el dinero queda disponible dependen de tu cuenta y del medio de pago.
Esta clase no fija cifras. Compruébalas en la fuente: la ayuda de Mercado Pago y tu cuenta, antes de fijar precios, y vuelve a mirarlas cada cierto tiempo.
19
Devolver un pago
La API permite devolver un pago completo o una parte con POST /v1/payments/{id}/refunds.
Con pocas ventas no necesitas programarlo: una devolución ocasional se hace desde tu cuenta. Lo importante es que el pedido en tu base quede con estado «anulado» y con una nota de por qué.
20
El token en el navegador
Si pasó, no basta borrar la línea: genera credenciales nuevas en el panel y reemplaza las anteriores.
21
Código de una API antigua
Pide que cite la página de la referencia que usó para cada campo y comprueba que la versión instalada del SDK sea la vigente.
22
Lo que te llevas
- Checkout Pro cobra por redirección: tu web no toca datos de tarjeta.
- La preferencia se crea en el servidor con precios del catálogo.
- El Access Token vive solo en variables de entorno del servidor.
external_referencelleva tu número de pedido;init_pointes a donde rediriges.- La página de retorno informa; no confirma el pago.
23
Hazlo ahora
En 15 minutos:
- Crea una aplicación en el Panel del desarrollador de Mercado Pago.
- Ubica sus credenciales y distingue las de prueba de las de producción.
- Guarda el Access Token de prueba en tu
.envy comprueba que.envestá en.gitignore. - Abre la referencia de Checkout Pro y encuentra los cinco campos de esta clase.
- Pídele a Claude, en modo plan, la función de cobro y revisa de dónde sale el precio.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026