iyzico

API

Turkish payments API for cards, installments, subscriptions and marketplaces

Price: Fee per transaction
Access: API key and secret key, HMAC-signed

About

iyzico is a licensed Turkish payment institution with APIs for card payments with installments and 3D Secure, a hosted checkout form, subscriptions, marketplace split payments and payment links. The payment APIs need a business registered in Turkey and HMAC-signed requests.

What you can do with it

Take card payments with installments through the hosted Checkout Form or the API
Charge customers on recurring plans with products, pricing plans and free trials
Split marketplace payments between the platform and sellers paid out by IBAN

Get started

Register a sandbox merchant account
Copy the API key and secret key from Settings > Merchant Settings
Point an official SDK at https://sandbox-api.iyzipay.com

Example

const Iyzipay = require('iyzipay');
const iyzipay = new Iyzipay({
  apiKey: process.env.IYZIPAY_API_KEY,
  secretKey: process.env.IYZIPAY_SECRET_KEY,
  uri: 'https://sandbox-api.iyzipay.com'
});

iyzipay.checkoutFormInitialize.create({
  locale: Iyzipay.LOCALE.TR,
  price: '1',
  paidPrice: '1.2',
  currency: Iyzipay.CURRENCY.TRY,
  callbackUrl: 'https://www.merchant.com/callback',
  buyer: {
    id: 'BY789', name: 'John', surname: 'Doe', gsmNumber: '+905350000000',
    email: 'email@email.com', identityNumber: '74300864791',
    registrationAddress: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
    city: 'Istanbul', country: 'Turkey'
  },
  billingAddress: {
    contactName: 'Jane Doe', city: 'Istanbul', country: 'Turkey',
    address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1'
  },
  basketItems: [{ id: 'BI102', name: 'Game code', category1: 'Game',
    itemType: Iyzipay.BASKET_ITEM_TYPE.VIRTUAL, price: '1' }]
}, (err, result) => console.log(err || result.paymentPageUrl));

Details

Hosting: Hosted service
Available in: Türkiye
Official SDKs: JavaScript/TypeScript, PHP, Python, Java, C#
MCP server: None
Works with: WooCommerce, Shopify, Wix