Tranzak Docs
tranzak.co Dashboard
Docs  /  Resources

Tranzak AI Connect

Tranzak AI Connect lets an AI coding agent read our integration guide and OpenAPI contract, write the integration, and test it in the sandbox.

Building with an AI coding agent such as Claude Code, Cursor, Codex, Lovable or Bolt? Give it the address of the Tranzak guide. It reads the guide, writes the integration in your project, in any language, then tests it in the sandbox, without inventing routes or fields.

Resources for agents

Resource Address Format
Integration guide tranzak.co/ai Plain text, written for agents
OpenAPI contract tranzak.co/openapi.json JSON
Index for language models tranzak.co/llms.txt Plain text

These are read-only, public documents. They contain no merchant data.

Use it in three steps

1. Prepare your keys

In the Tranzak dashboard:

  1. Create a website with a public https:// webhook URL. To test locally without a public URL, temporarily use https://example.com/webhook.
  2. Generate a test key (tk_test_…).
  3. Store it as the TRANZAK_API_KEY environment variable of your project, with the website's webhook secret as TRANZAK_WEBHOOK_SECRET. Never write them in the code or in the chat.

2. Paste this prompt into your agent

Integrate Tranzak payments into my project by following exactly the guide at https://tranzak.co/ai

Use test keys only (tk_test_). Read TRANZAK_API_KEY and TRANZAK_WEBHOOK_SECRET from environment variables: never write them in the code or in this conversation. Confirm payments on the server (signed webhook or API verification), never from the browser redirect alone, and run the sandbox scenarios before telling me it is done.

3. Review and go live yourself

Check the code the agent wrote, then follow Go live. Going live is a step you take yourself, after identity verification.

Test locally without a tunnel

With a test key, GET /api/gateway/v1/events returns the same events as webhooks (payment.success and payment.failed). Your application, or the agent, can read them itself during development, without exposing localhost. See Events feed.

Good to know

  • The agent never needs your production key.
  • Creating websites and keys automatically is not available yet: steps 1 and 2 are done in the dashboard.
  • There is no idempotency key, and no sandbox webhook for MonCash today. The guide explains this to the agent, which works around these limits.