> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prava.space/llms.txt
> Use this file to discover all available pages before exploring further.

# Choosing Your Integration

> Three ways to build on Prava — and exactly when to use each.

Prava has **three** integration paths. (A **merchant** wanting to *sell to* AI shoppers doesn't
integrate at all; see [Agentic Commerce](https://docs.prava.space/integration/overview.md).) Which path you want comes down to
two questions:

1. **Who owns the interface**: an **AI agent**, or your own application?
2. If it's your application, **how do you want to present card entry**: inside your own UI, or hand off
   to a Prava-hosted page?

> [!NOTE]
>
> With Prava the payment itself is **always AI/agent-mediated**; what differs is *who owns the
> interface* and *where the card UI lives*. All three paths share the same secure core: the card is
> entered on Prava's surface and turned into one-time, scoped credentials.

## Decide in 10 seconds

```mermaid theme={null}
flowchart TD
    A{Who owns the<br/>interface?} -->|AI agent| AGENT[Agent<br/>Prava Pay]
    A -->|Your application| B{Card form in<br/>your own UI?}
    B -->|Yes| EMB[Embedded<br/>SDK + API]
    B -->|No| HOST[Hosted<br/>Full API]
```

**1. Is the interface owned by an AI agent?**

If the surface your user interacts with is an **AI agent platform** (OpenClaw, Hermes, ChatGPT;
[supported identifiers](https://docs.prava.space/prava-pay/linking.md)), connect Prava as that agent's payment capability:
via **[MCP](https://docs.prava.space/mcp/overview.md)** (Model Context Protocol: one URL, any MCP client) or the **[CLI](https://docs.prava.space/prava-pay/overview.md)**
(agents that run shell commands).

**2. Otherwise, do you want the card form in your own UI?**

You own an **AI application, or an app backed by a legal business entity**:

* **Yes**: keep the user on your page → **[Embedded (SDK + API)](https://docs.prava.space/sdk/integration-modes.md)**.
* **No**: minimal frontend, redirect out and back → **[Hosted (full API)](https://docs.prava.space/sdk/integration-modes.md#hosted-mode-default)**.

> [!NOTE]
>
> **The MCP connector is live.** Add `https://mcp.pay.prava.space/mcp` to AI apps like Hermes,
> ChatGPT, or OpenClaw and pay with no CLI at all. See [Prava MCP](https://docs.prava.space/mcp/overview.md).

## Compare the three

| | **Embedded** (SDK + API) | **Hosted** (full API) | **Agent** (Prava Pay) |
| - | - | - | - |
| **Who owns the interface** | Your AI application / business | Your AI application / business | An AI agent platform: OpenClaw, Hermes, ChatGPT |
| **Where the card is entered** | An iframe (embedded frame) **inside your page** | Prava-hosted page (redirect) | Prava-hosted page (the owner enters it) |
| **What you build** | Session (backend) + SDK wiring (frontend) | Session (backend) + a redirect & `callback_url` route | Nothing: connect via [MCP](https://docs.prava.space/mcp/connect.md) or run the `prava` CLI |
| **What Prava hosts** | The secure card iframe | The full checkout page | The full checkout + agent control plane |
| **Frontend footprint** | Small JS (`@prava-sdk/core`) | Almost none | None (MCP or CLI) |
| **How you get the result** | `onSuccess` callback, in-app | Redirect to your `callback_url` | CLI output / exit codes |
| **Best when** | You want a native-feeling checkout on your page | You want the fastest, lowest-maintenance integration | The interface is an AI agent that shops or pays |
| **Start here** | [SDK Overview](https://docs.prava.space/sdk/overview.md) | [API Reference](https://docs.prava.space/api-reference/overview.md) | [Prava Pay](https://docs.prava.space/prava-pay/overview.md) |

## Pick your path

> [card] [Embedded (SDK + API)](https://docs.prava.space/sdk/integration-modes.md)
>
> Card UI inside your own page. Use when you want checkout to feel native to your product.

> [card] [Hosted (Full API)](https://docs.prava.space/sdk/integration-modes.md#hosted-mode-default)
>
> Redirect to a Prava-hosted page. Use when you want to ship fast with minimal frontend code.

> [card] [Agent (Prava Pay)](https://docs.prava.space/prava-pay/overview.md)
>
> For **AI-agent-owned interfaces**. Connect via [MCP](https://docs.prava.space/mcp/overview.md) or the CLI.

> [!NOTE]
>
> Embedded and Hosted are two ways to use the **same session**; see
> [Integration Modes](https://docs.prava.space/sdk/integration-modes.md) for the mechanics. **Agent** (Prava Pay) is a separate
> product for AI-agent-owned interfaces; start at its [overview](https://docs.prava.space/prava-pay/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.