# Chiwa Pay Developer Documentation

> Integration documentation for creating Chiwa Pay payments, reading transaction status, handling webhooks, refunds, cancellations, fees, and disbursements.

Treat the OpenAPI document as authoritative for request and response schemas. Use the Markdown guides for integration flows, business rules, and examples. Never disclose API keys, OTPs, cookies, authorization headers, or personal data.

## Start here

- [Chiwa Pay OpenAPI](https://docs.chiwapay.com/openapi/core-api.yaml): Machine-readable contract for endpoints, parameters, authentication, requests, and responses.
- [Complete documentation](https://docs.chiwapay.com/llms-full.txt): Every guide in one Markdown document.
- [Crawler guidance](https://docs.chiwapay.com/agent-instructions.md): Safety boundaries for indexing public documentation.

## Documentation

- [Use Chiwa Pay with AI agents](https://docs.chiwapay.com/llms.mdx/agents): Give your coding agent the documentation and API contract it needs to build a Chiwa Pay integration.
- [Authentication](https://docs.chiwapay.com/llms.mdx/authentication): Authenticate API requests with a Chiwa Pay secret key.
- [Error Codes](https://docs.chiwapay.com/llms.mdx/errors): Understand Chiwa Pay API error responses and codes.
- [Fees and Disbursement](https://docs.chiwapay.com/llms.mdx/fees-disbursement): Understand transaction amounts, fees, refunds, and disbursement.
- [Chiwa Pay API Overview](https://docs.chiwapay.com/llms.mdx/index): Chiwa Pay integration overview for creating transactions, accepting payments, and tracking payment status.
- [Cancel Payment](https://docs.chiwapay.com/llms.mdx/payment-cancel): Cancel a payment transaction that is still pending.
- [Payment Detail](https://docs.chiwapay.com/llms.mdx/payment-detail): Retrieve payment details and the latest transaction status.
- [Refund Payment](https://docs.chiwapay.com/llms.mdx/payment-refund): Start a refund and track its status.
- [Create Payment](https://docs.chiwapay.com/llms.mdx/payments): Create single or bulk payment transactions.
- [Transactions](https://docs.chiwapay.com/llms.mdx/transactions): List and filter merchant transactions.
- [Webhooks](https://docs.chiwapay.com/llms.mdx/webhooks): Receive and verify transaction status events.

## Optional

- [HTML documentation](https://docs.chiwapay.com/): Interactive documentation for human readers.
- [XML sitemap](https://docs.chiwapay.com/sitemap.xml): Index of canonical HTML pages.
- [Robots policy](https://docs.chiwapay.com/robots.txt): Crawler access policy.