# Cleard developer documentation

> Provider API 1.4.0. Enroll existing wallets through scoped self-service access, route protected test USDC payments and fund approved refunds from the accepted reserve or bounded merchant-wallet source. Original payments remain final.

## Read first
- [Capabilities](https://cleard.ai/docs/capabilities.json): implemented operations, execution environments and integration requirements
- [Full documentation](https://cleard.ai/docs/docs.md): all guides in Markdown
- [Routing OpenAPI](https://cleard.ai/docs/routing-openapi.json): /v1/routing requests, responses and scopes
- [Documentation OpenAPI](https://cleard.ai/docs/openapi.json): public static resources

## Start here
- [Introduction](https://cleard.ai/docs/introduction.md): Add a programmable refund right while keeping the original payment final.
- [What you can build](https://cleard.ai/docs/capability-model.md): A merchant- or provider-owned checkout with atomic funding and a surviving refund obligation.
- [Quickstart](https://cleard.ai/docs/quickstart.md): Get scoped access, enroll an existing wallet and run a protected test USDC checkout.
- [Integration flow](https://cleard.ai/docs/provider-integration.md): One routed payment and a surviving, separately funded refund obligation.
- [API reference](https://cleard.ai/docs/api.md): Versioned routed test USDC operations with exact scopes and purchase bindings.

## Detailed references
- [Errors & retries](https://cleard.ai/docs/retries.md): Recover exact intents and receipts without duplicate payments or obligations.
- [Access & authentication](https://cleard.ai/docs/authentication.md): Separate account access, scoped API credentials, wallet authority and reviewer decisions.
- [Purchases](https://cleard.ai/docs/api-purchases.md): Enroll funding authority, register a purchase and reconcile its actual routed payment.
- [Claims & decisions](https://cleard.ai/docs/api-claims.md): A bound buyer claim and a designated-reviewer decision precede refund execution.
- [Refunds & recovery](https://cleard.ai/docs/api-refunds.md): Pay from enrolled funds and recover eligible shortfalls without reversing payment.
- [Contracts & trust](https://cleard.ai/docs/onchain.md): Inspect the collection contract, cryptographic boundary and execution limits.
- [Sandbox](https://cleard.ai/docs/api-evidence.md): Use existing wallets in one self-service routed test USDC flow.
- [Routed checkout details](https://cleard.ai/docs/routed-checkout.md): Choose refund funding, bind merchant permission and handle unpaid obligations.
- [For AI agents](https://cleard.ai/docs/agents.md): Discover the routed API, verify exact scopes and keep participant authority separate.