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

# AI Agent

> Easily integrate with CHIP Collect by using AI agent

## Description

The command provided is for the user to install the skill.MD to assist with the integration of CHIP payment link using AI agent.
The `SKILL.md` contains manual instructions for the agent to integrate CHIP payment gateway and generate checkout URLs so the user can verify the integration end-to-end.

## Requirements

* Cursor, Codex or any AI-powered IDE
* Know how to execute terminal command and prompt AI agent

## Install

Run the following command in your project root to install the skill.

```bash theme={null}
npx @chip-in.asia/skill
```

Once executed, a `SKILL.md` file is generated inside the `chip-skill/` folder in your root repository.

***

## Example prompt

Use this prompt after installing the skill to generate a dummy payment link.

```
Create a dummy payment link,
The expected output is :
- chip-env file to store CHIP's Secret Key and Brand ID
- executable code that will generate a checkout URL.
- instructions where to get the credentials
- command to execute the code
use chip-skill/SKILL.md as a reference.
```

***

## What to do next

Once the code is generated, follow these steps to test your integration.

<Steps>
  <Step title="Insert your credentials">
    Add your CHIP Secret Key and Brand ID into the generated `chip-env` file.
  </Step>

  <Step title="Run the executable code">
    Execute the generated code using the command provided. <br /> A checkout URL will be printed to your terminal.
  </Step>

  <Step title="Click the checkout URL">
    Open the URL in your browser to make a dummy payment. Please use the test mode API key.
  </Step>
</Steps>

<Warning>
  Always use a **test mode API key** when generating dummy payment links. <br /> Do not use your live credentials for testing.
</Warning>

<Info>
  How to identify whether it is real or dummy payment link? <br />
  Dummy payment link will execute fake payment instead of redirect to bank page when user click pay.
</Info>

***

## Get your credentials

Retrieve your Brand ID and API keys from the CHIP staging portal.

<CardGroup cols={2}>
  <Card title="Brand ID" icon="fingerprint" href="https://portal.chip-in.asia/collect/developers/api-keys">
    Get your Brand ID from the CHIP staging portal.
  </Card>

  <Card title="API keys" icon="key" href="https://portal.chip-in.asia/collect/developers/api-keys">
    Get your Secret Key from the CHIP staging portal.
  </Card>
</CardGroup>

***

## Source documents

Refer to the official CHIP documentation and downloadable markdown files for deeper integration details.

<CardGroup cols={3}>
  <Card title="CHIP Skill" icon="terminal" href="https://www.npmjs.com/package/@chip-in.asia/skill">
    Source for the npx command and CHIP NPMJS account
  </Card>

  <Card title="CHIP API documentation" icon="book" href="https://docs.chip-in.asia/chip-collect/overview/introduction">
    Full API reference and integration guides.
  </Card>

  <Card title="Downloadable API markdown" icon="download" href="https://notes.chip-in.asia/share/2im42j9bvl/p/chip-collect-api-Npj8FQkPaY">
    Downloadable CHIP API markdown files.
  </Card>
</CardGroup>