# payman-zarinpal
**payman-zarinpal** is a plugin for **[Payman](https://pypi.org/project/payman/)** that enables integration with the **ZarinPal payment gateway**. This package requires Payman >= 3.0.0.
## Installation
```bash
pip install payman[zarinpal]
```
## Quick Example
```python
import asyncio
from payman import Payman
from zarinpal.models import PaymentRequest
pay = Payman("zarinpal", merchant_id="your-merchant-id")
async def main():
req_params = PaymentRequest(
amount=100_000,
callback_url="https://example.com/callback",
description="Test Payment",
metadata={"email": "user@example.com", "mobile": "09123456789"},
)
response = await pay.initiate_payment(req_params)
print(response.success, response.authority)
asyncio.run(main())
```
## Links
* [Payman GitHub Repository](https://github.com/irvaniamirali/payman)
* [Payman Documentation](https://irvaniamirali.github.io/payman)
* [Zarinpal API Reference](https://docs.zarinpal.com/paymentGateway/)
Raw data
{
"_id": null,
"home_page": null,
"name": "payman-zarinpal",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": null,
"keywords": "payment, gateway, zarinpal, payman, plugin",
"author": null,
"author_email": "AmirAli Irvani <irvaniamirali.dev@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/8a/7a/6e8f71cd1923a43601210e2e6c9705f166504b52fdfa222231199a9dd974/payman_zarinpal-1.0.0.tar.gz",
"platform": null,
"description": "# payman-zarinpal\n\n**payman-zarinpal** is a plugin for **[Payman](https://pypi.org/project/payman/)** that enables integration with the **ZarinPal payment gateway**. This package requires Payman >= 3.0.0.\n\n## Installation\n\n```bash\npip install payman[zarinpal]\n```\n\n## Quick Example\n\n```python\nimport asyncio\n\nfrom payman import Payman\nfrom zarinpal.models import PaymentRequest\n\npay = Payman(\"zarinpal\", merchant_id=\"your-merchant-id\")\n\nasync def main():\n req_params = PaymentRequest(\n amount=100_000,\n callback_url=\"https://example.com/callback\",\n description=\"Test Payment\",\n metadata={\"email\": \"user@example.com\", \"mobile\": \"09123456789\"},\n )\n\n response = await pay.initiate_payment(req_params)\n print(response.success, response.authority)\n\nasyncio.run(main())\n```\n\n## Links\n\n* [Payman GitHub Repository](https://github.com/irvaniamirali/payman)\n* [Payman Documentation](https://irvaniamirali.github.io/payman)\n* [Zarinpal API Reference](https://docs.zarinpal.com/paymentGateway/)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "ZarinPal payment gateway plugin for Payman",
"version": "1.0.0",
"project_urls": null,
"split_keywords": [
"payment",
" gateway",
" zarinpal",
" payman",
" plugin"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f7b60ce30133893feb2c8daaa91f551b90d5834155ee5af3df9ffb2688d50f52",
"md5": "56bc4ed011399f898a49478712e9583a",
"sha256": "4fef27af24099690413b32e3586bf2ff11eda685eedc36b7b86aa47d05004a4e"
},
"downloads": -1,
"filename": "payman_zarinpal-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "56bc4ed011399f898a49478712e9583a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 16698,
"upload_time": "2025-10-11T18:36:31",
"upload_time_iso_8601": "2025-10-11T18:36:31.709223Z",
"url": "https://files.pythonhosted.org/packages/f7/b6/0ce30133893feb2c8daaa91f551b90d5834155ee5af3df9ffb2688d50f52/payman_zarinpal-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8a7a6e8f71cd1923a43601210e2e6c9705f166504b52fdfa222231199a9dd974",
"md5": "52cd23548a19ca1cb02734c3cf9acd10",
"sha256": "61b1ea694367a82b9d54f79c27711637b0389959e5d69c08e99c4ff572bdc494"
},
"downloads": -1,
"filename": "payman_zarinpal-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "52cd23548a19ca1cb02734c3cf9acd10",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 9745,
"upload_time": "2025-10-11T18:36:33",
"upload_time_iso_8601": "2025-10-11T18:36:33.950219Z",
"url": "https://files.pythonhosted.org/packages/8a/7a/6e8f71cd1923a43601210e2e6c9705f166504b52fdfa222231199a9dd974/payman_zarinpal-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-11 18:36:33",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "payman-zarinpal"
}
JSON