# 🧾 Introduction

VentaConnect is designed specifically for **POS providers**. With just a few API calls, you can allow your merchants to accept stablecoin payments at the point of sale — **without touching wallets, keys, or smart contracts.**

***

## 💡 What is VentaConnect?

VentaConnect is an API-first checkout layer that abstracts away all Web3 complexity and lets any POS system offer **stablecoin payments** as a seamless option.

Once integrated, your POS can:

* Initiate a payment session by specifying an amount and merchant ID.
* Get a **Solana Pay** transaction and **reference key**.
* Track transaction confirmation via **WebSocket** or **polling**.

Venta handles wallet generation, transaction creation, and the entire life-cycle of the transaction.

***

## 🧱 How it Works

Here’s a high-level flow:

1. **Partner Registration**\
   You onboard to Venta and receive an API key using a one-time beta code.
2. **Merchant Registration**\
   You register merchants via our API. We create non-custodial wallets for each merchant.
3. **Checkout Flow**\
   Your POS calls the `/session` endpoint with merchant ID and amount to get a reference key and websocket URL.
4. **Customer Pays**\
   A Solana Pay-compatible wallet scans the checkout QR code and pays.
5. **Confirmation**\
   Venta tracks the transaction in real-time and confirms when it is finalized on-chain.

***

## 🔗 Base URL

```
https://api.venta.xyz/v1
```

All endpoints in this documentation are prefixed with `/v1`.

***

## 👥 Who This Is For

This documentation is for **POS system developers** or **product teams** who want to:

* Let merchants accept **USDC** or other stablecoins.
* Abstract away the entire blockchain interaction layer.
* Avoid managing wallets, keys, and transaction validation.
* Provide customers with a fast, secure, and low-fee alternative to card payments.

***

## 🛠️ Key Features

* Web2-style API integration
* Secure API key authentication
* Merchant wallet and identity abstracted
* Real-time confirmation with WebSocket + polling fallback
* Easy key rotation and rate-limiting

***

## 🚀 Getting Started

To test VentaConnect:

1. Request a **beta code** from the Venta team.
2. Use the beta code to generate your API key.
3. Register a test merchant.
4. Use `/dev/checkout/session` to simulate a live payment.
5. View partner dashboard at `partner.venta.xyz/dashboard`

[See full setup guide → Getting Started](https://venta.gitbook.io/venta/getting-started)
