{"_id":"@emreunes/medusa-payment-iyzico","name":"@emreunes/medusa-payment-iyzico","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@emreunes/medusa-payment-iyzico","version":"0.0.1","description":"Medusa v2 payment provider for iyzico Checkout Form.","author":{"name":"UNS Studios","email":"unesdevelopment@gmail.com"},"license":"MIT","publishConfig":{"access":"public"},"exports":{"./package.json":"./package.json","./workflows":"./.medusa/server/src/workflows/index.js","./.medusa/server/src/modules/*":"./.medusa/server/src/modules/*/index.js","./modules/*":"./.medusa/server/src/modules/*/index.js","./providers/*":"./.medusa/server/src/providers/*/index.js","./*":"./.medusa/server/src/*.js","./admin":{"import":"./.medusa/server/src/admin/index.mjs","require":"./.medusa/server/src/admin/index.js","default":"./.medusa/server/src/admin/index.js"}},"keywords":["medusa","medusa-plugin","medusa-v2","payment-provider","iyzico","checkout-form"],"scripts":{"build":"medusa plugin:build","dev":"medusa plugin:develop","prepublishOnly":"medusa plugin:build"},"devDependencies":{"@medusajs/admin-sdk":"2.14.2","@medusajs/cli":"2.14.2","@medusajs/framework":"2.14.2","@medusajs/icons":"2.14.2","@medusajs/medusa":"2.14.2","@medusajs/test-utils":"2.14.2","@medusajs/ui":"4.1.9","@swc/core":"^1.7.28","@types/node":"^20.0.0","@types/react":"^18.3.2","@types/react-dom":"^18.2.25","prop-types":"^15.8.1","react":"^18.2.0","react-dom":"^18.2.0","ts-node":"^10.9.2","typescript":"^5.6.2","vite":"^5.2.11","yalc":"^1.0.0-pre.53"},"peerDependencies":{"@medusajs/framework":"^2.14.2","@medusajs/medusa":"^2.14.2"},"engines":{"node":">=20"},"packageManager":"pnpm@10.32.1","_id":"@emreunes/medusa-payment-iyzico@0.0.1","gitHead":"3e8e7f473c919dd24a9bfcf1df0d012bcf8e1d8b","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-Mp06Kho0ISjHFizxQ9P1BK8p+Hr8wj0kf4/HZ1ZPr55bz/47pxWMAhmJEzCx/g2NrQVJbJxJJSPuJuqwx5KJOQ==","shasum":"2e2224cc4fd3d56556296e9da8bbc619787d802d","tarball":"https://registry.npmjs.org/@emreunes/medusa-payment-iyzico/-/medusa-payment-iyzico-0.0.1.tgz","fileCount":10,"unpackedSize":80436,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDlZL/TiM4fAHmTgaO25ZT3y0mRVPduF3r4OcR3oqrh6AiAkboc9Ht69Qi2z3MRkywKt9DDp6gV6SREEOIz2xr9dpw=="}]},"_npmUser":{"name":"emreunes","email":"unesdevelopment@gmail.com"},"directories":{},"maintainers":[{"name":"emreunes","email":"unesdevelopment@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/medusa-payment-iyzico_0.0.1_1777835566264_0.24604203234400757"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-03T19:12:46.186Z","0.0.1":"2026-05-03T19:12:46.396Z","modified":"2026-05-03T19:12:46.567Z"},"maintainers":[{"name":"emreunes","email":"unesdevelopment@gmail.com"}],"description":"Medusa v2 payment provider for iyzico Checkout Form.","keywords":["medusa","medusa-plugin","medusa-v2","payment-provider","iyzico","checkout-form"],"author":{"name":"UNS Studios","email":"unesdevelopment@gmail.com"},"license":"MIT","readme":"# @emreunes/medusa-payment-iyzico\n\nNOT OFFICIAL PACKAGE\n\nMedusa v2 payment provider for iyzico Checkout Form.\n\n## Install\n\n```bash\nnpm install @emreunes/medusa-payment-iyzico\n```\n\n## Configure\n\nRegister the provider in `medusa-config.ts`:\n\n```ts\nimport { defineConfig } from \"@medusajs/framework/utils\";\n\nexport default defineConfig({\n  modules: [\n    {\n      resolve: \"@medusajs/medusa/payment\",\n      options: {\n        providers: [\n          {\n            resolve: \"@emreunes/medusa-payment-iyzico/providers/iyzico\",\n            id: \"iyzico\",\n            options: {\n              apiKey: process.env.IYZICO_API_KEY,\n              secretKey: process.env.IYZICO_SECRET_KEY,\n              baseUrl: process.env.IYZICO_BASE_URL,\n              callbackUrl: process.env.IYZICO_CALLBACK_URL,\n            },\n          },\n        ],\n      },\n    },\n  ],\n});\n```\n\nFor sandbox, set `IYZICO_BASE_URL=https://sandbox-api.iyzipay.com`.\n\n## Callback URL\n\nPrefer Medusa's built-in payment hook endpoint:\n\n```text\nhttps://your-domain.com/hooks/payment/iyzico_iyzico\n```\n\nThe first `iyzico` is the provider service identifier. The second `iyzico`\nis the provider `id` from `medusa-config.ts`.\n\nA compatibility route is also included at:\n\n```text\nPOST /store/iyzico/checkout-form/callback\n```\n\nIf you use the compatibility route with a provider id other than `iyzico`, set:\n\n```bash\nIYZICO_MEDUSA_PROVIDER_ID=iyzico_your-provider-id\n```\n\n## Payment Data Requirements\n\nThe provider expects server-side code to pass these fields when a payment\nsession is initiated:\n\n- `session_id`, the Medusa payment session id. The provider stores this as iyzico `basketId` to correlate callbacks.\n- `ip` or `clientIp`\n- `buyer.name`, `buyer.surname`, and `buyer.email`, unless they are available from Medusa customer context\n- `billingAddress` and `shippingAddress`, unless billing address is available from Medusa customer context\n\nThe provider derives `price` and `paidPrice` from Medusa's payment amount. Do\nnot pass client-controlled amount fields.\nThe provider sends a single server-derived iyzico basket item for the cart total.\n\n## Security Notes\n\n- Response signatures from iyzico are verified for Checkout Form initialize, Checkout Form retrieve, and refund responses.\n- iyzico requests use direct REST calls with IYZWSv2 HMACSHA256 authentication.\n- Callback processing accepts POST only on the compatibility route.\n- Callback processing uses Medusa's Locking Module when available and falls back to in-process dedupe.\n- Supported currencies are `TRY`, `USD`, `EUR`, `GBP`, `NOK`, and `CHF`.\n- Multi-item refunds require an explicit `paymentTransactionId`.\n","readmeFilename":"README.md","_rev":"1-e14d09b16474f77b72fb67ad097490ed"}