> ## 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.

# Install the skill

> Easily integrate with CHIP Send by using an AI agent.

## Description

The command below installs the `SKILL.md` that an AI agent uses to
integrate with the CHIP Send API for payouts. Once installed, the
agent can read recipient bank account creation, send instruction
flow, approval routing, and the HMAC-SHA512 request signing scheme
straight from the canonical skill file.

## Conventions for AI agents

CHIP exposes a machine-readable entry point at
[`/llms.txt`](/llms.txt) that lists the canonical base URLs, path
conventions, and authentication headers for both products. When
generating integration code for CHIP Send:

* **CHIP Send** resource paths are prefixed with `/send/` and use
  `snake_case` (e.g. `/send/bank_accounts/{id}/`).
  Base URLs: `https://api.chip-in.asia/api` (production) and
  `https://staging-api.chip-in.asia/api` (sandbox).
* All CHIP Send endpoints require three headers on every request:
  `Authorization: Bearer <api_key>`,
  `epoch: <unix_seconds>`, and
  `checksum: <hmac_sha512_hex>` (see the
  [Send introduction](/chip-send/api-reference/introduction) for
  the signing algorithm).
* **Never invent a path.** If the doc or OpenAPI spec doesn't show
  it, it doesn't exist. If a path you "remember" isn't in the spec,
  the spec wins.

The raw OpenAPI spec is served at
[`/openapi/chip-send.yaml`](/openapi/chip-send.yaml) for direct
consumption by coding agents.

## Requirements

* Cursor, Codex or any AI-powered IDE
* Know how to execute terminal commands and prompt an AI agent
* A CHIP Send account provisioned by the CHIP admin team (see
  [Send overview](/chip-send/api-reference/overview#prerequisites))

## Install

Run this command in your project root to install the CHIP Send skill.

```bash theme={null}
npx -y github:CHIPAsia/skill-send
```

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

If you also need to accept payments, install the
[CHIP Collect skill](/chip-collect/overview/vibe-coding-guide) in
the same project — the two skills are independent and do not
conflict.

***

## Example prompt

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

```
Create a dummy CHIP Send payout,
The expected output is:
- a chip-send-env file to store CHIP Send's API Key and API Secret
- executable code that will register a recipient bank account and
  create a send instruction
- instructions on where to get the credentials
- the command to execute the code
Use chip-skill-send/SKILL.md as a reference.
```

***

## What to do next

Once the code is generated, follow these steps to test your
integration in the CHIP Send sandbox.

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

  <Step title="Run the executable code">
    Execute the generated code using the command provided. <br />
    The code will register a recipient bank account and create a
    send instruction in the staging environment.
  </Step>

  <Step title="Check the accounts balance">
    Call the [Accounts API](/chip-send/api-reference/accounts/list)
    to confirm the convertible balance reflects the new send
    instruction.
  </Step>
</Steps>

<Warning>
  Always use **staging credentials** when generating dummy payouts. <br />
  Do not use production credentials for testing — staging does not
  move real money and will not consume your daily allocation cap.
</Warning>

<Info>
  Every CHIP Send request is signed with a fresh `epoch` + `checksum`
  pair, recomputed for each request. Reusing a checksum from a prior
  request will be rejected with `401 Unauthorized`.
</Info>

***

## Get your credentials

Retrieve your API Key and API Secret from the CHIP Control panel.

<CardGroup cols={2}>
  <Card title="Applications & keys" icon="key" href="https://portal.chip-in.asia/control/settings/applications">
    Find your API Key and API Secret in CHIP Control → Settings → Applications.
  </Card>

  <Card title="Request access" icon="envelope" href="https://api.whatsapp.com/send?phone=60162522282&text=Hi%20CHIP">
    New to CHIP Send? Contact your account manager to provision a
    merchant account and approvers.
  </Card>
</CardGroup>

***

## Source documents

<CardGroup cols={2}>
  <Card title="CHIP Send OpenAPI spec" icon="code" href="/openapi/chip-send.yaml">
    Raw `chip-send.yaml` OpenAPI 3.1 spec.
  </Card>

  <Card title="CHIP Send skill source" icon="github" href="https://github.com/CHIPAsia/skill-send">
    Source for the CHIP Send AI skill and the canonical `SKILL.md`.
  </Card>
</CardGroup>