LPP — Latam Payment Protocol

El flujo

Tres pasos para pagar
a cualquier lugar en Latam

1

Identidad `latam://`

Registra tu handle universal: latam://nombre@pa. Un nombre, todas las redes. Tu handle resuelve a la dirección blockchain que elijas.

POST /lpp/identity/register

→

2

Crear el pago

Un solo endpoint POST /lpp/pay con receiver, monto y moneda. El protocolo resuelve la red óptima y retorna la dirección de destino + QR.

POST /lpp/pay

3

Liquidación y confirmación

El pagador envía USDT (TRC-20 o ERC-20). El protocolo confirma el estado con GET /lpp/pay/:id. Transacciones pendientes expiran automáticamente a los 30 minutos. Webhooks notifican a tu sistema en tiempo real.

status: "confirmed"

tx_hash: 0x7a3f...

Sistema de identidad

Un handle. Todas las redes.

Los handles latam:// son la capa de identidad del protocolo. Abstracten la complejidad de direcciones blockchain detrás de un nombre humano y geolocalizado.

Anatomía de un handle

latam://carlos@pa

latam:// Esquema del protocolo LPP. Identifica una entidad de pago.

carlos Nombre de usuario. Alfanumérico, 1–64 chars. Ej: tienda, empresa, dev.

pa Código ISO del país (2 letras). Soportados: PA, MX, CO, AR, CL, PE + 18 más.

Países soportados

PA MX CO AR CL PE EC VE BO PY UY CR GT HN SV NI DO CU HT PR BR GY SR

23 países · Cobertura total de América Latina y el Caribe

Código

Integra en minutos

REST API sin dependencias. Funciona desde cualquier backend o frontend.

POST /lpp/identity/register

        // 1. Registrar identidad latam:// con dirección blockchain
const res = await fetch('https://lpp-gateway.aalvarez351.workers.dev/lpp/identity/register', {
  method:  'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-LPP-Key':    'lpp_TU_API_KEY'
  },
  body: JSON.stringify({
    handle:       'latam://carlos@pa',  // tu handle universal
    address:      'TVjSFjihgn4D223E4xJmAxqNkywYRRxY4N',
    network:      'tron',               // tron | polygon | stellar | bnb
    display_name: 'Carlos López',
    type:         'user'
  })
})

const { handle, resolve_url, network } = await res.json()
// → handle: "carlos@pa", status: 201
      

POST /lpp/pay

        // 2. Crear solicitud de pago
const pago = await fetch('https://lpp-gateway.aalvarez351.workers.dev/lpp/pay', {
  method:  'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-LPP-Key':    'lpp_TU_API_KEY'
  },
  body: JSON.stringify({
    receiver:       'latam://tienda@co',   // destino
    amount:         50.00,
    quote_currency: 'USD',
    network:        'tron',               // opcional — se resuelve automáticamente
    description:    'Pedido #1042',
    sender:         'latam://carlos@pa',   // opcional
  })
}).then(r => r.json())

// Respuesta:
// {
//   payment_id:       "3f98f88f-31e0-401b-a237-4b65ca7375db",
//   status:           "pending",
//   receiver_address: "TVjSFjihgn4D223E4xJmAxqNkywYRRxY4N",
//   amount:           50.00,
//   expires_at:       "2026-03-20T12:30:00.000Z"
// }
      

GET /lpp/pay/:id

        // 3. Polling de estado (hasta confirmar)
async function pollPago(paymentId, apiKey) {
  while (true) {
    const data = await fetch(
      `https://lpp-gateway.aalvarez351.workers.dev/lpp/pay/${paymentId}`,
      { headers: { 'X-LPP-Key': apiKey } }
    ).then(r => r.json())

    if (data.status === 'confirmed') {
      console.log('Pago confirmado', data.tx_hash)
      break
    }
    if (data.status === 'expired' || data.status === 'failed') {
      console.log('Pago fallido:', data.status)
      break
    }

    await new Promise(r => setTimeout(r, 15000)) // poll c/15s
  }
}

await pollPago('3f98f88f-31e0-...', 'lpp_TU_API_KEY')
      

POST /lpp/merchant/register

        // Registrar merchant para recibir pagos
const merchant = await fetch('https://lpp-gateway.aalvarez351.workers.dev/lpp/merchant/register', {
  method:  'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-LPP-Key':    'lpp_TU_API_KEY'
  },
  body: JSON.stringify({
    name:        'Tienda Online SAS',
    email:       'pagos@tienda.co',
    country:     'CO',
    handle:      'latam://tienda@co',
    address:     'TVjSFjihgn4D223E4xJmAxqNkywYRRxY4N',
    network:     'tron',
    webhook_url: 'https://tienda.co/webhooks/lpp',
  })
}).then(r => r.json())

// → merchant_id, webhook_secret, handle confirmado
      

Referencia de endpoints

POST /lpp/pay Crear solicitud de pago

GET /lpp/pay/:id Verificar estado del pago

POST /lpp/identity/register Registrar handle latam://

GET /lpp/identity/:handle Resolver handle → wallet

POST /lpp/merchant/register Registrar merchant

GET /lpp/stats Estadísticas públicas del protocolo

GET /health Estado operacional del worker

Por qué LPP

Infraestructura diseñada
para Latam

⚡

Liquidación en <2min

USDT TRC-20 en Tron confirma en ~60 segundos. Sin días hábiles. Domingo a las 3am — funciona igual.

🔐

Verificación HMAC

Cada transacción puede llevar una firma HMAC-SHA256 usando tu API key como secreto. Previene pagos falsificados.

🗺️

Routing inteligente

Tabla de rutas configurable: define la red preferida para cada corredor país-a-país. PA→CO usa Tron, AR→CO usa Polygon.

🏪

Merchants integrados

Registra tu tienda una vez. Recibe webhooks firmados en cada pago. Compatible con e-commerce, SaaS y servicios digitales.

📊

Audit log inmutable

Cada operación queda registrada en el audit log de D1. Trazabilidad completa: quién creó qué, cuándo y desde dónde.

☁️

100% Cloudflare Edge

Workers + KV + D1. Sin servidores que administrar. 300+ PoPs globales. SLA de Cloudflare incluido.

Planes

Escala sin sorpresas

Paga con USDT. Sin tarjeta. Sin comisiones de pasarela.

Free

$0

Para siempre

✓ 1,000 transacciones/día
✓ Identidades latam://
✓ Todos los países Latam
✓ Tron + Polygon + Stellar
✓ API REST completa
– Webhooks
– SLA

Comenzar gratis

Popular

Builder

$29

USDT / mes

✓ 100,000 transacciones/día
✓ Todo lo del plan Free
✓ Webhooks firmados
✓ Routing personalizado
✓ Audit log exportable
✓ Soporte prioritario
– SLA garantizado

Contratar por WhatsApp

Enterprise

$199

USDT / mes

✓ Ilimitado
✓ Todo lo del plan Builder
✓ SLA 99.9% garantizado
✓ Dominio personalizado
✓ Soporte dedicado 24/7
✓ Onboarding técnico
✓ Facturación personalizada

Hablar con ventas

Pago en USDT TRC-20 o ERC-20. Sin tarjetas. Sin comisiones de pasarela. Sin renovación automática.

Tu primer pago Latam
en menos de 10 minutos

Registra tu handle latam://, obtén tu API key gratis y envía tu primer pago transfronterizo sin intermediarios.

Comenzar por WhatsApp →

+507 6298 2064 · Sin formularios. Respuesta inmediata.

El protocolo de pagospara América Latina

Tres pasos para pagara cualquier lugar en Latam

Identidad latam://