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

# Ai agents

# Integrating with AI Agents

fype is uniquely designed to be "AI-ready." Because our API is unified and predictable, AI coding assistants (like Gemini, Cursor, or GitHub Copilot) can integrate fype into your codebase with extremely high accuracy.

## Why fype works well with AI Agents

1. **Unified Schema**: Agents don't have to learn the nuances of multiple gateway APIs. They only need to understand the fype schema.
2. **Simplified Flow**: The "Create -> Redirect -> Webhook" pattern is a standard architectural pattern that AI models excel at implementing.
3. **Decoupled Logic**: Since the gateway-specific logic is handled by fype, the AI Agent only focuses on your business logic.

## Recommended Prompts for AI Agents

Here are some prompts you can use with your AI assistant to speed up integration:

### 1. Initial Setup

```markdown theme={null}
I want to integrate fype payments into my [Next.js/FastAPI/Express] application. Please write a service that uses the fype [Node.js/Python] SDK to create a payment session when a user clicks 'Buy Now'. Use environment variables for the API key.
```

### 2. Webhook Handler

```markdown theme={null}
Create a secure webhook listener for fype events in my [Framework]. It should verify the `X-fype-Signature` using the secret from my environment variables. If the event is `payment.succeeded`, it should update the order status in my database to 'PAID'.
```

### 3. Error Handling

```markdown theme={null}
Review my fype integration code and add comprehensive error handling. Make sure to catch authentication errors, invalid request errors, and network timeouts. For idempotent requests, ensure the `Idempotency-Key` is generated using the order ID.
```

## Tips for Success

* **Provide the SDK Docs**: If your AI agent doesn't have the latest fype SDK knowledge, you can paste the [SDK Documentation](./sdks) into the chat context.
* **Use Type Definitions**: fype SDKs come with full TypeScript definitions. Encourage your AI agent to use them to ensure type safety.
* **Test with the Simulator**: Ask your agent to write unit tests that simulate the fype API responses using our standardized JSON formats.
* **Check the Logs**: Use the fype Dashboard to verify the requests your AI Agent is sending.