> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venepagos.com.ve/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Referencia completa de la API de VenePagos

## 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:

```bash theme={null}
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_`

<Card title="Guía de autenticación" icon="key" href="/autenticacion">
  Aprende más sobre el flujo de autenticación completo.
</Card>

## Formato de respuestas

Todas las respuestas son JSON. Las respuestas exitosas retornan el recurso directamente:

```json theme={null}
{
  "id": "mch_abc123",
  "name": "Mi Tienda",
  "status": "ACTIVE"
}
```

Los errores siguen un formato consistente:

```json theme={null}
{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Descripción del error",
    "status": 400
  }
}
```

## Paginación

Los endpoints que retornan listas soportan paginación:

| Parámetro     | Default  | Descripción          |
| ------------- | -------- | -------------------- |
| `page`        | `1`      | Número de página     |
| `limit`       | `50`     | Elementos por página |
| `search`      | -        | Búsqueda por texto   |
| `status`      | -        | Filtrar por estado   |
| `environment` | `"live"` | `"live"` o `"test"`  |

## Entornos

| Entorno        | API Keys    | Transacciones |
| -------------- | ----------- | ------------- |
| **Producción** | `vp_live_*` | Reales        |
| **Sandbox**    | `vp_test_*` | Simuladas     |

## Endpoints disponibles

<CardGroup cols={2}>
  <Card title="Autenticación" icon="lock" href="/api-reference/auth/register">
    Registro, login, tokens y verificación de cuenta.
  </Card>

  <Card title="Merchants" icon="store" href="/api-reference/merchants/list">
    Gestión de comercios, miembros y tiendas.
  </Card>

  <Card title="Operaciones bancarias" icon="building-columns" href="/api-reference/bank/accounts">
    Cuentas, transferencias, pagos móviles y tasas.
  </Card>

  <Card title="API Keys" icon="key" href="/api-reference/api-keys/list">
    Crear y gestionar API keys.
  </Card>

  <Card title="Notificaciones" icon="bell" href="/api-reference/notifications/list">
    Gestión de notificaciones push.
  </Card>

  <Card title="Admin" icon="shield" href="/api-reference/admin/dashboard">
    Endpoints administrativos de la plataforma.
  </Card>
</CardGroup>