Cómo Integrar Pabilo en Tu Plataforma

Pabilo ofrece tres vías de integración para adaptarse a cualquier stack tecnológico: el SDK oficial para Node.js/TypeScript, la API REST directa y el plugin de WooCommerce para tiendas WordPress. En todos los casos, el proceso parte de los mismos tres pasos previos.

Crear cuenta

Regístrate en pabilo.app y activa tu plan.

Obtener API Key

En Configuración → API Keys, genera tu clave.

Conectar cuenta

En Cuentas Bancarias, vincula tu banco.

Opción A — SDK oficial npm (`@pabilo/sdk`)

La forma más rápida si usas Node.js, Next.js o cualquier runtime moderno de JavaScript. El SDK tiene cero dependencias, tipos TypeScript completos y soporte ESM/CommonJS.

npm install @pabilo/sdk

Instancia el cliente con tu API Key y verifica un pago:

import { PabiloClient } from '@pabilo/sdk';

const pabilo = new PabiloClient({ apiKey: process.env.PABILO_API_KEY });

const result = await pabilo.payments.verify(userBankId, {
  amount: 4000,
  bankReference: '12345678',
  movementType: 'MOVIL_PAY',
});

if (result.found && result.isNew) {
  // Pago válido y nunca visto antes → despachar orden
  console.log('Pago verificado:', result.data.user_bank_payment?.amount);
} else if (!result.found) {
  console.log('Motivo:', result.reason); // 'PAYMENT_NOT_FOUND' | 'BANK_NOT_AVAILABLE' | 'SESSION_ALREADY_ACTIVE'
}

Tip: Usa result.isNew para evitar procesar el mismo pago dos veces. Si isNew === false, el pago ya fue verificado en una orden anterior.

Opción B — API REST directa

Si trabajas con PHP, Python, Go u otro lenguaje, puedes consumir la API directamente con cualquier cliente HTTP. El endpoint de verificación es:

POST https://api.pabilo.app/userbankpayment/{userBankId}/betaserio
Header: appKey: TU_API_KEY

Ejemplo con cURL:

curl -X POST https://api.pabilo.app/userbankpayment/BANK_ID/betaserio \
  -H "Content-Type: application/json" \
  -H "appKey: TU_API_KEY" \
  -d '{
    "bank_reference": "12345678",
    "amount": 4000,
    "movement_type": "MOVIL_PAY"
  }'

La respuesta incluye is_new (boolean), los datos del pago y el costo en créditos. Consulta la documentación completa de Verificar Pagos para ver todos los campos disponibles según banco.

Opción C — Plugin WooCommerce (WordPress)

Pabilo Payment Gateway for WooCommerce

Sin código. Instala el plugin desde WordPress.org, ingresa tu API Key y selecciona la cuenta bancaria receptora. El plugin genera un enlace de pago por cada orden y verifica el pago automáticamente vía webhooks.

Ver guía de instalación completa →

Webhooks — Notificaciones en tiempo real

Cuando un enlace de pago es pagado, Pabilo envía un POST a la URL que configures. Ejemplo con Next.js App Router:

// app/api/webhook/pabilo/route.ts
import type { PaymentLinkWebhookPayload } from '@pabilo/sdk';

export async function POST(req: Request) {
  const payload: PaymentLinkWebhookPayload = await req.json();

  if (payload.status === 'paid') {
    const ref = payload.user_bank_payment?.bank_reference_id;
    // actualizar tu base de datos, despachar orden, enviar email...
  }

  return Response.json({ ok: true });
}

Lee la guía completa de webhooks para ver todos los eventos disponibles y cómo probarlos en desarrollo.

¿Listo para integrar?

Crea tu cuenta, genera una API Key y empieza a verificar pagos en minutos.

Crear Mi Cuenta Ver Documentación