# Borga

## Docs

- [Credit Notes API — retrieve refund credit notes](https://docs.borga.is/api-reference/billing/credit-notes.md): Retrieve credit notes that Borga issues automatically when a refund is processed against a paid invoice. Filter by invoice ID to find related documents.
- [Customers API — create and manage customer records](https://docs.borga.is/api-reference/billing/customers.md): Create, list, retrieve, and update customer objects. Supports Icelandic kennitala, VAT numbers, billing address fields, and arbitrary metadata.
- [Invoices API — retrieve legally compliant invoices](https://docs.borga.is/api-reference/billing/invoices.md): Retrieve invoices that Borga auto-generates for each payment or billing cycle. Filter by status, inspect line items, and manage pending invoice items.
- [Prices API — set pricing for your products](https://docs.borga.is/api-reference/billing/prices.md): Create one-time and recurring prices for your products. Supports flat-rate, tiered, and metered usage pricing with graduated or volume tier modes.
- [Products API — define what you sell](https://docs.borga.is/api-reference/billing/products.md): Create and manage product objects that represent what you sell. Each product can have one or more prices attached, which define the amount and billing interval.
- [Accounting Link API — connect accounting providers](https://docs.borga.is/api-reference/config/accounting-link.md): Connect and manage accounting provider integrations to automatically sync invoices, apply VAT codes, and map revenue to general ledger accounts.
- [API Keys — create and rotate authentication keys](https://docs.borga.is/api-reference/config/api-keys.md): Create, list, rotate, and revoke API keys programmatically or through the dashboard. Manage publishable and secret keys across test and live environments.
- [Webhook Endpoints API — manage event subscriptions](https://docs.borga.is/api-reference/config/webhooks.md): Create, update, list, and delete webhook endpoints to receive real-time event notifications. View delivery history and retry failed deliveries.
- [API error codes and responses](https://docs.borga.is/api-reference/errors.md): Borga uses standard HTTP status codes and returns JSON error objects with a type, message, optional code, and the param that caused the error.
- [Borga REST API reference overview](https://docs.borga.is/api-reference/overview.md): Full REST API reference for Borga. Base URL https://api.borga.is. Authenticates with API keys. All requests and responses use JSON over HTTPS.
- [Payment Methods API — list and manage saved cards](https://docs.borga.is/api-reference/payments/payment-methods.md): List, retrieve, detach, and set a default payment method for a customer — supporting cards, Apple Pay, Google Pay, and bank invoices.
- [Payment Sessions API — hosted and embedded checkout](https://docs.borga.is/api-reference/payments/payment-sessions.md): Create payment sessions for hosted checkout (redirect) or embedded checkout flows, then retrieve them by ID to check status and collect credentials.
- [Payments API — create and retrieve payments](https://docs.borga.is/api-reference/payments/payments.md): Create payments with POST /v1/payments, list or retrieve them with GET, and inspect fields like amount, currency, status, and metadata.
- [Refunds API — full and partial payment refunds](https://docs.borga.is/api-reference/payments/refunds.md): Issue full or partial refunds against a payment with POST /v1/refunds, then list or retrieve refunds to track their status and amounts.
- [Meters API — track usage for metered billing](https://docs.borga.is/api-reference/subscriptions/meters.md): Create meters that define how usage events are aggregated for metered subscription pricing. Query per-customer usage totals for any time range.
- [Subscription Items API — add and update plan items](https://docs.borga.is/api-reference/subscriptions/subscription-items.md): Add, update, and remove items on an active subscription. Supports proration to credit or charge the customer for mid-cycle plan changes.
- [Subscriptions API — create and manage subscriptions](https://docs.borga.is/api-reference/subscriptions/subscriptions.md): Create, update, cancel, pause, and resume recurring subscriptions. Manage billing cycles, trial periods, discounts, and collection methods.
- [Usage Events API — ingest metered usage data](https://docs.borga.is/api-reference/subscriptions/usage-events.md): Ingest usage events for metered billing individually or in batches of up to 1,000. Use idempotency keys to safely retry without double-counting.
- [Authenticate API requests with Borga](https://docs.borga.is/authentication.md): Borga uses API keys to authenticate requests. Learn about secret and publishable keys, the Merchant ID header, idempotency, and how to handle auth errors.
- [Legal invoicing through PayDay.is](https://docs.borga.is/concepts/invoicing.md): Borga automatically generates legally compliant Icelandic invoices in PayDay.is for every payment — no manual bookkeeping required. Learn about invoice structure and credit notes.
- [How payments work in Borga](https://docs.borga.is/concepts/payments.md): Learn about the payment object, lifecycle, supported payment methods, hosted and embedded checkout sessions, refunds, and saved payment methods.
- [Recurring billing with Borga subscriptions](https://docs.borga.is/concepts/subscriptions.md): Understand how Borga subscriptions work — products, prices, subscription items, billing intervals, trials, proration, discounts, and collection methods.
- [Test mode: develop without real charges](https://docs.borga.is/concepts/test-mode.md): Learn how to use Borga's test environment — test API keys, test card numbers, data isolation from live mode, and how to apply for live access.
- [Accept a payment with the Borga API](https://docs.borga.is/guides/accept-payment.md): Walk through creating a customer, creating a payment, and confirming success using the Borga API — from first request to verified charge.
- [Sync invoices to your accounting software](https://docs.borga.is/guides/accounting-link.md): Connect Borga to your accounting provider to automatically sync invoices, credit notes, VAT codes, and payments — no manual exports needed.
- [Add hosted checkout to your website](https://docs.borga.is/guides/hosted-checkout.md): Redirect customers to Borga's PCI-safe hosted checkout page using payment sessions. No card data touches your server or affects your PCI scope.
- [Create and manage recurring subscriptions](https://docs.borga.is/guides/subscriptions.md): Step-by-step guide to creating products, prices, and subscriptions with Borga for recurring billing, including trials, pausing, and cancellation.
- [Usage-based billing with meters and events](https://docs.borga.is/guides/usage-billing.md): Set up usage-based pricing with Borga meters, ingest usage events, and bill customers at the end of each period based on their actual consumption.
- [Receive real-time events with webhooks](https://docs.borga.is/guides/webhooks.md): Register a webhook endpoint to receive signed event notifications from Borga for payments, subscriptions, and invoices in real time.
- [Borga: Payments & Invoicing API for Iceland](https://docs.borga.is/introduction.md): Borga is an ISK-native REST API for Icelandic businesses. Accept card payments, digital wallets, and bank invoices — with automatic legal invoicing on every transaction.
- [Get started with Borga](https://docs.borga.is/quickstart.md): Create your merchant account, get your test API keys, and make your first payment request against the Borga API — all in a few minutes.