Top-ups and credits
Sell credits in packages or in an amount the user chooses, within limits you set. The number of credits to add arrives on your server in the webhook (the credits field).
Top-ups, subscriptions and one-time purchases. We act as the merchant of record: we take the payment, handle EU VAT and pay the money out to you.
Your server receives this after payment
{
"event": "order.paid",
"clientReference": "acc_10294",
"credits": 100,
"creditsUnit": "credits"
}Sell credits in packages or in an amount the user chooses, within limits you set. The number of credits to add arrives on your server in the webhook (the credits field).
Billing periods range from one day to one year. One request tells your server whether the user's access is paid and until what date.
Create a payment with one API call, send the user straight to the payment page and bring them back to your app.
For your agent
Your agent reads llms.txt, the index of the documentation, and follows the links. The prompt below gives it the task.
Prompt for an AI agent: copy it and paste it into Cursor or Claude Code
You are connecting my application to Norelio. Norelio is the merchant of record: it takes the payment and pays me out.
Start with the test key (it begins with nrl_test_) and switch to the live key when everything works.
1. Read https://docs.norelio.eu/llms.txt and the pages it links to. The OpenAPI document is https://docs.norelio.eu/openapi.json.
2. Ask me for the Norelio API key and the productId of each product. Keep the key on the server, in the environment variable NORELIO_API_KEY. Never put it in client code or logs.
3. When a user presses "Pay", create the payment from my server: POST https://app.norelio.eu/api/v1/checkouts with the header Authorization: Bearer <key> and the fields productId and clientReference (my id for that user). For a top-up product also send packageId or amount. Redirect the user's browser to the url in the response; it works once, so do not log it.
4. If the answer is 403 direct_checkout_not_enabled, stop and tell me: creating payments from my server has to be enabled for my account first.
5. Add a webhook endpoint and tell me its address: I save it in the Norelio cabinet. Verify the signature over the raw request body, deduplicate on eventId, and on order.paid credit the account named in clientReference (for a top-up, add the credits field). Handle refunds. For subscriptions, call the access check whenever the user comes back.
6. Tell me what you changed and how to test it with the test webhook from the Norelio cabinet.Node.js
app.post("/pay", async (req, res) => {
const response = await fetch("https://app.norelio.eu/api/v1/checkouts", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.NORELIO_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
productId: "prod_1a2b3c", clientReference: req.user.id
})
});
if (!response.ok) return res.sendStatus(502);
const { url } = await response.json();
res.redirect(url);
});Three steps
In the Norelio cabinet, add a one-time purchase, a subscription or a top-up.
Call the API with the product id and your user's id. Send the user to the payment URL you get back.
Norelio sends a signed order.paid webhook to your server. Verify the signature, then add the credits or open access.
Questions
Norelio. We act as the merchant of record: the contract with the buyer and the receipt are on Norelio's side, and Norelio handles refunds and disputes with banks. Your application never touches the buyer's payment data.
For card payments, buyers from the EU pay VAT on top of your price. Norelio calculates, collects and remits it. Business buyers from other EU countries with a valid VAT number are not charged VAT (reverse charge). Buyers outside the EU are not charged VAT.
You request a payout in the cabinet once the money from an order becomes available. You see payout amounts and history there too.
Register, take a test key and create your first payment, all without our involvement. The documentation is at docs.norelio.eu; you can give your AI agent the prompt above.