Primeros pasos

Crea tu cuenta, conecta Wompi, genera una API key y haz tu primera petición en sandbox.

1. Crea tu cuenta y conecta Wompi

Crea tu cuenta en el panel de Paygumi y registra los datos de tu empresa.
En Configuración → Wompi, registra las llaves de tu cuenta de Wompi para cada entorno que vayas a usar: llave pública, llave privada, secreto de integridad y secreto de eventos. Empieza con las de sandbox de Wompi (pub_test_…, prv_test_…).
Copia en tu cuenta de Wompi la URL de eventos que te muestra el panel, para que Wompi le informe a Paygumi el resultado de cada transacción.

Los pagos se cobran en tu cuenta de Wompi y el dinero llega a ella directamente: Paygumi no es intermediario de fondos.

2. Sandbox y producción

Trabajas en los dos entornos a la vez, cada uno con sus propios datos. La API key elige el entorno de cada petición:

Prefijo de la API key	Entorno	Wompi
`pgm_test_…`	Sandbox	Sandbox de Wompi: tarjetas de prueba, sin dinero real
`pgm_live_…`	Producción	Producción de Wompi: cobros reales

Los planes, clientes, suscripciones, cobros, endpoints de webhook y eventos de un entorno nunca se ven desde el otro. Un id de sandbox consultado con una llave de producción responde 404.

En Configuración → API keys crea una llave del entorno que necesites. Se muestra una sola vez: guárdala en el gestor de secretos de tu backend. Paygumi solo conserva su hash, así que si la pierdes, revócala y crea otra.

La API key va solo en tu backend. Nunca la pongas en una app móvil, en el navegador ni en un repositorio.

4. Tu primera petición

Todas las peticiones van a https://api.paygumi.com con la llave en la cabecera Authorization:

curl "https://api.paygumi.com/v1/plans?status=ACTIVE" \
  -H "Authorization: Bearer pgm_test_..."

Respuesta (recortada; los campos completos están en la referencia de planes):

{
  "data": [
    {
      "id": "pln_01JB86R800ABCDEFGHJKMNPQRS",
      "name": "Pro",
      "amount_in_cents": 4990000,
      "currency": "COP",
      "status": "ACTIVE"
    }
  ],
  "has_more": false
}

Los montos siempre van en centavos enteros: 4990000 son $ 49.900 COP. No uses decimales ni números de punto flotante para montos.

5. Configura un endpoint de webhook

En Webhooks → Endpoints registra la URL https de tu backend que recibirá los eventos y elige a qué tipos suscribirla (o * para todos). Copia su secreto (whsec_…) para verificar la firma. Puedes tener hasta 5 endpoints por entorno y enviar un ping de prueba desde el panel.

6. Antes de pasar a producción