iyzico-mcp

MCP server for iyzico payment gateway (Turkey). Supports payments, refunds, checkout forms, sub-merchants, and 3D Secure via HMAC authentication.

Tools (8)

Tool	Description
`create_payment`	Create a payment with card details
`retrieve_payment`	Get payment details by ID
`cancel_payment`	Cancel a payment
`refund_payment`	Refund a payment transaction
`create_checkout_form`	Create a hosted checkout form
`retrieve_checkout_form`	Get checkout form result by token
`create_sub_merchant`	Register a sub-merchant for marketplace
`create_threeds_payment`	Initialize a 3D Secure payment

Quick Start

{
  "mcpServers": {
    "iyzico": {
      "command": "npx",
      "args": ["-y", "@theyahia/iyzico-mcp"],
      "env": {
        "IYZICO_API_KEY": "<YOUR_API_KEY>",
        "IYZICO_SECRET_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`IYZICO_API_KEY`	Yes	API key from iyzico dashboard
`IYZICO_SECRET_KEY`	Yes	Secret key from iyzico dashboard
`IYZICO_SANDBOX`	No	Set to "true" to use sandbox API

Demo Prompts

"Create a payment of 100 TRY for an online order"
"Check the status of payment pay_abc123"
"Cancel payment pay_xyz789"
"Refund 50 TRY from transaction pt_001"
"Create a checkout form for 250 TRY with callback to https://myshop.com/done"
"Register a new sub-merchant for my marketplace"

License

MIT

@theyahia/iyzico-mcp

Quick Install