Introduction
Learn what Nova.Pay is and how its core concepts fit together.
Authentication
Get your API key and start making authenticated requests.
Create a Payment
Step-by-step guide to processing your first payment.
API Reference
Full reference for all Nova.Pay endpoints and schemas.
How it works
Nova.Pay exposes a REST API athttps://pay.nova.money/api/v1. Most checkout operations are public (host-restricted) while management endpoints require a Bearer API key.
1
Get your API key
Obtain your
client_api_key from the Nova.Pay dashboard and note the allowed hosts configured for your account.2
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.3
Fetch payment plans
Call
GET /payment_plans to retrieve the installment options available for your context (coupon, amount, or checkout page).4
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.Supported payment methods
Credit Card
Single card or two-card split payments with installment support.
Pix
Instant QR code payments with expiry tracking.
Bank Slip
Boleto bancário with a printable URL.