Octany. for/devs
§ 00 — Översikt

Bygg
med Octany.

Teknisk dokumentation för att integrera Octany — den svenska motorn för prenumerationer, engångsordrar och kassa. Mycket exempel, lite snack. Skriven för utvecklare och deras AI-agenter.

# Lista en kunds aktiva prenumerationer
curl "https://app.octany.com/api/$ACCOUNT/\
subscriptions?filter[reference_id]=user_42" \
  -H "X-API-KEY: $OCTANY_KEY"

# 200 OK — paginerat svar
# {
#   "data": [{
#     "id": 76963688,
#     "status": "active",
#     "reference_id": "user_42",
#     "renews_at": "2026-05-25T09:29:51+00:00"
#   }],
#   "pagination": { "total": 1, ... }
# }
Utdrag — API läs hela →

Tre vägar in

§ 01 — Integrationsytor
A · INSAMLING

Insamling

Donation, 1-click Swish och Greeting — färdiga upplevelser för kampanjsidor, redaktionella sidor och säsongsgivande.

För: insamlingssidor och kampanjer
se hur du integrerar
B · CHECKOUT

Checkout

Hostad kassa på checkout.octany.com. Bygg en URL eller använd JS-API:et window.Octany för varukorg och kassaflöde.

För: SaaS, e-handel, varukorgar
se hur du integrerar
C · LEGACY

Klassisk widget

Lägg den ursprungliga kassan på en befintlig sida med en liten HTML-snutt och ett hostat skript.

För: befintliga klassiska integrationer
se hur du integrerar
§ 02 — Begrepp

Hela betalningsmodellen i fem substantiv

Octany är medvetet mindre än Stripe. Det finns inget separat Price-objekt. Allt utgår från en enda tenant — Account — och dess numeriska ID finns med i varje URL-path.

Kommer du från Stripe Cashier? Migreringsguiden mappar över alla begrepp åt dig.

Octany Motsvarighet i Stripe Anteckningar
Account Account Toppnivå-tenant. Numeriskt ID i varje path.
Product Product + Price Ett objekt. Pris, intervall och moms ligger på det.
Subscription Subscription En produkt per prenumeration. Status styr faktureringen.
Order Invoice + PaymentIntent Varje schemalagd debitering ger en order.
§ 03 — Byggd även för agenter

En docs-sajt som en LLM kan läsa.

Varje sida på den här sajten har en markdown-motsvarighet i /docs. Varje sida exponerar markdownen via <link rel="alternate">. OpenAPI-specen ligger i repot. Det finns en llms.txt i roten som ryms i ett kontextfönster. Klistra in den i din agent och hoppa över crawlen.

§ 04 — Ytan

REST-endpoints, bläddringsbara

API-referens →
GET /api/{account}/subscriptions
GET /api/{account}/products
GET /api/{account}/subscription/{id}
GET /api/{account}/product/{id}
POST /api/{account}/subscription/{id}/cancel
POST /api/{account}/product/{id}
POST /api/{account}/subscription/{id}/order
GET /api/{account}/order/{id}
GET /api/{account}/subscription/{id}/orders
POST /api/{account}/webhooks/endpoints