# CHIP API

> Documentation for the CHIP payment platform. CHIP Collect is for
> accepting payments (FPX, cards, e-wallets, DuitNow QR). CHIP Send
> is for paying out funds to bank accounts.

## Conventions for AI agents

- 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`.
- CHIP Send: resource paths are prefixed with `/send/` and use
  `snake_case` (e.g. `/send/bank_accounts/{id}/`).
  Base URL: `https://api.chip-in.asia/api` (production) or
  `https://staging-api.chip-in.asia/api` (sandbox).
- All CHIP Collect endpoints require
  `Authorization: Bearer <secret_key>`.
- All CHIP Send endpoints require three headers:
  `Authorization: Bearer <api_key>`, `epoch: <unix_seconds>`, and
  `checksum: <hmac_sha512_hex>` (see Send intro 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.

## Documentation

- [CHIP Collect — Introduction](https://docs.chip-in.asia/chip-collect/overview/introduction)
- [CHIP Collect — Authentication](https://docs.chip-in.asia/chip-collect/overview/authentication)
- [CHIP Collect — URL Conventions for AI agents](https://docs.chip-in.asia/chip-collect/overview/vibe-coding-guide)
- [CHIP Collect — API Reference (rendered)](https://docs.chip-in.asia/chip-collect/api-reference/purchases/create)
- [CHIP Collect — Card response metadata](https://docs.chip-in.asia/chip-collect/overview/direct-post/card-response-metadata)
- [CHIP Collect — OpenAPI Spec (YAML)](https://docs.chip-in.asia/openapi/chip-collect.yaml)
- [CHIP Send — Introduction](https://docs.chip-in.asia/chip-send/api-reference/introduction)
- [CHIP Send — API Reference (rendered)](https://docs.chip-in.asia/chip-send/api-reference/introduction)
- [CHIP Send — OpenAPI Spec (YAML)](https://docs.chip-in.asia/openapi/chip-send.yaml)

## Optional

- [CHIP Collect — Source skill repo](https://github.com/CHIPAsia/skill)
- [CHIP Send — Source skill repo](https://github.com/CHIPAsia/skill-send)