finergy-mia-pos-sdk

Name	finergy-mia-pos-sdk JSON
Version	1.1.0 JSON
	download
home_page	None
Summary	Python SDK for Finergy MIA POS eComm API
upload_time	2025-09-02 09:26:56
maintainer	None
docs_url	None
author	Alexander Minza
requires_python	>=3.9
license	None
keywords	finergy moldova mia pos qr payments api sdk python
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Python SDK for Finergy MIA POS eComm API
* Finergy MIA POS eComm integration: https://github.com/finergy-tech/mia-pay-ecomm-integration
* GitHub project https://github.com/alexminza/finergy-mia-pos-sdk-python
* PyPI package https://pypi.org/project/finergy-mia-pos-sdk/

## Installation
To easily install or upgrade to the latest release, use `pip`:
```shell
pip install --upgrade finergy-mia-pos-sdk
```

## Getting started
Import SDK:

```python
from finergy_mia_pos_sdk import FinergyMiaPosSdk
```

Add project configuration:

```python
import os

FINERGY_MIA_POS_BASE_URL = os.getenv('FINERGY_MIA_POS_BASE_URL', FinergyMiaPosSdk.TEST_BASE_URL)
FINERGY_MIA_POS_MERCHANT_ID = os.getenv('FINERGY_MIA_POS_MERCHANT_ID')
FINERGY_MIA_POS_SECRET_KEY = os.getenv('FINERGY_MIA_POS_SECRET_KEY')
FINERGY_MIA_POS_TERMINAL_ID = os.getenv('FINERGY_MIA_POS_TERMINAL_ID')
```

## SDK usage examples
### Initialize SDK instance

```python
finergy_sdk = FinergyMiaPosSdk(
    base_url=FINERGY_MIA_POS_BASE_URL,
    merchant_id=FINERGY_MIA_POS_MERCHANT_ID,
    secret_key=FINERGY_MIA_POS_SECRET_KEY)
```

### Create order payment

```python
payment_data = {
    'terminalId': FINERGY_MIA_POS_TERMINAL_ID,
    'orderId': 'order12345',
    'amount': 150.75,
    'currency': 'MDL',
    'language': 'ro',
    'payDescription': 'Payment for order #12345',
    'paymentType': 'qr',
    'clientName': 'Test Client',
    'clientPhone': '00000000',
    'clientEmail': 'test@test.com',
    'callbackUrl': 'http://your_callback_url',
    'successUrl': 'http://your_success_url?orderId=order12345',
    'failUrl': 'http://your_failUrl_url?orderId=order12345'
}

create_payment_response = finergy_sdk.create_payment(payment_data=payment_data)

payment_id = create_payment_response['paymentId']
checkout_page = create_payment_response['checkoutPage']
```

### Validate callback signature

```python
callback_data = {
    'result': {
        'terminalId': 'TRMW0001',
        'orderId': '108',
        'paymentId': '2a663962-c954-4984-90e5-1d24c3305f7b',
        'status': 'EXPIRED',
        'amount': 1775.00,
        'currency': 'MDL',
        'paymentType': 'qr',
        'paymentDate': '2024-12-17T11:54:23'
    },
    'signature': 'gtWkQdF2X2oCwO/+a+DJxpDc5DhjC1PMVWrnCXsCX54qOo24siRTy4PAjHoYet1r0KERVEL65p7UZuHcaK+TOiJptlalMUVZWbGLPf05WpyKPOPSPI1P4ZoADzJpceYsKjjZImB/+ft6OAF+ahxazhHkiT1Ze05vwD2L1D6zRohcxZl9XRJMChZcVD9bdNy23ozwuq6FwlnneJJeCPNvqveg7f5e0CD1NXWdLJ3WryP0ypcGtQGZAY+PrhkdVG5SWhYr0FFniAZIrp9yOFn3vrsUP4rpZmeqIahSV6x12pyyRsm+bs/tjw/kPR34ygG7ksXsrpwhQbltAHWeWwnOmg=='
}

validate_result = finergy_sdk.validate_callback_signature(callback_data=callback_data)
```

### Get payment status

```python
payment_status_response = finergy_sdk.get_payment_status(payment_id=payment_id)
```

For more examples see [Finergy MIA POS PHP SDK](https://github.com/finergy-tech/mia-pay-ecomm-php-sdk)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "finergy-mia-pos-sdk",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "finergy, moldova, mia, pos, qr, payments, api, sdk, python",
    "author": "Alexander Minza",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/51/ac/458f4f4220ac4480dce2bf716ba3d1312fd5b156dfb5d706235942b3cd99/finergy_mia_pos_sdk-1.1.0.tar.gz",
    "platform": null,
    "description": "# Python SDK for Finergy MIA POS eComm API\n* Finergy MIA POS eComm integration: https://github.com/finergy-tech/mia-pay-ecomm-integration\n* GitHub project https://github.com/alexminza/finergy-mia-pos-sdk-python\n* PyPI package https://pypi.org/project/finergy-mia-pos-sdk/\n\n## Installation\nTo easily install or upgrade to the latest release, use `pip`:\n```shell\npip install --upgrade finergy-mia-pos-sdk\n```\n\n## Getting started\nImport SDK:\n\n```python\nfrom finergy_mia_pos_sdk import FinergyMiaPosSdk\n```\n\nAdd project configuration:\n\n```python\nimport os\n\nFINERGY_MIA_POS_BASE_URL = os.getenv('FINERGY_MIA_POS_BASE_URL', FinergyMiaPosSdk.TEST_BASE_URL)\nFINERGY_MIA_POS_MERCHANT_ID = os.getenv('FINERGY_MIA_POS_MERCHANT_ID')\nFINERGY_MIA_POS_SECRET_KEY = os.getenv('FINERGY_MIA_POS_SECRET_KEY')\nFINERGY_MIA_POS_TERMINAL_ID = os.getenv('FINERGY_MIA_POS_TERMINAL_ID')\n```\n\n## SDK usage examples\n### Initialize SDK instance\n\n```python\nfinergy_sdk = FinergyMiaPosSdk(\n    base_url=FINERGY_MIA_POS_BASE_URL,\n    merchant_id=FINERGY_MIA_POS_MERCHANT_ID,\n    secret_key=FINERGY_MIA_POS_SECRET_KEY)\n```\n\n### Create order payment\n\n```python\npayment_data = {\n    'terminalId': FINERGY_MIA_POS_TERMINAL_ID,\n    'orderId': 'order12345',\n    'amount': 150.75,\n    'currency': 'MDL',\n    'language': 'ro',\n    'payDescription': 'Payment for order #12345',\n    'paymentType': 'qr',\n    'clientName': 'Test Client',\n    'clientPhone': '00000000',\n    'clientEmail': 'test@test.com',\n    'callbackUrl': 'http://your_callback_url',\n    'successUrl': 'http://your_success_url?orderId=order12345',\n    'failUrl': 'http://your_failUrl_url?orderId=order12345'\n}\n\ncreate_payment_response = finergy_sdk.create_payment(payment_data=payment_data)\n\npayment_id = create_payment_response['paymentId']\ncheckout_page = create_payment_response['checkoutPage']\n```\n\n### Validate callback signature\n\n```python\ncallback_data = {\n    'result': {\n        'terminalId': 'TRMW0001',\n        'orderId': '108',\n        'paymentId': '2a663962-c954-4984-90e5-1d24c3305f7b',\n        'status': 'EXPIRED',\n        'amount': 1775.00,\n        'currency': 'MDL',\n        'paymentType': 'qr',\n        'paymentDate': '2024-12-17T11:54:23'\n    },\n    'signature': 'gtWkQdF2X2oCwO/+a+DJxpDc5DhjC1PMVWrnCXsCX54qOo24siRTy4PAjHoYet1r0KERVEL65p7UZuHcaK+TOiJptlalMUVZWbGLPf05WpyKPOPSPI1P4ZoADzJpceYsKjjZImB/+ft6OAF+ahxazhHkiT1Ze05vwD2L1D6zRohcxZl9XRJMChZcVD9bdNy23ozwuq6FwlnneJJeCPNvqveg7f5e0CD1NXWdLJ3WryP0ypcGtQGZAY+PrhkdVG5SWhYr0FFniAZIrp9yOFn3vrsUP4rpZmeqIahSV6x12pyyRsm+bs/tjw/kPR34ygG7ksXsrpwhQbltAHWeWwnOmg=='\n}\n\nvalidate_result = finergy_sdk.validate_callback_signature(callback_data=callback_data)\n```\n\n### Get payment status\n\n```python\npayment_status_response = finergy_sdk.get_payment_status(payment_id=payment_id)\n```\n\nFor more examples see [Finergy MIA POS PHP SDK](https://github.com/finergy-tech/mia-pay-ecomm-php-sdk)\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Python SDK for Finergy MIA POS eComm API",
    "version": "1.1.0",
    "project_urls": {
        "Documentation": "https://github.com/finergy-tech/mia-pay-ecomm-integration",
        "Homepage": "https://github.com/alexminza/finergy-mia-pos-sdk-python",
        "Issues": "https://github.com/alexminza/finergy-mia-pos-sdk-python/issues",
        "Repository": "https://github.com/alexminza/finergy-mia-pos-sdk-python"
    },
    "split_keywords": [
        "finergy",
        " moldova",
        " mia",
        " pos",
        " qr",
        " payments",
        " api",
        " sdk",
        " python"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "cdc587540baef77869d1a672ffa805e510d2107ae6f1b32b72641ee001495485",
                "md5": "44eecf4bd8e583fbf77d5c969dee5437",
                "sha256": "28999f76edcd255495dc0f0f853ceedb1f1f0c0fb01afba682c12b4758b98035"
            },
            "downloads": -1,
            "filename": "finergy_mia_pos_sdk-1.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "44eecf4bd8e583fbf77d5c969dee5437",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 22402,
            "upload_time": "2025-09-02T09:26:55",
            "upload_time_iso_8601": "2025-09-02T09:26:55.477532Z",
            "url": "https://files.pythonhosted.org/packages/cd/c5/87540baef77869d1a672ffa805e510d2107ae6f1b32b72641ee001495485/finergy_mia_pos_sdk-1.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "51ac458f4f4220ac4480dce2bf716ba3d1312fd5b156dfb5d706235942b3cd99",
                "md5": "56d04307d2deb1779f185acfc0ff641a",
                "sha256": "8aab5e6e75dfcd70412a15b6f237c1b219ecb0194b5d96dbc0b93fa8e0131faf"
            },
            "downloads": -1,
            "filename": "finergy_mia_pos_sdk-1.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "56d04307d2deb1779f185acfc0ff641a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 21712,
            "upload_time": "2025-09-02T09:26:56",
            "upload_time_iso_8601": "2025-09-02T09:26:56.950537Z",
            "url": "https://files.pythonhosted.org/packages/51/ac/458f4f4220ac4480dce2bf716ba3d1312fd5b156dfb5d706235942b3cd99/finergy_mia_pos_sdk-1.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-09-02 09:26:56",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "finergy-tech",
    "github_project": "mia-pay-ecomm-integration",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "finergy-mia-pos-sdk"
}