{"id":15296281,"url":"https://github.com/spacetab-io/uniteller-php-sdk","last_synced_at":"2025-04-13T19:40:33.513Z","repository":{"id":49950862,"uuid":"83773543","full_name":"spacetab-io/uniteller-php-sdk","owner":"spacetab-io","description":"PHP (7.2+) SDK for integration internet-acquiring of the Uniteller (unofficial)","archived":false,"fork":false,"pushed_at":"2025-02-03T09:22:38.000Z","size":107,"stargazers_count":21,"open_issues_count":1,"forks_count":10,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-27T10:21:14.393Z","etag":null,"topics":["acquiring","internet-acquiring","payment","payments","payum","php","php7","processing","sdk","sdk-php","uniteller","uniteller-php-sdk"],"latest_commit_sha":null,"homepage":"https://www.uniteller.ru/en/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spacetab-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-03T08:02:31.000Z","updated_at":"2025-03-11T18:22:22.000Z","dependencies_parsed_at":"2022-08-27T08:40:37.719Z","dependency_job_id":null,"html_url":"https://github.com/spacetab-io/uniteller-php-sdk","commit_stats":null,"previous_names":["tmconsulting/uniteller-php-sdk"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacetab-io%2Funiteller-php-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacetab-io%2Funiteller-php-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacetab-io%2Funiteller-php-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacetab-io%2Funiteller-php-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spacetab-io","download_url":"https://codeload.github.com/spacetab-io/uniteller-php-sdk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248770098,"owners_count":21158909,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["acquiring","internet-acquiring","payment","payments","payum","php","php7","processing","sdk","sdk-php","uniteller","uniteller-php-sdk"],"created_at":"2024-09-30T18:09:57.071Z","updated_at":"2025-04-13T19:40:33.480Z","avatar_url":"https://github.com/spacetab-io.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Uniteller PHP SDK\n\n\u003cbr /\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://lk.uniteller.ru/images/ulogo.png\" width=\"128\" alt=\"Uniteller\" /\u003e\n\u003c/p\u003e\n\n\u003cbr /\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://travis-ci.org/tmconsulting/uniteller-php-sdk\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://travis-ci.org/tmconsulting/uniteller-php-sdk.svg?branch=master\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://packagist.org/packages/tmconsulting/uniteller-php-sdk\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://poser.pugx.org/tmconsulting/uniteller-php-sdk/v/stable\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://packagist.org/packages/tmconsulting/uniteller-php-sdk\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://poser.pugx.org/tmconsulting/uniteller-php-sdk/license\" /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr /\u003e\n\nPHP (7.2+) SDK for integration internet-acquiring of the Uniteller (unofficial).\n[This documentation is available in Russian language](README_RU.md).\nAlso, this SDK integrated with [Payum](https://github.com/Payum/Payum) library and you can use [gateway](https://github.com/tmconsulting/payum-uniteller-gateway).\n\nFeatures:\n* payment (method `pay`)\n* recurrent (method `recurrent`)\n* cancel (method `unblock`)\n* receive results\n* callback (method for verify incoming signature)\n* general error handler for any request\n* general statuses (In the requests/responses may to meet `canceled` or `cancelled` variants. They will be converted to general status like as `cancelled`.)\n\nTODO:\n* translate to English comments and system (error) messages\n* validation\n* implement method `card`\n* implement method `confirm` \n\n## Install\n\nFor install package follow this command:\n\n`composer require tmconsulting/uniteller-php-sdk`\n\n## Usage\n\nA few usage example the current SDK your can found on the `examples` folder. \nJust follow instruction on `README.md` file. \n\n### Configure credentials  \n\n```php\n\u003c?php\n$uniteller = new \\Tmconsulting\\Uniteller\\Client();\n$uniteller-\u003esetShopId('you_shop_id');\n$uniteller-\u003esetLogin('you_login_number');\n$uniteller-\u003esetPassword('you_password');\n$uniteller-\u003esetBaseUri('https://wpay.uniteller.ru');\n```\n\n### Redirect to page payment \n\nSo, for redirect to page your enough to run `payment` method with parameters like as:\n\n```php\n\u003c?php\nuse Tmconsulting\\Uniteller\\Payment\\PaymentBuilder;\n\n$builder = new PaymentBuilder();\n$builder\n    -\u003esetOrderIdp(mt_rand(10000, 99999))\n    -\u003esetSubtotalP(10)\n    -\u003esetCustomerIdp(mt_rand(10000, 99999))\n    -\u003esetUrlReturnOk('http://google.ru/?q=success')\n    -\u003esetUrlReturnNo('http://google.ru/?q=failure');\n\n$uniteller-\u003epayment($builder)-\u003ego();\n// if you don't need redirect\n// $uniteller-\u003epayment($builder)-\u003egetUri();\n\n```\n\nor use plain array\n\n```php\n\u003c?php\n$uniteller-\u003epayment([\n    'Order_IDP' =\u003e mt_rand(10000, 99999),\n    // ... other parameters\n])-\u003ego();\n```\n\n### Recurrent payment\n \n```php\n\u003c?php\nuse Tmconsulting\\Uniteller\\Recurrent\\RecurrentBuilder;\n\n$builder = (new RecurrentBuilder())\n    -\u003esetOrderIdp(mt_rand(10000, 99999))\n    -\u003esetSubtotalP(15)\n    -\u003esetParentOrderIdp(00000) // order id of any past payment\n    -\u003esetParentShopIdp($uniteller-\u003egetShopId()); // optional\n\n$results = $uniteller-\u003erecurrent($builder);\n```\n\nor use plain array\n\n```php\n\u003c?php\n$results = $uniteller-\u003erecurrent([\n    'Order_IDP' =\u003e mt_rand(10000, 99999),\n    // ... other parameters\n]);\n```\n\n### Cancel payment\n \n```php\n\u003c?php\nuse Tmconsulting\\Uniteller\\Cancel\\CancelBuilder;\n\n$builder = (new CancelBuilder())-\u003esetBillNumber('RRN Number, (12 digits)');\n$results = $uniteller-\u003ecancel($builder);\n```\n\nor\n\n```php\n\u003c?php\nuse Tmconsulting\\Uniteller\\Order\\Status;\n\n$results = $uniteller-\u003ecancel([\n    'Billnumber' =\u003e 'RRN Number, (12 digits)',\n    // ...\n]);\n\nforeach ($results as $payment) {\n    // see Tmconsulting\\Uniteller\\Order\\Order for other methods.\n    if ($payment-\u003egetStatus() === Status::CANCELLED) {\n        // payment was cancelled\n    }    \n} \n```\n\n### Receive results\n\n```php\n\u003c?php\n\n$results = $uniteller-\u003eresults([\n    'ShopOrderNumber' =\u003e 'Order_IDP number'\n]);\n\nvar_dump($results);\n\n// $results[0]-\u003egetCardNumber();\n```\n\n### Callback (gateway notification)\n\nReceive incoming parameters from gateway and verifying signature. \n\n```php\n\u003c?php\nif (! $uniteller-\u003everifyCallbackRequest(['all_parameters_from_post_with_signature'])) {\n    return 'invalid_signature';\n}\n```\n\n## Tests\n\n`vendor/bin/phpunit`\n\n## License\n\nMIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacetab-io%2Funiteller-php-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspacetab-io%2Funiteller-php-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacetab-io%2Funiteller-php-sdk/lists"}