# 🧾 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](/venta/getting-started.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://venta.gitbook.io/venta/introduction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
