Mientras dudas, tus competidores ya están lanzando.

Minutos para integrar
Mercado Pago.
No semanas.

Copia un archivo en tu proyecto. Un comando en Claude. En cinco minutos tienes Pix, Boleto, OXXO, webhooks y validación de CPF funcionando — sin tocar la documentación de Mercado Pago.

Ahorra 2 semanas 4 países · 5 métodos de pago Next.js 15 listo para producción
🇧🇷 Pix — Instantáneo 🇧🇷 Boleto Bancário 🇲🇽 OXXO Cash 🇦🇷 Rapipago / Pagofácil 🇨🇴 Efecty / PSE 💳 Tarjetas de crédito 🔔 Webhooks asíncronos 🔐 Verificación HMAC 🪪 Validación CPF / CNPJ
🇧🇷 Pix — Instantáneo 🇧🇷 Boleto Bancário 🇲🇽 OXXO Cash 🇦🇷 Rapipago / Pagofácil 🇨🇴 Efecty / PSE 💳 Tarjetas de crédito 🔔 Webhooks asíncronos 🔐 Verificación HMAC 🪪 Validación CPF / CNPJ
💥 El problema

Mercado Pago no es Stripe.

Y nadie te lo dice hasta que llevas tres días leyendo docs y nada funciona.

Los pagos en efectivo no son inmediatos

OXXO y Boleto tardan hasta 3 días. Si los tratas como tarjeta, tus órdenes van a fallar silenciosamente.

🪪

Brasil exige CPF o CNPJ

Pix y Boleto fallan en el API sin documento fiscal válido. La documentación no te advierte hasta que ya fallaste.

📡

Los webhooks llegan días después

Un usuario paga en OXXO 2 días después de generar su voucher. Tu backend tiene que manejar ese delay.

✦ Product showcase

Un comando. Toda la integración.

El skill genera código listo para producción en backend, frontend y base de datos.

Claude Code — tu-proyecto/
webhook/route.ts — generado
// Re-consultar a MP — nunca confiar en el payload
const data = await mpPayment.get({ id });
const status = STATUS_MAP[data.status];
await db.payment.updateMany({
where: { orderId },
data: { status,
paidAt: status === "APPROVED"
? new Date() : undefined } });
🖥️ <LatamCheckout />
País seleccionado🇧🇷 Brasil
Método● Pix (instante)
CPF requeridovalidado ✓
QR CodeBase64 render
EstadoPENDING → APPROVED

Selector de método por país. Validación server-side. Render de QR Pix. Boleto PDF. Voucher OXXO. Polling automático.

⚡ Funcionalidades

Todo lo que necesitas.
Nada más.

Sin abstracciones. Código que entiendes y puedes modificar.

Pix recibido · Brasil
APPROVED
OXXO generado · México
PENDING
QR Pix renderizado
BASE64
Boleto pago · Brasil
APPROVED
OXXO confirmado · MX
APPROVED
Tarjeta aprobada · AR
APPROVED

Pagos que funcionan en LATAM

Pix, Boleto, OXXO y tarjeta — cada uno con su flujo correcto desde el primer día.

🏦
Mercado Pago envía evento
POST
🔐
Verificación HMAC x-signature
SHA-256
🔁
Re-consulta a MP (idempotente)
SAFE
Actualiza DB · dispara lógica
DONE

Webhooks seguros e idempotentes

Firma HMAC verificada. Re-consulta el estado real en MP. Seguro ante duplicados.

Next.js
🗄️
Prisma
🔷
TypeScript
💳
MP SDK
🤖
Claude
Zod

Stack moderno listo para producción

Next.js 15, Prisma, TypeScript y Zod. Sin dependencias raras.

data:image/png;base64,…
QR renderizado en <img src="data:…">

QR Pix renderizado correctamente

El error del 90%: MP devuelve Base64, no una URL. El skill lo sabe y lo hace bien.

CPF / CNPJ validado antes del API call
OXXO y Boleto inician en estado PENDING
Polling cada 3s con parada en estado terminal
Schema Prisma con QR, Boleto URL, OXXO ref
Modo sandbox · credenciales de prueba incluidas

Checklist de validación 9/9

Claude verifica cada regla crítica antes de entregar el código. Sin sorpresas en producción.

🪪
Documento requerido
CPF CNPJ
400 Bad Request
tax_id required for BR

CPF / CNPJ validado server-side

Brasil exige documento fiscal. Validado antes del API call — no después de fallar.

🇧🇷 Brasil
Pix Boleto Tarjeta
🇲🇽 México
OXXO Tarjeta
🇦🇷 Argentina
Tarjeta
🇨🇴 Colombia
Tarjeta
🧪
SANDBOX
Sin credenciales reales

4 países · 5 métodos de pago · modo sandbox incluido

Prueba todo sin credenciales reales. Cuando estés listo, cambia DEMO_MODE=false y conecta tu cuenta de Mercado Pago.

🚀 Casos de uso

Hecho para builders en LATAM.

Los usuarios no bancarizados en LATAM son millones que Stripe no alcanza.

🇧🇷
SaaS con usuarios en Brasil
Pix + Boleto Bancário

Brasil tiene +140M usuarios de Pix activos. Sin Pix, pierdes la mayoría de tus compradores. El skill genera el QR, el copy-paste code y el webhook de confirmación.

🇲🇽
Marketplace o app en México
OXXO Cash · 20.000 tiendas

+60% de México no tiene tarjeta de crédito. OXXO tiene 20.000 tiendas. El skill genera el voucher, maneja los 3 días de espera y confirma automáticamente.

🧑‍💻
Agencias y freelancers
Multi-país · Reutilizable

¿Construyes MVPs para clientes? Ahorra 2 semanas por proyecto. Un skill, múltiples proyectos. Justifica el cobro extra a tus clientes con tiempo real ahorrado.

🌎 Cobertura

País por país. Método por método.

País Instantáneo Efectivo (asíncrono) Campo requerido Manejado
🇧🇷 Brasil Pix Boleto (1–3 días) CPF / CNPJ obligatorio ✓ Sí
🇲🇽 México OXXO (hasta 3 días) RFC opcional ✓ Sí
🇦🇷 Argentina Rapipago / Pagofácil DNI ✓ Sí
🇨🇴 Colombia PSE Efecty NIT / CC ✓ Sí
✦ Por qué existe esto
"Pasé tres noches peleando con la API de Mercado Pago. El QR Pix devuelve Base64, no una URL. El CPF es obligatorio y no te lo dicen. Los webhooks de OXXO llegan dos días después. Nada de eso está en los docs."

Soy desarrollador en LATAM y estaba construyendo un proyecto propio. Tres noches seguidas leyendo docs en inglés, hablando con soporte, hasta que un amigo me pasó un snippet de Stack Overflow del 2019 que lo resolvió todo. Eso no tiene sentido.

Metí todo lo que aprendí en un archivo que Claude puede leer. La próxima vez que alguien tenga que integrar Mercado Pago, que le tome cinco minutos y no dos semanas.

🧑‍💻
Leonardo Clavijo
LATAM MVP
💳 Precio

Un solo pago. Todo incluido.

Sin suscripción. Sin sorpresas. El skill es tuyo para siempre.

latam-payments.md
$49
pago único · USD
⚡ más popular
Archivo latam-payments.md
Repositorio demo (Next.js 15 + Prisma + SQLite)
🇧🇷 Brasil · 🇲🇽 México · 🇦🇷 Argentina · 🇨🇴 Colombia
Pix · Boleto · OXXO · Tarjetas · Webhooks
Actualizaciones de por vida
Soporte por email
🚀  Comprar ahora — $49

Descarga inmediata · Pago seguro vía Gumroad

Un freelancer cobra $800–$2.000 para integrar Mercado Pago. Una agencia cobra $5.000+. Este skill se paga solo la primera vez.

❓ FAQ

Todo lo que necesitas saber.

¿Con qué stack funciona?
El skill genera Next.js 15 (App Router) con TypeScript, Prisma ORM y el SDK oficial de Mercado Pago para Node.js. Las rutas son Node.js estándar — Claude puede adaptarlas a Express o Fastify si le dices tu stack.
¿Necesito cuenta en Mercado Pago?
Sí — necesitas una cuenta de desarrollador gratuita para obtener API keys de sandbox. El demo repo incluye modo demo que funciona sin credenciales. Para pagos reales necesitas cuenta de comercio activa.
¿Funciona si no uso Prisma?
El skill usa Prisma por defecto, pero Claude puede adaptarlo a Drizzle, TypeORM o SQL puro. Solo díselo: "usa Drizzle en lugar de Prisma".
¿Qué pasa si me quedo atascado?
El skill incluye un checklist de 9 puntos que Claude ejecuta automáticamente. El demo repo es una referencia funcional completa. Si aun así tienes dudas, responde el correo de compra.
¿Se actualiza con nuevas versiones del SDK?
Sí. El skill se actualiza ante cambios del SDK de Mercado Pago o versiones mayores de Next.js. Todos los compradores reciben actualizaciones de por vida — Gumroad notifica automáticamente.
🎯 ¿Listo para lanzar?

Deja de leer docs.
Empieza a lanzar.

Tus competidores están gastando dos semanas en esto. Tú tienes mejores cosas que hacer.

Pago único · Descarga inmediata · Actualizaciones de por vida