TeePayDocs
Agent skill

Agent skill

Teach Claude Code, Cursor, Codex and other coding agents to integrate TeePay correctly, on demand.

The TeePay integration skill gives your AI coding agent TeePay's rules and API, loaded only when the task needs them. Instead of pasting docs into a chat, you ask "add TeePay mobile money to my checkout" and the agent writes the integration the way these docs describe.

It follows the open Agent Skills format, so it works with Claude Code, Cursor, Codex, Gemini CLI and other agents that support skills.

What the skill teaches

  • Choosing between mobile money push, checkout sessions, Control Numbers and payouts.
  • Calling every /v1 endpoint with the right fields, scopes and idempotency keys.
  • Amounts in integer minor units, and discovering countries and currencies from capabilities.
  • Verifying webhook signatures over the raw body, de-duplicating events and handling retries.
  • Treating 202 and timeouts as uncertain, and fulfilling only on verified payments.
  • Keeping secret keys server-side, and giving chatbots a link key instead.

Its endpoint reference is generated from the same OpenAPI document as this site, so it always matches the live API.

Install

Run this in your project:

mkdir -p .claude/skills/teepay-integration/references && cd .claude/skills/teepay-integration && \
for f in SKILL.md references/api.md references/webhooks.md references/errors.md; do \
  curl -fsSL "https://docs.teepay.me/skills/teepay-integration/$f" -o "$f"; done

Use ~/.claude/skills/ instead of .claude/skills/ to make it available in every project.

One-command install is coming

TeePay will publish the skill on GitHub so you can install and update it with the skills CLI, which detects your agent automatically. This page will show the command when it is available.

Update

Run the install again after TeePay API releases (see the changelog). The skill's metadata.version tells you which release you have.

When it is used

Your agent loads the skill automatically when a request mentions TeePay, api.teepay.me, tp_live_ or tp_test_ keys, TeePay webhooks or Control Numbers, or accepting M-Pesa, Airtel Money, Mixx by Yas or HaloPesa through TeePay. You can also ask for it by name.

Keys stay out of the chat

The skill never needs your secret key. Keep it in your server's environment (for example TEEPAY_API_KEY) and never paste it into an agent conversation.

On this page