> ## Documentation Index
> Fetch the complete documentation index at: https://docs.northfond.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate with AI

> Give an AI coding assistant the current NorthFond contract and the context it needs to produce a safe integration.

NorthFond publishes machine-readable documentation for AI coding assistants:

* [`llms.txt`](https://docs.northfond.xyz/llms.txt) is the compact documentation index.
* [`llms-full.txt`](https://docs.northfond.xyz/llms-full.txt) contains the complete published documentation corpus.
* [`openapi.json`](https://docs.northfond.xyz/openapi.json) is the canonical request and response contract.

Use the **Copy page**, **View as Markdown**, **Open in ChatGPT**, or **Open in Claude** action at the top of a documentation page when you need focused context.

## Recommended prompt

```text theme={null}
Implement a server-side NorthFond sandbox payment integration.

Use https://docs.northfond.xyz/openapi.json as the API contract and
https://docs.northfond.xyz/llms-full.txt for behavioral guidance.

Requirements:
- never expose NORTHFOND_API_KEY to browser or mobile code;
- send a unique Idempotency-Key on every POST request;
- use payment_intents:read, payment_intents:write, and treasury:read;
- treat only payment_intent.completed as successful payment;
- verify signed webhooks and also reconcile through the API;
- build and test against sandbox before enabling live credentials.
```

## Give AI only test credentials

Do not paste a raw API key into a chat, issue, source file, or generated prompt. Store the sandbox key in a local secret manager or environment variable and let generated server-side code read `NORTHFOND_API_KEY` at runtime.

<Warning>
  Review generated code before running it. An AI assistant must not decide when to enable live credentials, weaken webhook verification, remove idempotency, or fulfill an order from a browser redirect.
</Warning>

## Contract boundaries

The OpenAPI specification documents API-key-authenticated Business API endpoints. Hosted payment-page endpoints are customer-facing and are documented in [Payment links](/payment-links). Payroll is currently a Business dashboard workflow and is not part of the public Business API.

Runtime availability can differ by business, environment, policy, country, payment method, and provider readiness. Query the relevant capability or readiness endpoint rather than asking an AI assistant to hardcode a country list.