Skip to main content

​
Description

The command provided is for the user to install the SKILL.md to assist with the integration of CHIP payment links using an 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.

​
Conventions for AI agents

CHIP exposes a machine-readable entry point at /llms.txt that lists the canonical base URLs, path conventions, and authentication headers for both products. When generating integration code for CHIP Collect:
  • CHIP Collect resource paths are plural with a trailing slash (e.g. /purchases/{id}/, not /purchase/{id}/). Base URL: https://gate.chip-in.asia/api/v1.
  • All CHIP Collect endpoints require Authorization: Bearer <secret_key>.
  • 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-collect.yaml for direct consumption by coding agents.

​
Requirements

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

​
Install

Run this command in your project root to install the 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.

​
What to do next

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

Insert your credentials

Add your CHIP Secret Key and Brand ID into the generated chip-env file.
2

Run the executable code

Execute the generated code using the command provided.
A checkout URL will be printed to your terminal.
3

Click the checkout URL

Open the URL in your browser to make a dummy payment. Please use the test mode API key.
Always use a test mode API key when generating dummy payment links.
Do not use your live credentials for testing.
How to identify a dummy payment link?
Dummy payment link will execute fake payment instead of redirect to bank page when user click pay.

​
Get your credentials

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

Brand ID

Get your Brand ID from the CHIP merchant portal.

API keys

Get your Secret Key from the CHIP merchant portal.

​
Source documents

The raw OpenAPI spec is the canonical machine-readable source of truth for CHIP Collect. Coding agents should consume it directly.

CHIP Collect OpenAPI spec

Raw chip-collect.yaml OpenAPI 3.1 spec.

CHIP Collect skill source

Source for the CHIP Collect AI skill and the canonical SKILL.md.
Looking for CHIP Send (payouts) instead? See Install the CHIP Send skill. The two skills are independent and can be installed in the same project.