{"id":31765346,"url":"https://github.com/foris-master/orange-money-sdk","last_synced_at":"2025-10-10T00:15:46.409Z","repository":{"id":56982481,"uuid":"130274979","full_name":"Foris-master/orange-money-sdk","owner":"Foris-master","description":"orange-money-sdk","archived":false,"fork":false,"pushed_at":"2023-07-12T02:59:52.000Z","size":14,"stargazers_count":15,"open_issues_count":5,"forks_count":17,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-30T18:14:53.212Z","etag":null,"topics":["api","composer","mobile","money","orange","php","sdk"],"latest_commit_sha":null,"homepage":null,"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/Foris-master.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-04-19T21:34:52.000Z","updated_at":"2025-01-05T13:38:59.000Z","dependencies_parsed_at":"2022-08-21T08:40:34.401Z","dependency_job_id":null,"html_url":"https://github.com/Foris-master/orange-money-sdk","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/Foris-master/orange-money-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foris-master%2Forange-money-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foris-master%2Forange-money-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foris-master%2Forange-money-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foris-master%2Forange-money-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Foris-master","download_url":"https://codeload.github.com/Foris-master/orange-money-sdk/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foris-master%2Forange-money-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002388,"owners_count":26083356,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["api","composer","mobile","money","orange","php","sdk"],"created_at":"2025-10-10T00:15:41.614Z","updated_at":"2025-10-10T00:15:46.399Z","avatar_url":"https://github.com/Foris-master.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Orange Money Sdk \n\n[![Latest Version](https://img.shields.io/github/release/thephpleague/orange-money-sdk.svg?style=flat-square)](https://github.com/thephpleague/orange-money-sdk/releases)\n[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE.md)\n[![Build Status](https://img.shields.io/travis/thephpleague/orange-money-sdk/master.svg?style=flat-square)](https://travis-ci.org/thephpleague/orange-money-sdk)\n[![Coverage Status](https://img.shields.io/scrutinizer/coverage/g/thephpleague/orange-money-sdk.svg?style=flat-square)](https://scrutinizer-ci.com/g/thephpleague/orange-money-sdk/code-structure)\n[![Quality Score](https://img.shields.io/scrutinizer/g/thephpleague/orange-money-sdk.svg?style=flat-square)](https://scrutinizer-ci.com/g/thephpleague/orange-money-sdk)\n[![Total Downloads](https://img.shields.io/packagist/dt/league/orange-money-sdk.svg?style=flat-square)](https://packagist.org/packages/league/orange-money-sdk)\n\n**Note:**  `orange-money-sdk`.\n\nThis is a php sdk for orange operator mobile money api. \n\n## Install\n\nVia Composer\n\n``` bash\n$ composer require foris-master/orange-money-sdk\n```\n\n## Confing\n\n```\nSet AUTH_HEADER, MERCHANT_KEY,RETURN_URL,CANCEL_URL,NOTIF_URL enviroment variable ( .env file if using dotenv),\nyou get all related to you console at https://developer.orange.com/\n ```\n## Usage\n\n``` php\nuse Foris\\OmSdk\\OmSdk;\n\n$om = new OmSdk();\n// QuickStart\n/**\n * You need to set AUTH_HEADER, MERCHANT_KEY,RETURN_URL,CANCEL_URL,NOTIF_URL\n * enviroment variable ( .env file if using dotenv)\n */\n$om-\u003ewebPayment(['amount'=\u003e100]);\n// Full Options\n$opt=[\n        \"merchant_key\"=\u003e '********',\n        \"currency\"=\u003e \"OUV\",\n        \"order_id\"=\u003e $id,\n        \"amount\"=\u003e 0,\n        \"return_url\"=\u003e 'http://www.you-site.com/callback/return',\n        \"cancel_url\"=\u003e 'http://www.you-site.com/callback/cancel',\n        \"notif_url\"=\u003e'http://www.you-site.com/callback/notif',\n        \"lang\"=\u003e \"fr\"\n    ];\n$om-\u003ewebPayment($opt);\n```\n\n## API\n\n### Get token\n\n``` php\nuse Foris\\OmSdk\\OmSdk;\n\n$om = new OmSdk();\n\n$rep= $om-\u003egetToken();\nvar_dump($rep);\n// var_dump result\n[\n        \"token_type\"=\u003e 'Bearer',\n        \"access_token\"=\u003e \"0213GH123l12kj312k\",\n        \"expires_in\"=\u003e \"7776000\",\n];\n\n```\n### Web Payment\n\n``` php\nuse Foris\\OmSdk\\OmSdk;\n\n$om = new OmSdk();\n$opt = [\n               \"merchant_key\"=\u003e '********',\n               \"currency\"=\u003e \"OUV\",\n               \"order_id\"=\u003e $id,\n               \"amount\"=\u003e 0,\n               \"return_url\"=\u003e 'http://www.you-site.com/callback/return',\n               \"cancel_url\"=\u003e 'http://www.you-site.com/callback/cancel',\n               \"notif_url\"=\u003e'http://www.you-site.com/callback/notif',\n               \"lang\"=\u003e \"fr\"\n           ];\n$rep= $om-\u003ewebPayment($opt);\nvar_dump($rep);\n// var_dump result\n[\n        \"status\"=\u003e 201,\n        \"message\"=\u003e \"OK\",\n        \"pay_token\"=\u003e \"87a9f2f8ebca97sdfdsbb49795f77981f5be1face7b6a543c8a1304d81e4299fd\",\n        \"payment_url\"=\u003e\"https://webpayment-sb.orange-money.com/payment/pay_token/87a9f2f8ebca97sdfdsbb49795f77981f5be1face7b6a543c8a1304d81e4299fd\"\n        \"notif_token\"=\u003e \"793d6157d9c7d52ae3920dc596956206\"\n];\n```\n\n#### Note\nwebPayment method automatically call getToken and set it in request header.\n\n### Transaction Status\n\n``` php\nuse Foris\\OmSdk\\OmSdk;\n\n$om = new OmSdk();\n\n$rep= $om-\u003echeckTransactionStatus($orderId,$amount,$pay_token);\nvar_dump($rep);\n// var_dump result\n[\n         \"status\" =\u003e \"SUCCESS\",\n         \"order_id\" =\u003e \"MY_ORDER_ID_08082105_0023457\",\n         \"txnid\" =\u003e \"MP150709.1341.A00073\"\n];\n```\n#### Note\nThe status could take one of the following values: INITIATED; PENDING; EXPIRED; SUCCESS; FAILED\n- INITIATED waiting for user entry\n- PENDING user has clicked on “Confirmer”, transaction is in progress on Orange side\n- EXPIRED user has clicked on “Confirmer” too late (after token’s validity)\n- SUCCESS payment is done\n- FAILED payment has failed\n\n## Production\n\n```\n  For production your need to set your target country code in COUNTRY enviroment variable ( .env file if using dotenv)\n  example : COUNTRY=cm\n```\n## Testing\n\n``` bash\n$ phpunit\n```\n\n## Contributing\n\nPlease see [CONTRIBUTING](https://github.com/thephpleague/:package_name/blob/master/CONTRIBUTING.md) for details.\n\n## Credits\n\n- [foris-master](https://github.com/foris-master)\n- [All Contributors](https://github.com/thephpleague/:package_name/contributors)\n- [Orange dev team](https://developer.orange.com/apis/om-webpay/)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforis-master%2Forange-money-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fforis-master%2Forange-money-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforis-master%2Forange-money-sdk/lists"}