API REST

Crea links de pago programáticamente desde tu backend.

Autenticación

Todas las llamadas requieren el header:

Authorization: Bearer {api_key}:{api_secret}

Obtén tu api_key y api_secret en comercios.wepago.com → API.

Crear link de pago

POST https://merchant.api.wepago.com/merchants/subscription-link

Body:

{
  "customer": {
    "phone": "+573001234567",
    "email": "juan@ejemplo.com",
    "firstName": "Juan",
    "lastName": "Pérez"
  },
  "plan": {
    "externalReference": "tu-referencia-interna",
    "description": "Nombre del plan o producto",
    "amount": 49900,
    "modality": "RECURRING"
  }
}

Campo	Tipo	Requerido	Descripción
customer.phone	string	✅	Teléfono con código de país (+57...)
customer.email	string	✅	Email del cliente
customer.firstName	string	—	Pre-llena el formulario
customer.lastName	string	—	Pre-llena el formulario
plan.externalReference	string	✅	Tu referencia interna (ID de orden, etc.)
plan.description	string	✅	Nombre visible del plan en el checkout
plan.amount	number	✅	Monto en centavos de COP (49900 = $499)
plan.modality	string	—	RECURRING (default) o SINGLE

Respuesta 200:

{
  "token": "V1StGXR8Z5",
  "url": "https://checkout.wepago.com/pay/V1StGXR8Z5",
  "expiresAt": "2026-04-08T12:00:00.000Z"
}

Redirige al usuario a url o úsala con WepagoPay.open({ token }).

Resolver sesión de pago (lectura)

GET https://merchant.api.wepago.com/checkout/session/{token}

Retorna los datos de la sesión sin autenticación (solo el token es el secreto).