Referencia de API

Base URLs

Entorno	URL
Producción	https://merchant.api.wepago.com
Testing	https://merchant.testing-api.core.wepago.com

Endpoints

POST /merchants/subscription-link

Crea un link de pago. Ver integración API para detalles.

GET /merchants/subscription-plans/{id}

Obtiene un plan de suscripción por ID.

Parámetros: id — subscriptionPlanId

Respuesta: datos del plan (merchantId, userId, amount, status, etc.)

GET /checkout/session/{token}

Resuelve un token corto de checkout.

Parámetros: token — token de 10 chars generado por /merchants/subscription-link

Respuesta 200:

{
  "customer": { "phone": "+573001234567", "firstName": "Juan" },
  "planName": "Plan mensual",
  "amount": 49900,
  "currency": "COP",
  "merchantName": "Tienda XYZ",
  "merchantId": "...",
  "modality": "SUBSCRIPTION",
  "expiresAt": 1712534400000,
  "allowedDomains": ["tienda.com"]
}

Respuesta 400: token expirado
Respuesta 404: token no encontrado

Códigos de error

Código HTTP	Significado
400	Parámetros inválidos o sesión expirada
401	API key inválida o ausente
404	Recurso no encontrado
409	Conflicto (suscripción duplicada)
500	Error interno