Appearance

Getting Started ​

Welcome to Vault4x! This guide will help you integrate our PCI DSS compliant tokenization service into your application.

Overview ​

Vault4x is a tokenization service that allows you to:

  1. Tokenize sensitive payment card data using our secure form or API
  2. Store tokens instead of sensitive data in your systems
  3. Process payments by proxying requests through our service to any PSP

This approach helps you reduce PCI DSS compliance scope while maintaining flexibility to use any Payment Service Provider.

Prerequisites ​

Before you begin, you'll need:

  • A valid Vault4x account at vault4x.com
  • An API key generated from your dashboard
  • Basic knowledge of JavaScript and REST APIs

Account Setup ​

1. Create Your Account ​

Visit vault4x.com and create your account. Once verified, you'll have access to the dashboard.

2. Generate API Key ​

  1. Log into your Vault4x dashboard
  2. Navigate to Settings → API Keys
  3. Click Generate New Key
  4. Copy and securely store your API key

Security Notice

We do not store API keys in our database. If you lose your API key, you must generate a new one and revoke the lost key immediately.

3. Configure IP Restrictions (Optional) ​

For additional security, you can restrict API key usage to specific IP addresses in your dashboard settings.

Sandbox Environment ​

Vault4x provides a dedicated sandbox environment for development and testing, allowing you to safely test your integration without processing real payments or handling live card data.

Sandbox Benefits ​

  • Safe Testing: No real money or live card data processed
  • Full Feature Set: All production features available for testing
  • Isolated Environment: Completely separate from production systems

Accessing the Sandbox ​

Sandbox Dashboard ​

Access the sandbox dashboard at: dashboard.vault4x.com

The sandbox environment is completely separate from production, requiring you to create a dedicated sandbox account and generate sandbox-specific API keys.

Important: You must create a separate account on the sandbox dashboard to generate sandbox API keys. Production API keys will not work in the sandbox environment.

Sandbox API Endpoints ​

Base URL:

All sandbox API requests use the same endpoints as production but with the sandbox base URL.

Sandbox SDK Configuration ​

Configure the JavaScript SDK to use the sandbox environment:

javascript
const vault4x = new Vault4x("sandbox_vk4x_your_sandbox_key");

The sandbox prefix will set the SDK in sandbox mode.

Integration Options ​

Vault4x offers two integration methods:

Use our secure JavaScript SDK to embed a PCI-compliant payment form in your website. This handles tokenization automatically and is the easiest way to get started.

Learn more about Form Integration →

API Integration ​

Directly call our REST API for tokenization and proxying. This requires your server to be PCI DSS compliant to handle raw card data.

Learn more about API Integration →

Next Steps ​

  1. Set up Authentication →
  2. Integrate the Payment Form →

Need help? Contact our support team