Skip to content

Building Full-Stack Plugins

Zirzir features a full-stack plugin architecture. You can write custom payment gateways in TypeScript on Bun with dynamic React dashboard extensions.


Plugin IPC Communication Flow

Every plugin resides in its own folder inside plugins/:

plugins/my_gateway/
β”œβ”€β”€ plugin.json # Manifest, permissions & sidebar navigation
β”œβ”€β”€ index.ts # Bun backend payment driver (charge, verifyWebhook)
β”œβ”€β”€ ui.tsx # React dashboard extension component
└── dist/ui.js # Bundled standalone frontend view

The Zirzir CLI includes an automated test harness to verify your plugin’s IPC contract:

Terminal window
zirzir plugin test plugins/santimpay