Skip to main content

API de VenePagos

La API de VenePagos te permite integrar pagos, transferencias bancarias y gestión de comercios directamente en tu plataforma. Base URL:
https://api.venepagos.com.ve/api/v1

Autenticación

Todos los endpoints (excepto login y registro) requieren autenticación via Bearer token:
curl https://api.venepagos.com.ve/api/v1/merchants \
  -H "Authorization: Bearer TU_ACCESS_TOKEN"
Puedes usar:
  • Access Token (JWT) - Obtenido al hacer login, válido 24 horas
  • API Key - Creada desde la API, no expira. Prefijo vp_live_ o vp_test_

Guía de autenticación

Aprende más sobre el flujo de autenticación completo.

Formato de respuestas

Todas las respuestas son JSON. Las respuestas exitosas retornan el recurso directamente:
{
  "id": "mch_abc123",
  "name": "Mi Tienda",
  "status": "ACTIVE"
}
Los errores siguen un formato consistente:
{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Descripción del error",
    "status": 400
  }
}

Paginación

Los endpoints que retornan listas soportan paginación:
ParámetroDefaultDescripción
page1Número de página
limit50Elementos por página
search-Búsqueda por texto
status-Filtrar por estado
environment"live""live" o "test"

Entornos

EntornoAPI KeysTransacciones
Producciónvp_live_*Reales
Sandboxvp_test_*Simuladas

Endpoints disponibles

Autenticación

Registro, login, tokens y verificación de cuenta.

Merchants

Gestión de comercios, miembros y tiendas.

Operaciones bancarias

Cuentas, transferencias, pagos móviles y tasas.

API Keys

Crear y gestionar API keys.

Notificaciones

Gestión de notificaciones push.

Admin

Endpoints administrativos de la plataforma.