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

# TypeScript / Node.js

> SDK oficial de VenePagos para entornos JavaScript y TypeScript.

### Instalación

Instala el paquete usando npm o yarn:

```bash theme={null}
npm install @venepagos/sdk
```

### Uso básico

```typescript theme={null}
import { VenePagos } from '@venepagos/sdk';

const client = new VenePagos({
  apiKey: 'vp_live_xxxxxxxx',
  environment: 'live' // 'live' o 'test'
});

async function run() {
  try {
    // Obtener información del usuario actual
    const me = await client.auth.getMe();
    console.log(`Hola, ${me.name}`);

    // Consultar tasas del BCV
    const rates = await client.bank.getRates();
    console.log('Tasas actuales:', rates);
  } catch (error) {
    console.error('Error:', error.message);
  }
}

run();
```

### Funciones principales

* `client.auth`: Registro, login, gestión de perfil.
* `client.merchants`: Gestión de comercios y miembros.
* `client.bank`: Cuentas, transferencias y pagos móviles.
* `client.notifications`: Suscripción a notificaciones push.

### Sandbox

Para usar el entorno de pruebas, inicializa el cliente con `environment: 'test'` y usa una API key con prefijo `vp_test_`.