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

# Nova.Pay API: Payments, Checkout & Order Management

> Nova.Pay is a REST API for checkout, payments, and order management. Accept credit cards, Pix, and bank slips from a single integration.

Nova.Pay is a REST API that lets you embed checkout, collect payments, and manage orders — all from a single integration. Whether you're building a custom storefront, a subscription platform, or a one-click charge flow, Nova.Pay provides the primitives you need to accept credit cards, Pix, and boleto (bank slip) payments from customers in Brazil and beyond.

## Key Capabilities

<CardGroup cols={2}>
  <Card title="Checkout Pages" icon="browser" href="/concepts/checkout-flow">
    Host a fully managed, conversion-optimized checkout page with no front-end work required. Just redirect your customer to the URL.
  </Card>

  <Card title="Build a Checkout with AI" icon="wand-magic-sparkles" href="/guides/ai-checkout-skill">
    Install the Nova.Pay Checkout Skill and prompt an AI coding agent to create a branded, self-hosted checkout connected to Nova.Pay.
  </Card>

  <Card title="Cart-Based Checkout" icon="cart-shopping" href="/concepts/checkout-flow">
    Pass a structured cart payload to the API and let Nova.Pay render the checkout experience, handling pricing, taxes, and payment collection.
  </Card>

  <Card title="Charge Links" icon="link" href="/guides/create-payment">
    Generate shareable payment links for one-off charges, invoices, or donations — no checkout session required.
  </Card>

  <Card title="Payment Methods" icon="credit-card" href="/concepts/payment-methods">
    Accept **credit cards**, **Pix** instant transfers, and **boleto bancário** (bank slip) out of the box with a single integration.
  </Card>

  <Card title="Orders & Subscriptions" icon="rotate" href="/guides/create-payment">
    Create and track orders, manage recurring billing cycles, and query payment history through a unified Orders API.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/authentication">
    Receive real-time event notifications for payment status changes, order updates, and subscription lifecycle events.
  </Card>
</CardGroup>

## Base URL

All API requests are made over HTTPS. Nova.Pay provides separate base URLs for production and staging environments.

<CodeGroup>
  ```text Production theme={null}
  https://pay.nova.money/api/v1
  ```

  ```text Staging theme={null}
  https://staging.pay.nova.money/api/v1
  ```
</CodeGroup>

Use the **staging** environment for development and testing. It mirrors production behavior but does not process real payments. Switch to the **production** URL when you are ready to go live.

## Authentication Modes

Nova.Pay uses two authentication models depending on the endpoint you are calling:

* **Host-restricted public endpoints** — Most checkout and payment endpoints do not require an API key. Instead, they validate the origin of the request against a list of `allowed_hosts` you configure for your account. Requests originating from `*.pay.nova.money` or `*.staging.pay.nova.money` are always permitted.
* **API key endpoints** — Administrative endpoints (such as listing orders or managing configurations) require a `Bearer` API key passed in the `Authorization` header. These endpoints are marked **Requires API key** throughout the reference docs.

See the [Authentication](/authentication) page for full details, including webhook Basic Auth credentials.

## Quick Navigation

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Learn how to authenticate requests with Bearer API keys, host restrictions, and webhook Basic Auth.
  </Card>

  <Card title="Checkout Flow" icon="arrow-right-arrow-left" href="/concepts/checkout-flow">
    Understand the end-to-end checkout lifecycle from session creation to payment confirmation.
  </Card>

  <Card title="Payment Methods" icon="wallet" href="/concepts/payment-methods">
    Explore the supported payment methods — credit card, Pix, and boleto — and their specific parameters.
  </Card>

  <Card title="Create a Payment" icon="circle-play" href="/guides/create-payment">
    Follow a step-by-step guide to creating your first payment with Nova.Pay.
  </Card>
</CardGroup>


## Related topics

- [Orders API — List, Retrieve, Create, and Manage Orders](/api-reference/orders.md)
- [Order Lifecycle and Status Transitions in Nova.Pay](/concepts/orders-lifecycle.md)
- [Build a Custom Nova.Pay Checkout with AI](/guides/ai-checkout-skill.md)
- [Carts API — Create, Retrieve, and Pay Nova.Pay Carts](/api-reference/carts.md)
- [Payments API — Create Payments and Issue Refunds](/api-reference/payments.md)