{"id":13609801,"url":"https://github.com/iyzico/iyzipay-php","last_synced_at":"2026-02-08T17:43:43.465Z","repository":{"id":38333541,"uuid":"51745216","full_name":"iyzico/iyzipay-php","owner":"iyzico","description":"iyzipay api php client","archived":false,"fork":false,"pushed_at":"2024-05-28T12:32:41.000Z","size":1249,"stargazers_count":298,"open_issues_count":12,"forks_count":125,"subscribers_count":70,"default_branch":"master","last_synced_at":"2024-05-29T13:14:17.154Z","etag":null,"topics":["client-library","fintech","iyzico","iyzicoder","iyzipay","php-library"],"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/iyzico.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-02-15T09:39:01.000Z","updated_at":"2024-06-18T11:14:53.823Z","dependencies_parsed_at":"2024-06-18T11:14:51.903Z","dependency_job_id":"1c1875f6-9247-4c9c-882b-9a046bad74ab","html_url":"https://github.com/iyzico/iyzipay-php","commit_stats":{"total_commits":298,"total_committers":26,"mean_commits":"11.461538461538462","dds":"0.49328859060402686","last_synced_commit":"87df98ee79228e253e33fffcbd52f731ab5f31fb"},"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iyzico%2Fiyzipay-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iyzico%2Fiyzipay-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iyzico%2Fiyzipay-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iyzico%2Fiyzipay-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iyzico","download_url":"https://codeload.github.com/iyzico/iyzipay-php/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248630056,"owners_count":21136368,"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":["client-library","fintech","iyzico","iyzicoder","iyzipay","php-library"],"created_at":"2024-08-01T19:01:38.220Z","updated_at":"2026-02-08T17:43:38.414Z","avatar_url":"https://github.com/iyzico.png","language":"PHP","readme":"# iyzipay-php\n\n[![Latest Stable Version](https://poser.pugx.org/iyzico/iyzipay-php/version)](https://packagist.org/packages/iyzico/iyzipay-php)\n[![Coverage Status](https://coveralls.io/repos/github/iyzico/iyzipay-php/badge.svg?branch=master)](https://coveralls.io/github/iyzico/iyzipay-php?branch=master)\n\nYou can sign up for an iyzico account at https://iyzico.com\n\n# Requirements\n\nPHP 7.4 and later.\n\n### Note\n\nMinimum TLS v1.2 will be supported after March 2018. Please upgrade your openssl version to minimum 1.0.1. If you have any questions, please open an issue on Github or contact us at integration@iyzico.com.\n\n# Installation\n\n### Composer\n\nYou can install the bindings via [Composer](http://getcomposer.org/). Run the following command:\n\n```bash\ncomposer require iyzico/iyzipay-php\n```\n\nTo use the bindings, use Composer's [autoload](https://getcomposer.org/doc/00-intro.md#autoloading):\n\n```php\nrequire_once('vendor/autoload.php');\n```\n\n### Manual Installation\n\nIf you do not wish to use Composer, you can download the [latest release](https://github.com/iyzico/iyzipay-php/releases). Then, to use the bindings, include the `IyzipayBootstrap.php` file.\n\n```php\nrequire_once('/path/to/iyzipay-php/IyzipayBootstrap.php');\n```\n\n# Usage\n\n```php\n$options = new \\Iyzipay\\Options();\n$options-\u003esetApiKey(\"your api key\");\n$options-\u003esetSecretKey(\"your secret key\");\n$options-\u003esetBaseUrl(\"https://sandbox-api.iyzipay.com\");\n        \n$request = new \\Iyzipay\\Request\\CreatePaymentRequest();\n$request-\u003esetLocale(\\Iyzipay\\Model\\Locale::TR);\n$request-\u003esetConversationId(\"123456789\");\n$request-\u003esetPrice(\"1\");\n$request-\u003esetPaidPrice(\"1.2\");\n$request-\u003esetCurrency(\\Iyzipay\\Model\\Currency::TL);\n$request-\u003esetInstallment(1);\n$request-\u003esetBasketId(\"B67832\");\n$request-\u003esetPaymentChannel(\\Iyzipay\\Model\\PaymentChannel::WEB);\n$request-\u003esetPaymentGroup(\\Iyzipay\\Model\\PaymentGroup::PRODUCT);\n\n$paymentCard = new \\Iyzipay\\Model\\PaymentCard();\n$paymentCard-\u003esetCardHolderName(\"John Doe\");\n$paymentCard-\u003esetCardNumber(\"5528790000000008\");\n$paymentCard-\u003esetExpireMonth(\"12\");\n$paymentCard-\u003esetExpireYear(\"2030\");\n$paymentCard-\u003esetCvc(\"123\");\n$paymentCard-\u003esetRegisterCard(0);\n$request-\u003esetPaymentCard($paymentCard);\n\n$buyer = new \\Iyzipay\\Model\\Buyer();\n$buyer-\u003esetId(\"BY789\");\n$buyer-\u003esetName(\"John\");\n$buyer-\u003esetSurname(\"Doe\");\n$buyer-\u003esetGsmNumber(\"+905350000000\");\n$buyer-\u003esetEmail(\"email@email.com\");\n$buyer-\u003esetIdentityNumber(\"74300864791\");\n$buyer-\u003esetLastLoginDate(\"2015-10-05 12:43:35\");\n$buyer-\u003esetRegistrationDate(\"2013-04-21 15:12:09\");\n$buyer-\u003esetRegistrationAddress(\"Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1\");\n$buyer-\u003esetIp(\"85.34.78.112\");\n$buyer-\u003esetCity(\"Istanbul\");\n$buyer-\u003esetCountry(\"Turkey\");\n$buyer-\u003esetZipCode(\"34732\");\n$request-\u003esetBuyer($buyer);\n\n$shippingAddress = new \\Iyzipay\\Model\\Address();\n$shippingAddress-\u003esetContactName(\"Jane Doe\");\n$shippingAddress-\u003esetCity(\"Istanbul\");\n$shippingAddress-\u003esetCountry(\"Turkey\");\n$shippingAddress-\u003esetAddress(\"Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1\");\n$shippingAddress-\u003esetZipCode(\"34742\");\n$request-\u003esetShippingAddress($shippingAddress);\n\n$billingAddress = new \\Iyzipay\\Model\\Address();\n$billingAddress-\u003esetContactName(\"Jane Doe\");\n$billingAddress-\u003esetCity(\"Istanbul\");\n$billingAddress-\u003esetCountry(\"Turkey\");\n$billingAddress-\u003esetAddress(\"Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1\");\n$billingAddress-\u003esetZipCode(\"34742\");\n$request-\u003esetBillingAddress($billingAddress);\n\n$basketItems = array();\n$firstBasketItem = new \\Iyzipay\\Model\\BasketItem();\n$firstBasketItem-\u003esetId(\"BI101\");\n$firstBasketItem-\u003esetName(\"Binocular\");\n$firstBasketItem-\u003esetCategory1(\"Collectibles\");\n$firstBasketItem-\u003esetCategory2(\"Accessories\");\n$firstBasketItem-\u003esetItemType(\\Iyzipay\\Model\\BasketItemType::PHYSICAL);\n$firstBasketItem-\u003esetPrice(\"0.3\");\n$basketItems[0] = $firstBasketItem;\n\n$secondBasketItem = new \\Iyzipay\\Model\\BasketItem();\n$secondBasketItem-\u003esetId(\"BI102\");\n$secondBasketItem-\u003esetName(\"Game code\");\n$secondBasketItem-\u003esetCategory1(\"Game\");\n$secondBasketItem-\u003esetCategory2(\"Online Game Items\");\n$secondBasketItem-\u003esetItemType(\\Iyzipay\\Model\\BasketItemType::VIRTUAL);\n$secondBasketItem-\u003esetPrice(\"0.5\");\n$basketItems[1] = $secondBasketItem;\n\n$thirdBasketItem = new \\Iyzipay\\Model\\BasketItem();\n$thirdBasketItem-\u003esetId(\"BI103\");\n$thirdBasketItem-\u003esetName(\"Usb\");\n$thirdBasketItem-\u003esetCategory1(\"Electronics\");\n$thirdBasketItem-\u003esetCategory2(\"Usb / Cable\");\n$thirdBasketItem-\u003esetItemType(\\Iyzipay\\Model\\BasketItemType::PHYSICAL);\n$thirdBasketItem-\u003esetPrice(\"0.2\");\n$basketItems[2] = $thirdBasketItem;\n$request-\u003esetBasketItems($basketItems);\n\n$payment = \\Iyzipay\\Model\\Payment::create($request, $options);\n```\nSee other samples under samples directory.\n\n## Development\n\nInstall dependencies:\n\n``` bash\ncomposer install\n```\n\n### Mock test cards\n\nTest cards that can be used to simulate a *successful* payment:\n\nCard Number      | Bank                       | Card Type\n-----------      | ----                       | ---------\n5890040000000016 | Akbank                     | Master Card (Debit)  \n5526080000000006 | Akbank                     | Master Card (Credit)  \n4766620000000001 | Denizbank                  | Visa (Debit)  \n4603450000000000 | Denizbank                  | Visa (Credit)\n4729150000000005 | Denizbank Bonus            | Visa (Credit)  \n4987490000000002 | Finansbank                 | Visa (Debit)  \n5311570000000005 | Finansbank                 | Master Card (Credit)  \n9792020000000001 | Finansbank                 | Troy (Debit)  \n9792030000000000 | Finansbank                 | Troy (Credit)  \n5170410000000004 | Garanti Bankası            | Master Card (Debit)  \n5400360000000003 | Garanti Bankası            | Master Card (Credit)  \n374427000000003  | Garanti Bankası            | American Express  \n4475050000000003 | Halkbank                   | Visa (Debit)  \n5528790000000008 | Halkbank                   | Master Card (Credit)  \n4059030000000009 | HSBC Bank                  | Visa (Debit)  \n5504720000000003 | HSBC Bank                  | Master Card (Credit)  \n5892830000000000 | Türkiye İş Bankası         | Master Card (Debit)  \n4543590000000006 | Türkiye İş Bankası         | Visa (Credit)  \n4910050000000006 | Vakıfbank                  | Visa (Debit)  \n4157920000000002 | Vakıfbank                  | Visa (Credit)  \n5168880000000002 | Yapı ve Kredi Bankası      | Master Card (Debit)  \n5451030000000000 | Yapı ve Kredi Bankası      | Master Card (Credit)  \n\n*Cross border* test cards:\n\nCard Number      | Country\n-----------      | -------\n4054180000000007 | Non-Turkish (Debit)\n5400010000000004 | Non-Turkish (Credit)   \n\nTest cards to get specific *error* codes:\n\nCard Number       | Description\n-----------       | -----------\n5406670000000009  | Success but cannot be cancelled, refund or post auth\n4111111111111129  | Not sufficient funds\n4129111111111111  | Do not honour\n4128111111111112  | Invalid transaction\n4127111111111113  | Lost card\n4126111111111114  | Stolen card\n4125111111111115  | Expired card\n4124111111111116  | Invalid cvc2\n4123111111111117  | Not permitted to card holder\n4122111111111118  | Not permitted to terminal\n4121111111111119  | Fraud suspect\n4120111111111110  | Pickup card\n4130111111111118  | General error\n4131111111111117  | Success but mdStatus is 0\n4141111111111115  | Success but mdStatus is 4\n4151111111111112  | 3dsecure initialize failed\n\n### Mock APM Accounts\n\nMock APM Accounts that can be used to simulate a payment with alternative payment method:\n\nAccount Holder Name     | Description\n-------------------     | -----------\nsuccess                 | Succeeded payment after succeeded initialize\nfail-after-init         | Failed payment after succeeded initialize\nerror                   | Failed initialize\n\n# Testing\n\nInstall dependencies as mentioned above (which will resolve [PHPUnit](http://packagist.org/packages/phpunit/phpunit)), then you can run the test suite:\n\n```bash\n./vendor/bin/phpunit\n```\n\nOr to run an individual test file:\n\n```bash\n./vendor/bin/phpunit tests/Iyzipay/Tests/Model/PaymentTest.php\n```\nTest file is testing...\n","funding_links":[],"categories":["PHP"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiyzico%2Fiyzipay-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiyzico%2Fiyzipay-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiyzico%2Fiyzipay-php/lists"}