> ## 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: Payments, Checkout, Orders & Subscriptions API

> Nova.Pay is a flexible payment API for checkout, orders, and subscriptions. Accept credit cards, Pix, and bank slips with just a few API calls.

Nova.Pay gives you a complete set of APIs to accept payments, manage orders, and handle the full checkout lifecycle. Whether you're building a custom storefront, integrating a charge link, or automating subscription billing, Nova.Pay has you covered.

<CardGroup cols={2}>
  <Card title="Introduction" icon="book-open" href="/introduction">
    Learn what Nova.Pay is and how its core concepts fit together.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Get your API key and start making authenticated requests.
  </Card>

  <Card title="Create a Payment" icon="credit-card" href="/guides/create-payment">
    Step-by-step guide to processing your first payment.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/payments">
    Full reference for all Nova.Pay endpoints and schemas.
  </Card>
</CardGroup>

## How it works

Nova.Pay exposes a REST API at `https://pay.nova.money/api/v1`. Most checkout operations are public (host-restricted) while management endpoints require a Bearer API key.

<Steps>
  <Step title="Get your API key">
    Obtain your `client_api_key` from the Nova.Pay dashboard and note the allowed hosts configured for your account.
  </Step>

  <Step title="Browse checkout pages or create a cart">
    Fetch your published checkout pages via `GET /checkout_pages`, then either redirect customers to a hosted page or use `POST /carts/{id}` to create a programmatic cart.
  </Step>

  <Step title="Fetch payment plans">
    Call `GET /payment_plans` to retrieve the installment options available for your context (coupon, amount, or checkout page).
  </Step>

  <Step title="Submit the payment">
    Post payment details to `POST /payments` (or `POST /carts/{id}/pay` / `POST /charges/{id}/pay`) and handle the response — including Pix QR codes, boleto URLs, or credit card status.
  </Step>
</Steps>

## Supported payment methods

<CardGroup cols={3}>
  <Card title="Credit Card" icon="credit-card" href="/concepts/payment-methods">
    Single card or two-card split payments with installment support.
  </Card>

  <Card title="Pix" icon="qrcode" href="/concepts/payment-methods">
    Instant QR code payments with expiry tracking.
  </Card>

  <Card title="Bank Slip" icon="file-invoice" href="/concepts/payment-methods">
    Boleto bancário with a printable URL.
  </Card>
</CardGroup>


## Related topics

- [Nova.Pay API: Payments, Checkout & Order Management](/introduction.md)
- [Order Lifecycle and Status Transitions in Nova.Pay](/concepts/orders-lifecycle.md)
- [Payments API — Create Payments and Issue Refunds](/api-reference/payments.md)
- [Build a Custom Nova.Pay Checkout with AI](/guides/ai-checkout-skill.md)
- [Webhooks API — Handle Payment Gateway Event Callbacks](/api-reference/webhooks.md)