Skip to main content
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

Checkout Pages

Host a fully managed, conversion-optimized checkout page with no front-end work required. Just redirect your customer to the URL.

Build a Checkout with AI

Install the Nova.Pay Checkout Skill and prompt an AI coding agent to create a branded, self-hosted checkout connected to Nova.Pay.

Cart-Based Checkout

Pass a structured cart payload to the API and let Nova.Pay render the checkout experience, handling pricing, taxes, and payment collection.

Charge Links

Generate shareable payment links for one-off charges, invoices, or donations — no checkout session required.

Payment Methods

Accept credit cards, Pix instant transfers, and boleto bancário (bank slip) out of the box with a single integration.

Orders & Subscriptions

Create and track orders, manage recurring billing cycles, and query payment history through a unified Orders API.

Webhooks

Receive real-time event notifications for payment status changes, order updates, and subscription lifecycle events.

​
Base URL

All API requests are made over HTTPS. Nova.Pay provides separate base URLs for production and staging environments.
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 page for full details, including webhook Basic Auth credentials.

​
Quick Navigation

Authentication

Learn how to authenticate requests with Bearer API keys, host restrictions, and webhook Basic Auth.

Checkout Flow

Understand the end-to-end checkout lifecycle from session creation to payment confirmation.

Payment Methods

Explore the supported payment methods — credit card, Pix, and boleto — and their specific parameters.

Create a Payment

Follow a step-by-step guide to creating your first payment with Nova.Pay.

Related topics

Orders API — List, Retrieve, Create, and Manage OrdersOrder Lifecycle and Status Transitions in Nova.PayBuild a Custom Nova.Pay Checkout with AICarts API — Create, Retrieve, and Pay Nova.Pay CartsPayments API — Create Payments and Issue Refunds