# Use Chiwa Pay with AI agents


> Give your coding agent the documentation and API contract it needs to build a Chiwa Pay integration.

Canonical: https://docs.chiwapay.com/agents

Chiwa Pay documentation is available as focused Markdown, a complete documentation bundle, and an OpenAPI contract. Your agent can find the right guide without scraping the website or guessing how an endpoint works.

## Start here

### Point your agent to the index

Give the agent [`/llms.txt`](https://docs.chiwapay.com/llms.txt). It lists the available guides and their machine-readable versions.

### Read only the relevant guide

For a payment integration, for example, the agent can open [`/llms.mdx/payments`](https://docs.chiwapay.com/llms.mdx/payments) instead of loading the entire documentation set.

### Check the API contract

Before it writes code, have the agent validate methods, paths, authentication, and schemas against [`/openapi/core-api.yaml`](https://docs.chiwapay.com/openapi/core-api.yaml).

## Give this to your agent

Tell the agent what you want to build, then copy this instruction with it. The documentation origin is filled from the current environment.

```text
Read https://docs.chiwapay.com/llms.txt and use it to find only the Chiwa Pay guides relevant to this task.

Before writing code, validate every endpoint, HTTP method, authentication requirement, and schema against https://docs.chiwapay.com/openapi/core-api.yaml.

Do not invent endpoints, fields, status values, fees, or webhook events. Keep secret keys on the server and ask for explicit approval before any live payment, refund, cancellation, or configuration change.
```

## Machine-readable resources

- [`/llms.txt`](https://docs.chiwapay.com/llms.txt) — Find the right guide.
- [`/llms.mdx/{document}`](https://docs.chiwapay.com/llms.mdx/payments) — Read one guide as Markdown.
- [`/llms-full.txt`](https://docs.chiwapay.com/llms-full.txt) — Load the complete documentation set.
- [`/openapi/core-api.yaml`](https://docs.chiwapay.com/openapi/core-api.yaml) — Generate or validate API code.
- [`/.well-known/chiwa-docs.json`](https://docs.chiwapay.com/.well-known/chiwa-docs.json) — Discover the machine-readable files.
- [`/agent-instructions.md`](https://docs.chiwapay.com/agent-instructions.md) — Read agent-specific rules.

> **Keep credentials out of the conversation**
> Never paste API keys, OTPs, cookies, authorization headers, webhook secrets, or customer data into an agent prompt. Keep secrets on your server and load them through your deployment environment.

## Before an agent performs an action

Reading documentation and generating code do not require Chiwa Pay credentials. Creating a live payment, issuing a refund, cancelling a transaction, or changing merchant configuration still requires the normal authentication flow and your explicit approval.

Chiwa Pay currently publishes documentation for coding agents; it does not expose an MCP or A2A server for performing merchant actions.