For AI app developers

Payments for AI apps

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"
}

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).

Subscriptions

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.

Payment from your server

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

Works with AI agents

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

Create a payment from your server

  • Pass the user's id in clientReference. It comes back in the webhook.
  • Redirect the user's browser to url. The address works once.
  • For a top-up, add packageId or amount.
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

How it works

  1. 1

    Create a product

    In the Norelio cabinet, add a one-time purchase, a subscription or a top-up.

  2. 2

    Create a payment on your server

    Call the API with the product id and your user's id. Send the user to the payment URL you get back.

  3. 3

    Receive the webhook

    Norelio sends a signed order.paid webhook to your server. Verify the signature, then add the credits or open access.

Questions

Short answers

Who is the seller for the buyer?

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.

How is VAT handled?

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.

How do payouts work?

You request a payout in the cabinet once the money from an order becomes available. You see payout amounts and history there too.

How do I get started?

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.