![\"AxonJs](\"https://avatars.githubusercontent.com/u/198393404?s=200&v=4\")
\n\n
\n ๐ณ Modular, type-safe payment gateway clients for Node.js โ with first-class TypeScript, ESM exports, and real-world API support.\n
\n\n---\n\n## ๐ What is this?\n\n`@axonlabs/payments` is a unified payment client library for Node.js applications โ built with **TypeScript**, **ESM**, and **modern developer ergonomics** in mind.\n\nWhether you're integrating **Plisio**, **Zarinpal** (more payment clients will coming soon) this package gives you:\n\n- ๐งฉ Gateway-specific clients with type-safe methods\n- ๐ Easy plug-and-play usage\n- ๐ Common interfaces for consistency\n- โก๏ธ Fully tree-shakable via ESM exports\n- ๐ฆ Single package, clean structure\n\n**[Project Changelog](./CHANGELOG.md)**\n\n---\n\n## ๐ฆ Supported Gateways\n\n| Gateway | Import Path | Status |\n|----------------|--------------------------------------|-------------|\n| Plisio | `@axonlabs/payments/plisio` | ๐งช In progress |\n| Zarinpal | `@axonlabs/payments/zarinpal` | ๐ง In Future |\n\n> Want to contribute a gateway? PRs are welcome!\n\n---\n\n## ๐งช Example Usage\n\n```ts\n// Plisio\nimport { PlisioClient } from '@axonlabs/payments/plisio';\n\nconst plisio = new PlisioClient(secret_key, \"whitelabel\");\n\n// Central hub\nimport { Payments, AxonPayments } from '@axonlabs/payments';\n\nconst plisio1 = Payments.getPlisio(secret_key, \"whitelabel\");\nconst plisio2 = new AxonPayments().getPlisio(secret_key, \"whitelabel\");\n```\n\nEach gateway is designed to be self-contained and follow a consistent interface.\n\n---\n\n## ๐ง Philosophy\n\n- โ ESM-first โ optimized for modern tooling\n- โ๏ธ Shared interfaces, custom configs, and low-level control\n- ๐งช Testable clients for real-world server environments\n- ๐ Multi-gateway ready in a single unified package\n\n---\n\n## ๐ Import Structure\n\n```ts\n// Plisio\nimport { PlisioClient } from '@axonlabs/payments/plisio';\n// Central hub\nimport { Payments, AxonPayments } from '@axonlabs/payments';\n```\n\n---\n\n## ๐ License\n\nMIT ยฉ [AxonJsLabs](https://github.com/AxonJsLabs)\n\n---\n\n## ๐ Contribute\n\nWe โค๏ธ open-source!\nFeel free to open issues, suggest improvements, or add new gateway clients.\n\n```bash\nnpm install\nnpm run build\nnpm run test\n```\n\n> Want to add your own gateway (e.g. NowPayments, IDPay, PayPal)? Check the lib/ folder and follow the structure.\n\nBuilt with ๐ by the AxonJsLabs community
","readmeFilename":"README.md"}