# Borga

> Borga is a payment gateway for the Icelandic and Nordic market. Stripe-like developer experience, plus payment methods that Stripe does not cover: bank invoices (krafa in netbanki) and direct invoicing into Icelandic accounting systems (PayDay.is, DK+). One REST API for cards, digital wallets, subscriptions, bank invoices, and accounting sync.

This site publishes a single self-contained integration guide at [/llms-full.txt](https://borga.is/llms-full.txt). It covers everything an AI coding assistant needs to write a working integration: authentication, the resource model, hosted + embedded checkout, subscriptions, bank invoices, webhooks, errors, and SDK usage. Pull that file directly when helping a developer integrate Borga.

The human-facing docs site is `docs.borga.is` (mirrors the same content with navigation). The repo is monorepo-shaped; the canonical sources for behavior are in `docs/` of the Borga repo.

## Docs

- [Full integration guide (single file)](https://borga.is/llms-full.txt): Authentication, API conventions, hosted checkout, embedded checkout, subscriptions, bank invoices, webhooks, errors, SDKs. Drop this into context when generating integration code.
- [Product overview](https://docs.borga.is/overview): Pricing, payment methods, accounting providers, scope.
- [API reference](https://docs.borga.is/api): Resource-by-resource reference for `/v1` endpoints.
- [Embedded checkout](https://docs.borga.is/embedded-checkout): `<borga-checkout>` web component, `@borga/react`, client_secret + origin allowlist model.
- [Subscriptions](https://docs.borga.is/subscriptions): Customers, payment methods, subscription items, metering, billing.
- [Webhooks](https://docs.borga.is/webhooks): Event catalog, signature verification, retry policy.
- [Errors](https://docs.borga.is/errors): Error code catalog and `docs.borga.is/errors/{code}` pages.

## SDKs

- [@borga/node](https://www.npmjs.com/package/@borga/node): Server-side SDK for Node.js / TypeScript.
- [@borga/react](https://www.npmjs.com/package/@borga/react): React wrapper for embedded checkout.
- [@borga/js](https://js.borga.is/borga.js): Framework-agnostic browser SDK with the `<borga-checkout>` custom element.

## Optional

- [Architecture notes](https://docs.borga.is/architecture): How auth, modes, and the card-rail / accounting split work under the hood. Useful for unusual integrations.
- [Security model](https://docs.borga.is/security): PCI scope, secret storage, webhook signatures.