Clase 05 · Módulo 11
Cobrar bienes y servicios con Mercado Pago
Cobrar bienes y servicios con Mercado Pago
Qué logras en esta clase
Sabrás cuándo te corresponde una pasarela externa y cómo se arma el cobro para que nadie reciba algo sin haber pagado.
- Confirmar que tu caso admite pago externo.
- Entender el recorrido de un pago con Mercado Pago.
- Saber qué hace el servidor y qué hace la app.
- Probar sin mover dinero real.
02
Cuándo corresponde una pasarela
Solo en los casos que las tiendas dejan fuera de su sistema (clase 1):
- Productos físicos que se despachan o retiran.
- Servicios que se consumen fuera de la app.
- Servicios en vivo de una persona a otra.
03
Qué es Mercado Pago
Es una pasarela de pago: un servicio que cobra con tarjetas y otros medios locales y deposita el dinero en tu cuenta, menos su comisión.
| Producto en Chile | Qué es |
|---|---|
| Checkout Pro | El pago ocurre en una página de Mercado Pago |
| Link de pago | Un enlace que se comparte, sin integración |
| Suscripciones | Cobros recurrentes |
04
Cuál conviene
| Opción | Cuándo conviene |
|---|---|
| Link de pago | Pocas ventas, confirmación manual |
| Checkout Pro | App con pedidos y confirmación automática |
| Otra pasarela | Si tu banco o tu rubro ya trabajan con ella |
Esta clase enseña el patrón con Checkout Pro. El mismo patrón sirve para cualquier pasarela seria: cambian los nombres, no la lógica.
05
Lo bueno y lo malo de pagar en página externa
- A favor: los datos de la tarjeta nunca pasan por tu app ni por tu servidor. Menos riesgo y menos obligaciones para ti.
- A favor: el usuario reconoce la página de pago.
- En contra: el usuario sale un momento de la app, y algunos no vuelven.
- En contra: dependes de que el aviso de pago llegue a tu servidor.
06
Costos: consulta la tabla vigente
La comisión depende del medio de pago y de cuándo quieres disponer del dinero.
La página oficial de costos no respondió al preparar esta clase, así que aquí no hay porcentajes.
07
La app nunca decide si alguien pagó
La app es territorio del usuario y se puede manipular. Solo tu servidor, avisado por la pasarela, marca un pedido como pagado.
08
Las piezas del patrón
| Pieza | Rol |
|---|---|
| App | Arma el pedido, abre el pago, muestra el estado |
| Edge Function «crear pago» | Calcula el total y pide el cobro |
| Mercado Pago | Cobra al usuario |
| Edge Function «webhook» | Recibe el aviso y confirma |
| Base de datos | Guarda el pedido y su estado |
Un webhook es una dirección de tu servidor a la que otro servicio llama cuando ocurre algo.
09
El recorrido completo
Hay dos caminos de vuelta: el usuario regresa a la app y, por separado, Mercado Pago avisa a tu servidor. Solo el segundo cuenta.
10
Dos credenciales, dos lugares
Mercado Pago entrega credenciales por aplicación, en su panel de desarrolladores:
- Una clave pública, pensada para el lado del cliente.
- Un token de acceso secreto, que permite crear cobros y consultar pagos.
El token de acceso va solo en los secretos de tus Edge Functions. Nunca en una variable EXPO_PUBLIC_ ni en el repositorio.
11
Paso 1: el pedido nace en tu base
Antes de hablar con Mercado Pago, la app crea el pedido en tu base con estado pendiente.
- Guarda qué productos y qué cantidades.
- Queda asociado al usuario.
- Tiene un identificador propio.
Ese identificador viaja con el cobro y vuelve en el aviso. Es lo que te permite unir un pago con un pedido.
12
Paso 2: el servidor calcula el total
La app envía a la Edge Function solo el identificador del pedido.
La función:
- Verifica la sesión del usuario.
- Lee los productos del pedido y sus precios desde la base.
- Calcula el total.
13
Paso 3: crear la preferencia de pago
En Checkout Pro, el cobro se prepara creando una «preferencia»: la descripción de lo que se cobra.
La Edge Function la crea con el token de acceso e incluye:
- Ítems y monto.
- Tu identificador de pedido como referencia.
- A dónde volver después de pagar.
- La dirección de tu webhook.
Mercado Pago responde con una URL de pago, que la función devuelve a la app.
14
Paso 4: abrir el pago en el navegador del sistema
La app abre esa URL con expo-web-browser, que muestra una pestaña segura del navegador sobre tu app.
No uses una vista web incrustada dentro de una pantalla tuya: el usuario no puede comprobar en qué sitio escribe su tarjeta.
15
Paso 5: volver a la app
Al terminar, Mercado Pago redirige a las direcciones de retorno que definiste. Usa un enlace profundo de tu app (módulo 5, clase 4) para que el usuario caiga en la pantalla del pedido.
Esa pantalla no asume nada: consulta el estado del pedido en tu base y muestra lo que encuentre.
16
El regreso del usuario no prueba el pago
El usuario puede cerrar el navegador, perder señal o fabricar el enlace de retorno. El pedido cambia solo con el aviso al servidor.
17
Paso 6: recibir el aviso
Mercado Pago llama a tu webhook con un mensaje breve: el tipo de aviso y el identificador del recurso, por ejemplo un pago.
Tu función debe:
- Validar que el aviso viene de Mercado Pago.
- Consultar el pago completo en la API con ese identificador.
- Comprobar estado y monto.
- Marcar el pedido.
- Responder con código 200 o 201.
18
Validar el origen del aviso
Tu webhook es una dirección pública: cualquiera puede llamarla.
Mercado Pago firma cada aviso. Al configurar los webhooks genera una clave secreta; con ella, tu función recalcula la firma que llega en la cabecera x-signature y la compara.
Si no coincide, la función rechaza el aviso. La documentación de webhooks describe el cálculo exacto.
19
Consultar el pago, no creerle al mensaje
El aviso dice «pasó algo con el pago 123». No dice que esté aprobado.
Tu función pregunta a la API de Mercado Pago por ese pago y revisa:
- Que el estado sea aprobado.
- Que el monto coincida con el total del pedido.
- Que la referencia sea un pedido tuyo, aún pendiente.
Recién entonces marca el pedido como pagado.
20
Plazos y reintentos del aviso
Según la documentación, al 18-11-2026:
- Mercado Pago espera tu confirmación 22 segundos en el primer envío.
- Sin respuesta 200 o 201, reintenta a los 15 minutos, 30 minutos, 6 horas, 48 horas y 96 horas.
Por eso el mismo aviso puede llegar más de una vez. Tu función debe dar el mismo resultado si lo procesa dos veces.
21
Los estados de un pedido
Un pago puede quedar en revisión antes de aprobarse. Muestra «estamos confirmando tu pago» y deja que la pantalla se actualice sola, con tiempo real (módulo 7, clase 7) o volviendo a consultar.
22
Probar sin dinero real
La documentación de Mercado Pago explica cómo probar con credenciales, cuentas y tarjetas de prueba. Sigue la versión vigente.
- Usa las credenciales de prueba en un proyecto Supabase de pruebas.
- Recorre: pago aprobado, rechazado y abandonado.
- Envía el mismo aviso dos veces y confirma que nada se duplica.
- Revisa los registros de tus Edge Functions.
23
Errores comunes
- Guardar el token de acceso dentro de la app.
- No validar la firma del webhook.
- No comparar el monto pagado con el total del pedido.
- Responder tarde al aviso y recibirlo repetido.
- Usar esta vía para vender un plan premium digital.
24
Lo que te llevas
- La pasarela externa es solo para bienes físicos y servicios fuera de la app.
- El servidor calcula el total y crea el cobro; la app solo abre la URL.
- El pedido se marca pagado únicamente al recibir y verificar el aviso.
- El aviso se valida por firma y se confirma consultando el pago.
- Los avisos se repiten: tu función debe tolerarlo.
25
Hazlo ahora
En 10 minutos, sin escribir código:
- Dibuja el recorrido de un pedido de tu app con las seis etapas de esta clase.
- Escribe los estados posibles del pedido y qué ve el usuario en cada uno.
- Marca qué datos jamás deben venir desde la app.
Luego abre la página de costos de Mercado Pago Chile y anota la comisión que aplicaría a tu venta típica.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Mercado Pago Developers Chile: documentaciónmercadopago.cl ↗
- Mercado Pago Developers: notificaciones por webhooksmercadopago.cl ↗
- Mercado Pago Chile: costos por recibir pagosmercadopago.cl ↗
- App Review Guidelines (Apple), sección 3.1.3developer.apple.com ↗
- Política de pagos de Google Playsupport.google.com ↗
- Supabase: Edge Functionssupabase.com ↗