# Fina Developers

> Fina is the business operating system for small businesses in the Dominican Republic. Third parties can accept payments with the Fina Pay API (charges, payment links, signed webhooks) and build their own customer apps on the storefront APIs (farm, boutique, restaurant, barbershop, real estate, rent a car). Every API is HTTPS + JSON with an OpenAPI 3.1 spec. Money is always an integer in minor units (centavos).

All of this documentation in one file: https://fina.do/llms-full.txt. Read-only MCP server for AI assistants: https://fina.do/api/developers/mcp (Streamable HTTP).

## Get started

- [Overview](https://fina.do/developers/overview.md): What you can build on Fina, which API to use and how to authenticate.
- [Quickstart](https://fina.do/developers/quickstart.md): Create an API key, take your first payment and receive the webhook in about five minutes.
- [Build with AI](https://fina.do/developers/ai.md): llms.txt, Markdown pages, a ready-made prompt and a read-only MCP server for Claude Code, Cursor and other assistants.

## Fina Pay

- [Authentication](https://fina.do/developers/authentication.md): Public and secret keys of the Fina Pay connector, rate limits and key rotation.
- [Charges](https://fina.do/developers/charges.md): Lifecycle of a Fina Pay charge: statuses, expiry, fees, cancellation and refunds.
- [Payouts](https://fina.do/developers/payouts.md): Pay Fina Pay users from your own wallet: withdrawals, prizes, refunds outside a charge. Idempotent and instant.
- [Webhooks](https://fina.do/developers/webhooks.md): Signed IPN events (charge.* and subscription.*), signature verification in 3 languages, retries and idempotent handling.
- [Subscriptions](https://fina.do/developers/subscriptions.md): Recurring Fina Pay payments: hosted checkout, customer portal and lifecycle webhooks (rolling out).

## Apps

- [Storefront APIs](https://fina.do/developers/storefront-apis.md): Build your own customer app or website on top of a Fina business: app key, envelope, /config, delivery quotes and weight-based shipping.

## API reference

- [Fina Pay API](https://fina.do/developers/api-fina-pay.md): Charges, payment links, payouts and signed webhooks for any store, app or backend.
- [Farm storefront API](https://fina.do/developers/api-farm.md): Catalog, delivery windows, orders, subscription boxes and delivery quotes of one farm.
- [Boutique storefront API](https://fina.do/developers/api-boutique.md): Products with variants, addresses, delivery quotes (incl. weight-based shipping) and orders of one store.
- [Restaurant storefront API](https://fina.do/developers/api-restaurant.md): Menu, table QR ordering, waiter calls, table reservations, delivery and pickup orders of one restaurant.
- [Barbershop booking API](https://fina.do/developers/api-barbershop.md): Services, staff, live slots, appointments, waitlist and reviews of one barbershop.
- [Real estate API](https://fina.do/developers/api-real-estate.md): Published properties with filters and visit requests.
- [Rent a car API](https://fina.do/developers/api-rent-car.md): Fleet catalog, availability, customer accounts, reservations with pickup or delivery, and Fina Pay payment.
- [Restaurant staff API](https://fina.do/developers/api-staff.md): Kitchen queue, floor plan, cashier, deliveries and reservations for paired staff devices.
- [Video Studio API](https://fina.do/developers/api-video-studio.md): Quoted, idempotent AI media jobs paid with your Fina credits.

## More

- [Errors](https://fina.do/developers/errors.md): HTTP status codes and stable error codes of the Fina Pay and storefront APIs.
- [Testing and going live](https://fina.do/developers/testing.md): How to test without a sandbox, and a go-live checklist.
- [Changelog](https://fina.do/developers/changelog.md): Notable changes to the public APIs and these docs.

## OpenAPI specs

- [Fina Pay API](https://fina.do/api/wallet/v1/openapi.json): Charges, payment links, payouts and signed webhooks for any store, app or backend.
- [Farm storefront API](https://fina.do/api/farm/v1/openapi.json): Catalog, delivery windows, orders, subscription boxes and delivery quotes of one farm.
- [Boutique storefront API](https://fina.do/api/boutique/v1/openapi.json): Products with variants, addresses, delivery quotes (incl. weight-based shipping) and orders of one store.
- [Restaurant storefront API](https://fina.do/api/restaurant/v1/openapi.json): Menu, table QR ordering, waiter calls, table reservations, delivery and pickup orders of one restaurant.
- [Barbershop booking API](https://fina.do/api/barbershop/v1/openapi.json): Services, staff, live slots, appointments, waitlist and reviews of one barbershop.
- [Real estate API](https://fina.do/api/real-estate/v1/openapi.json): Published properties with filters and visit requests.
- [Rent a car API](https://fina.do/api/rent-car/v1/openapi.json): Fleet catalog, availability, customer accounts, reservations with pickup or delivery, and Fina Pay payment.
- [Restaurant staff API](https://fina.do/api/staff/v1/openapi.json): Kitchen queue, floor plan, cashier, deliveries and reservations for paired staff devices.
- [Video Studio API](https://fina.do/api/video-studio/v1/openapi.json): Quoted, idempotent AI media jobs paid with your Fina credits.

## Optional

- [Full documentation](https://fina.do/llms-full.txt): every page above in a single Markdown file.