# pagolink

> pagolink es la infraestructura de pagos de Venezuela, un producto de SOFTBIZ. Con una sola integración, un comercio o plataforma cobra pagos únicos y recurrentes con los métodos de pago del país, sin construir cada conexión por separado. El dinero llega directo a la cuenta bancaria del comercio: pagolink no custodia fondos. Tagline: "Todos los métodos. Una integración."

## Qué es

pagolink es la plataforma de pagos de Venezuela para pagos únicos y recurrentes. Cubre cobros puntuales (un pedido, una venta por WhatsApp o Instagram, un pago en mostrador) y suscripciones que se cobran cada ciclo. Un solo flujo reúne los métodos del país: Pago Móvil, C2P, Débito Inmediato, transferencia, domiciliación, Binance Pay y cobro manual.

Pago Móvil, C2P, Débito Inmediato y transferencia se verifican contra el banco. Hoy la operación es Venezuela.

Diferenciador central: **una integración = todos los métodos del país.**

## Pagos únicos y recurrentes

- Pagos únicos: link de cobro, QR, terminal en el teléfono, API y SDK, y checkout con la marca del comercio.
- Cobros recurrentes: suscripciones con domiciliación, cobros programados sobre la misma autorización y cobro por uso.

## Métodos

- Pago Móvil (bolívares, instantáneo, verificado contra el banco)
- C2P (verificado contra el banco)
- Débito Inmediato (verificado contra el banco)
- Transferencia (bolívares, verificada contra el banco)
- Domiciliación (cobros recurrentes; ver Bancos)
- Binance Pay (USDT)
- Cobro manual (Zelle, Zinli, efectivo u otro método del comercio; el comercio confirma el cobro)

Todos con una misma integración, en bolívares o dólares.

## Cobros recurrentes y suscripciones

- Domiciliación: el cliente autoriza una sola vez y aprueba en la app de su banco. Después, el cargo sale solo de su cuenta en cada ciclo: semanal, quincenal, mensual, trimestral, semestral o anual.
- Avisos antes de cada cargo.
- Reintentos automáticos si un cargo no pasa. Si tras varios intentos sigue sin pagar, la suscripción queda en mora.
- Enlace de contingencia: si el cargo automático no pasa, el cliente paga ese cobro por link con cualquier método (Pago Móvil, transferencia, C2P, Binance Pay). Sirve también al cliente cuyo banco aún no tiene domiciliación.
- Cancelación automática de la suscripción tras 14 días en mora.
- Planes en dólares cobrados en bolívares a la tasa BCV del día del cobro.
- Cupones y descuentos por tiempo limitado o para siempre.

## Cobros programados

Cobros puntuales sobre la misma autorización de domiciliación, por ejemplo una cuota extra o un consumo. Se programan con fecha y tienen reintentos.

## Cobro por uso

Medidores de consumo. El precio puede ser por unidad, por tramos o por volumen, más un cargo fijo.

## Facturación

Factura fiscal digital al cobrar.

## Formas de cobrar

- Link de cobro: se manda por WhatsApp o Instagram, y el cliente paga desde su banco. Sirve para vender sin tienda.
- QR: impreso o en pantalla en el mostrador. El cliente lo escanea y el comercio recibe la confirmación.
- Terminal en el teléfono: se marca el monto y se le muestra el cobro al cliente. Sin punto de venta alquilado ni cable.
- API y SDK: el cobro sale del sistema del comercio y la factura se cierra cuando el pago entra.
- Checkout con tu marca: logo, nombre y color del comercio, en claro u oscuro.

## Para quién es

- Cobros recurrentes: gimnasios, colegios y academias, software por suscripción, seguros, servicios mensuales y financiamiento propio en cuotas.
- Cobros únicos: tiendas en línea, venta por Instagram y WhatsApp, mostrador y servicios.

## Integración (API / SDK)

Flujo en tres pasos:
1. Crear una sesión de pago desde tu backend contra la API (base: api.pagolink.co/v1), con tu API key secreta.
2. Abrir el cobro en el navegador con el SDK: `PagoLink(pk).charge({ sessionId })` — o renderizar un botón de pago ya diseñado con la marca pagolink: `PagoLink(pk).mountButton('#pagar', { sessionId })`.
3. Recibir la confirmación por callback (`onSuccess`). Confirma siempre el estado final del lado del servidor.

El SDK se carga desde `https://cdn.pagolink.co/v1/pagolink.iife.js` (global `window.PagoLink`). Un solo SDK cubre todos los métodos y trae un botón de pago de marca listo para usar (`mountButton`). No requiere manejar cuentas bancarias ni reconciliación manual.

Cada cobro trae un `number` legible para el cliente («Cobro 2381-0293»), único por comercio; el id estable para integraciones sigue siendo `id` / `sessionId`.

Además: webhooks firmados, entorno de pruebas con claves separadas de producción, llaves de idempotencia y errores con código.

Ejemplo:

    // 1. backend: crear sesión
    const { sessionId } = await pagolink.sessions.create({
      amount: 1250.00, currency: 'VES'
    });

    // 2. navegador: abrir el cobro
    const pl = PagoLink('pk_live_…');
    pl.charge({ sessionId, onSuccess: (r) => console.log(r.reference) });

Datos del cliente (opcional): al crear la sesión puedes mandar `customer` con `name`, `taxId` (cédula o RIF), `email`, `phone` y `address`, todos opcionales. El checkout los prellena, el pagador puede cambiarlos, y llegan a la factura digital y al webhook `payment.completed`. Un valor inválido da `400` con `code: "PAYER_FIELD_INVALID"` y `field: "customer.<campo>"`.

Tasa / conversión a VES (opcional) en cada sesión de cobro: pasa la tasa al crear la sesión con `exchangeRate` (Bs por unidad de la moneda base, ej. "40.5") o con `amounts` ({ "VES": 400 }, tiene precedencia). El checkout muestra el monto en Bs y "Tasa X Bs/USD". La tasa la define tu backend en cada sesión.

## Bancos

- Pagos únicos con Pago Móvil, transferencia, C2P o débito inmediato: te pagan desde cualquier banco venezolano, desde la app que ya usan.
- Domiciliación (cobros recurrentes): depende de que el banco del pagador la acepte.
- El dinero entra directo a la cuenta de cobro del comercio, a su nombre.

## Guías

- [Cómo cobrar por API en Venezuela](https://pagolink.co/cobrar-por-api-en-venezuela.html)
- [Pasarela de pago en Venezuela](https://pagolink.co/pasarela-de-pago-venezuela.html)
- [API de Pago Móvil](https://pagolink.co/pago-movil-api.html)
- [Cobro C2P por API](https://pagolink.co/c2p-api.html)
- [Débito inmediato por API](https://pagolink.co/debito-inmediato-api.html)
- [Domiciliación bancaria en Venezuela](https://pagolink.co/domiciliacion-venezuela.html)
- [Link de pago en Venezuela](https://pagolink.co/link-de-pago-venezuela.html)
- [Botón de pago para tu web](https://pagolink.co/boton-de-pago-venezuela.html)
- [Cómo verificar un Pago Móvil sin revisar el banco](https://pagolink.co/verificar-pago-movil.html)
- [Cómo cobrar en dólares en Venezuela](https://pagolink.co/cobrar-en-dolares-venezuela.html)
- [Cómo cobrar suscripciones en Venezuela](https://pagolink.co/suscripciones-venezuela.html)
- [Cobrar con QR en Venezuela](https://pagolink.co/cobrar-con-qr-venezuela.html)

## Dominios

- Sitio: https://pagolink.co/
- Consola: https://app.pagolink.co
- Checkout: https://pay.pagolink.co
- Terminal POS: https://pos.pagolink.co
- Docs: https://docs.pagolink.co
- API: https://api.pagolink.co/v1

## Enlaces

- [Documentación](https://docs.pagolink.co)
- [Referencia técnica completa para LLM](https://docs.pagolink.co/llms.txt)
- [Consola](https://app.pagolink.co)
- [Checkout](https://pay.pagolink.co)
- [Terminal POS](https://pos.pagolink.co)