> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payviox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Installation
> Install and set up the Payviox JavaScript SDK in your project
## Prerequisites
**Requirements**:
* Modern web browser with ES6 support
* API token from your Payviox dashboard
* Node.js 14+ (for npm installation)
## Installation methods
You can integrate the Payviox SDK using different methods depending on your project setup.
Include the SDK directly in your HTML file using a CDN link.
```html index.html theme={null}
Payviox Integration
```
Using the CDN is the fastest way to get started and automatically provides updates.
Install the SDK as a package in your Node.js project.
```bash theme={null}
npm install @payviox/sdk
```
Then import it in your JavaScript files:
```javascript app.js theme={null}
import Payviox from '@payviox/sdk';
const payviox = new Payviox('your_api_token');
```
Download the SDK file directly and include it in your project.
1. Download `payviox.js` from the [releases page](https://github.com/payviox/sdk/releases)
2. Place it in your project's `js` or `vendor` directory
3. Include it in your HTML:
```html theme={null}
```
## Get your API token
To use the SDK, you need an API token from your Payviox dashboard.
Navigate to [https://dash.payviox.com](https://dash.payviox.com) and sign in with your credentials.
Go to **Settings** > **API Keys** in the sidebar menu.
Click **Create new API key** or copy an existing key.
Use your **public key** (`pk_`) with the SDK — it's built to be exposed in the browser. Your **secret key** (`sk_`) must never appear in client-side code: keep it on your server. See [Authentication](/api/authentication).
## Initialize the SDK
Once installed, initialize the SDK with your API token:
```javascript Vanilla JavaScript theme={null}
const payviox = new Payviox('your_api_token');
// Verify that initialization is successful
console.log('Payviox SDK initialized');
```
```javascript ES6 Module theme={null}
import Payviox from '@payviox/sdk';
const payviox = new Payviox('your_api_token');
export default payviox;
```
```typescript TypeScript theme={null}
import Payviox from '@payviox/sdk';
const payviox: Payviox = new Payviox('your_api_token');
export default payviox;
```
## Verify installation
Test your installation by fetching available payment methods:
```javascript test.js theme={null}
const payviox = new Payviox('your_api_token');
// Test the API connection
payviox.getPaymentsMethods()
.then(methods => {
console.log('Available payment methods:', methods);
})
.catch(error => {
console.error('Installation error:', error);
});
```
If you see a list of payment methods in the console, your SDK is correctly installed and configured.
## Environment configuration
### Development vs Production
Use different API tokens for development and production environments:
```javascript config.js theme={null}
const PAYVIOX_TOKEN = process.env.NODE_ENV === 'production'
? 'pk_live_xxxxxxxxxxxxx'
: 'pk_test_xxxxxxxxxxxxx';
const payviox = new Payviox(PAYVIOX_TOKEN);
```
### Base URL configuration
The SDK automatically uses the correct base URLs:
* API endpoint: `https://api.payviox.com`
* Secure redirect: `https://secure.payviox.com`
These URLs are managed internally by the SDK and cannot be modified in standard configurations.
## Next steps
Create your first payment session
Implement redirect mode
Implement iframe mode
Explore all SDK methods