### Start Express Server with Node.js

Source: https://dev.paytr.com/iframe-api/iframe-api-2-adim

This is a standard Node.js Express server setup that listens for incoming connections on a specified port. It logs a message to the console once the server is successfully running. This snippet is typically used at the end of an Express application to initiate the web server.

```javascript
var port = 3000;
app.listen(port, function () {
    console.log("Server is running. Port:" + port);
});
```

--------------------------------

### PayTR API Response Examples (JSON)

Source: https://dev.paytr.com/iframe-api/iframe-api-1-adim

These examples show the expected JSON responses from the PayTR API when requesting an iFrame token. A successful response includes a 'status' of 'success' and the 'token'. A failed response includes a 'status' of 'failed' and a 'reason' explaining the error.

```json
{
  "status": "success",
  "token": "28cc613c3d7633cfa4ed0956fdf901e05cf9d9cc0c2ef8db54fa"
}
```

```json
{
  "status": "failed",
  "reason": "Zorunlu alan degeri gecersiz: merchant_id"
}
```

--------------------------------

### Python: Configure PayTR Payment Parameters

Source: https://dev.paytr.com/iframe-api/iframe-api-1-adim

This Python 3.6+ code snippet sets up the necessary parameters for a PayTR payment transaction. It includes essential merchant details, customer information (email, name, address, phone), payment amount, order ID, URLs for success and failure, and basket details. It also configures test mode, installment options, currency, and IP address, which is crucial for local testing. The code comments provide guidance on how to format certain parameters like `user_basket` and emphasize the importance of using the correct IP for local development.

```python
# Python 3.6+
# 1. ADIM için örnek kodlar

import base64
import hmac
import hashlib
import requests
import json

# API Entegrasyon Bilgileri - Mağaza paneline giriş yaparak BİLGİ sayfasından alabilirsiniz.
merchant_id = 'XXXXXX'
merchant_key = b'YYYYYYYYYYYYYY'
merchant_salt = b'ZZZZZZZZZZZZZZ'

# Müşterinizin sitenizde kayıtlı veya form vasıtasıyla aldığınız eposta adresi
email = 'XXXXXXXX'

# Tahsil edilecek tutar. 
payment_amount = '' # 9.99 için 9.99 * 100 = 999 gönderilmelidir.

# Sipariş numarası: Her işlemde benzersiz olmalıdır!! Bu bilgi bildirim sayfanıza yapılacak bildirimde geri gönderilir.
merchant_oid = ''

# Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız ad ve soyad bilgisi
user_name = ''

# Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız adres bilgisi
user_address = ''

# Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız telefon bilgisi
user_phone = ''

# Başarılı ödeme sonrası müşterinizin yönlendirileceği sayfa
# !!! Bu sayfa siparişi onaylayacağınız sayfa değildir! Yalnızca müşterinizi bilgilendireceğiniz sayfadır!
# !!! Siparişi onaylayacağız sayfa "Bildirim URL" sayfasıdır (Bakınız: 2.ADIM Klasörü).
merchant_ok_url = 'http://www.siteniz.com/odeme_basarili.php'

# Ödeme sürecinde beklenmedik bir hata oluşması durumunda müşterinizin yönlendirileceği sayfa
# !!! Bu sayfa siparişi iptal edeceğiniz sayfa değildir! Yalnızca müşterinizi bilgilendireceğiniz sayfadır!
# !!! Siparişi iptal edeceğiniz sayfa "Bildirim URL" sayfasıdır (Bakınız: 2.ADIM Klasörü).
merchant_fail_url = 'http://www.siteniz.com/odeme_hata.php'

# Müşterinin sepet/sipariş içeriği
user_basket = ''

# ÖRNEK $user_basket oluşturma - Ürün adedine göre array'leri çoğaltabilirsiniz
"""
user_basket = base64.b64encode(json.dumps([['Örnek ürün 1', '18.00', 1],
               ['Örnek ürün 2', '33.25', 2],
               ['Örnek ürün 3', '45.42', 1]]).encode())
"""

# !!! Eğer bu örnek kodu sunucuda değil local makinanızda çalıştırıyorsanız
# buraya dış ip adresinizi (https://www.whatismyip.com/) yazmalısınız. Aksi halde geçersiz paytr_token hatası alırsınız.
user_ip = ''

# İşlem zaman aşımı süresi - dakika cinsinden
timeout_limit = '30'

# Hata mesajlarının ekrana basılması için entegrasyon ve test sürecinde 1 olarak bırakın. Daha sonra 0 yapabilirsiniz.
debug_on = '1'

# Mağaza canlı modda iken test işlem yapmak için 1 olarak gönderilebilir.
test_mode = '1'

no_installment = '0' # Taksit yapılmasını istemiyorsanız, sadece tek çekim sunacaksanız 1 yapın

# Sayfada görüntülenecek taksit adedini sınırlamak istiyorsanız uygun şekilde değiştirin.
# Sıfır (0) gönderilmesi durumunda yürürlükteki en fazla izin verilen taksit geçerli olur.
max_installment = '0'

currency = 'TL'

```

--------------------------------

### PayTR Ödeme Formunu Görüntüleme (HTML)

Source: https://dev.paytr.com/iframe-api/iframe-api-1-adim

Bu HTML kod parçacığı, PayTR ödeme formunu bir iframe içinde güvenli bir şekilde görüntülemek için kullanılır. `iframeResizer.min.js` kütüphanesi, iframe'in içeriğine göre boyutunu otomatik olarak ayarlamasını sağlar. `src` özelliğindeki URL, PayTR'ın güvenli ödeme sayfasına yönlendirir ve `{ token }` yerine, Python koduyla alınan ödeme token'ı eklenmelidir. Bu sayede kullanıcı, web sitenizden ayrılmadan ödeme işlemini tamamlayabilir.

```html
<script src="https://www.paytr.com/js/iframeResizer.min.js"></script>
<iframe src="https://www.paytr.com/odeme/guvenli/{ token }" id="paytriframe" frameborder="0" scrolling="no" style="width: 100%;"></iframe>
<script>iFrameResize({},'#paytriframe');</script>
```

--------------------------------

### Node.js PayTR Iframe API Setup and Configuration

Source: https://dev.paytr.com/iframe-api/iframe-api-yeni-tasarim

This Node.js snippet sets up an Express.js application and configures it to use EJS layouts and middleware for handling JSON and URL-encoded data. It also defines essential merchant credentials and payment parameters required for PayTR API integration, such as `merchant_id`, `merchant_key`, `user_basket`, and various URLs.

```javascript
var express = require('express');
var ejsLayouts = require('express-ejs-layouts');
var microtime = require('microtime');
var crypto = require('crypto');
var app = express();
var nodeBase64 = require('nodejs-base64-converter');
var request = require('request');
var path = require('path');

app.set('views', path.join(__dirname, '/app_server/views'));

app.set('view engine', 'ejs');
app.use(ejsLayouts);
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

var merchant_id = 'XXXXXX';
var merchant_key = 'YYYYYYYYYYYYYY';
var merchant_salt = 'ZZZZZZZZZZZZZZ';
var basket = JSON.stringify([
    ['Örnek Ürün 1', '18.00', 1],
    ['Örnek Ürün 2', '33.25', 2],
    ['Örnek Ürün 3', '45.42', 1]
]);
var user_basket = nodeBase64.encode(basket);
var merchant_oid = "IN" + microtime.now(); // Sipariş numarası: Her işlemde benzersiz olmalıdır!! Bu bilgi bildirim sayfanıza yapılacak bildirimde geri gönderilir.
// Sayfada görüntülenecek taksit adedini sınırlamak istiyorsanız uygun şekilde değiştirin.
// Sıfır (0) gönderilmesi durumunda yürürlükteki en fazla izin verilen taksit geçerli olur.
var max_installment = '0';
var no_installment = '0'  // Taksit yapılmasını istemiyorsanız, sadece tek çekim sunacaksanız 1 yapın.
var user_ip = '';
var email = 'XXXXXXXX'; // Müşterinizin sitenizde kayıtlı veya form vasıtasıyla aldığınız eposta adresi.
var payment_amount = 100; // Tahsil edilecek tutar. 9.99 için 9.99 * 100 = 999 gönderilmelidir.
var currency = 'TL';
var test_mode = '0'; // Mağaza canlı modda iken test işlem yapmak için 1 olarak gönderilebilir.
var user_name = ''; // Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız ad ve soyad bilgisi
var user_address = ''; // Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız adres bilgisi
var user_phone = '05555555555'; // Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız telefon bilgisi

// Başarılı ödeme sonrası müşterinizin yönlendirileceği sayfa
// Bu sayfa siparişi onaylayacağınız sayfa değildir! Yalnızca müşterinizi bilgilendireceğiniz sayfadır!
var merchant_ok_url = 'http://www.siteniz.com/odeme_basarili.php';
// Ödeme sürecinde beklenmedik bir hata oluşması durumunda müşterinizin yönlendirileceği sayfa
// Bu sayfa siparişi iptal edeceğiniz sayfa değildir! Yalnızca müşterinizi bilgilendireceğiniz sayfadır!
var merchant_fail_url = 'http://www.siteniz.com/odeme_hata.php';
var timeout_limit = 30; // İşlem zaman aşımı süresi - dakika cinsinden

```

--------------------------------

### PHP: Get PayTR Iframe Token and Display Payment Form

Source: https://dev.paytr.com/iframe-api/iframe-api-1-adim

This PHP snippet demonstrates how to make a POST request to the PayTR API to obtain an iframe token. It includes setting up POST data, configuring cURL options (including SSL verification options for local testing), executing the request, handling potential cURL errors, decoding the JSON response, and extracting the token. Finally, it embeds an iframe using the obtained token and initializes the iFrameResizer library to ensure the iframe resizes correctly. It also includes basic error handling for API failures.

```php
<?php

            'max_installment'=>$max_installment,
            'user_name'=>$user_name,
            'user_address'=>$user_address,
            'user_phone'=>$user_phone,
            'merchant_ok_url'=>$merchant_ok_url,
            'merchant_fail_url'=>$merchant_fail_url,
            'timeout_limit'=>$timeout_limit,
            'currency'=>$currency,
            'test_mode'=>$test_mode
        );

    $ch=curl_init();
    curl_setopt($ch, CURLOPT_URL, "https://www.paytr.com/odeme/api/get-token");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1) ;
    curl_setopt($ch, CURLOPT_POSTFIELDS, $post_vals);
    curl_setopt($ch, CURLOPT_FRESH_CONNECT, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 20);

     // XXX: DİKKAT: lokal makinanızda "SSL certificate problem: unable to get local issuer certificate" uyarısı alırsanız eğer
     // aşağıdaki kodu açıp deneyebilirsiniz. ANCAK, güvenlik nedeniyle sunucunuzda (gerçek ortamınızda) bu kodun kapalı kalması çok önemlidir!
     // curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);

    $result = @curl_exec($ch);

    if(curl_errno($ch))
        die("PAYTR IFRAME connection error. err:".curl_error($ch));

    curl_close($ch);

    $result=json_decode($result,1);

    if($result['status']=='success')
        $token=$result['token'];
    else
        die("PAYTR IFRAME failed. reason:".$result['reason']);
    #########################################################################

    ?>

    <!-- Ödeme formunun açılması için gereken HTML kodlar / Başlangıç -->
    <script src="https://www.paytr.com/js/iframeResizer.min.js"></script>
    <iframe src="https://www.paytr.com/odeme/guvenli/<?php echo $token;?>" id="paytriframe" frameborder="0" scrolling="no" style="width: 100%;">
    <script>iFrameResize({},'#paytriframe');</script>
    <!-- Ödeme formunun açılması için gereken HTML kodlar / Bitiş -->

</div>

<br><br>
</body>
</html>
```

--------------------------------

### C# PayTR Ödeme Formu Oluşturma ve Gönderilecek Verileri Hazırlama

Source: https://dev.paytr.com/iframe-api/iframe-api-1-adim

Bu kod, PayTR ödeme formunu oluşturmak için gerekli olan temel verileri hazırlar. API entegrasyon bilgileri, müşteri bilgileri, ödeme tutarı ve sipariş numarası gibi alanlar tanımlanır. Ayrıca, kullanıcıdan alınan IP adresi, işlem zaman aşımı ve test modu gibi ayarlar da yapılır. Bu veriler daha sonra API isteği için kullanılır.

```csharp
using Newtonsoft.Json.Linq; // Bu satırda hata alırsanız, site dosyalarınızın olduğu bölümde bin isimli bir klasör oluşturup içerisine Newtonsoft.Json.dll adlı DLL dosyasını kopyalayın.
using System;
using System.Collections.Generic;
using System.Collections.Specialized;
using System.Linq;
using System.Net;
using System.Security.Cryptography;
using System.Text;
using System.Web;
using System.Web.Script.Serialization;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace WebApplication3
{
    public partial class _Default : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {

        // ####################### DÜZENLEMESİ ZORUNLU ALANLAR #######################
        //
        // API Entegrasyon Bilgileri - Mağaza paneline giriş yaparak BİLGİ sayfasından alabilirsiniz.
        string merchant_id = "XXXXXX";
        string merchant_key = "YYYYYYYYYYYYYY";
        string merchant_salt = "ZZZZZZZZZZZZZZ";
        //
        // Müşterinizin sitenizde kayıtlı veya form vasıtasıyla aldığınız eposta adresi
        string emailstr = "ZZZZZZZZZZZZZZ";
        //
        // Tahsil edilecek tutar. 9.99 için 9.99 * 100 = 999 gönderilmelidir.
        int payment_amountstr = ;
        //
        // Sipariş numarası: Her işlemde benzersiz olmalıdır!! Bu bilgi bildirim sayfanıza yapılacak bildirimde geri gönderilir.
        string merchant_oid = "";
        //
        // Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız ad ve soyad bilgisi
        string user_namestr = "";
        //
        // Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız adres bilgisi
        string user_addressstr = "";
        //
        // Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız telefon bilgisi
        string user_phonestr = "";
        //
        // Başarılı ödeme sonrası müşterinizin yönlendirileceği sayfa
        // !!! Bu sayfa siparişi onaylayacağınız sayfa değildir! Yalnızca müşterinizi bilgilendireceğiniz sayfadır!
        // !!! Siparişi onaylayacağız sayfa "Bildirim URL" sayfasıdır (Bakınız: 2.ADIM Klasörü).
        string merchant_ok_url = "http://www.siteniz.com/basarili";
        //
        // Ödeme sürecinde beklenmedik bir hata oluşması durumunda müşterinizin yönlendirileceği sayfa
        // !!! Bu sayfa siparişi iptal edeceğiniz sayfa değildir! Yalnızca müşterinizi bilgilendireceğiniz sayfadır!
        // !!! Siparişi iptal edeceğiniz sayfa "Bildirim URL" sayfasıdır (Bakınız: 2.ADIM Klasörü).
        string merchant_fail_url = "http://www.siteniz.com/basarisiz";
        //        
        // !!! Eğer bu örnek kodu sunucuda değil local makinanızda çalıştırıyorsanız
        // buraya dış ip adresinizi (https://www.whatismyip.com/) yazmalısınız. Aksi halde geçersiz paytr_token hatası alırsınız.
        string user_ip = Request.ServerVariables["HTTP_X_FORWARDED_FOR"];
        if (user_ip == "" || user_ip == null)
        {
            user_ip = Request.ServerVariables["REMOTE_ADDR"];
        }
        //
        // ÖRNEK user_basket oluşturma - Ürün adedine göre object'leri çoğaltabilirsiniz
        object[][] user_basket = {
            new object[] {"Örnek ürün 1", "18.00", 1}, // 1. ürün (Ürün Ad - Birim Fiyat - Adet)
            new object[] {"Örnek ürün 2", "33.25", 2}, // 2. ürün (Ürün Ad - Birim Fiyat - Adet)
            new object[] {"Örnek ürün 3", "45.42", 1}, // 3. ürün (Ürün Ad - Birim Fiyat - Adet)
            };
        /* ############################################################################################ */

        // İşlem zaman aşımı süresi - dakika cinsinden
        string timeout_limit = "30";
        //
        // Hata mesajlarının ekrana basılması için entegrasyon ve test sürecinde 1 olarak bırakın. Daha sonra 0 yapabilirsiniz.
        string debug_on = "1";
        //
        // Mağaza canlı modda iken test işlem yapmak için 1 olarak gönderilebilir.
        string test_mode = "1";
        //
        // Taksit yapılmasını istemiyorsanız, sadece tek çekim sunacaksanız 1 yapın
        string no_installment = "0";
        //
        // Sayfada görüntülenecek taksit adedini sınırlamak istiyorsanız uygun şekilde değiştirin.
        // Sıfır (0) gönderilmesi durumunda yürürlükteki en fazla izin verilen taksit geçerli olur.
        string max_installment = "0";
        //
        // Para birimi olarak TL, EUR, USD gönderilebilir. USD ve EUR kullanmak için kurumsal@paytr.com 
        // üzerinden bilgi almanız gerekmektedir. Boş gönderilirse TL geçerli olur.
        string currency = "TL";
        //
        // Türkçe için tr veya İngilizce için en gönderilebilir. Boş gönderilirse tr geçerli olur.
        string lang = "";

        // Gönderilecek veriler oluşturuluyor
        NameValueCollection data = new NameValueCollection();
        data["merchant_id"] = merchant_id;
        data["user_ip"] = user_ip;
    }
}
}
```

--------------------------------

### Initiate PayTR Payment in Node.js

Source: https://dev.paytr.com/iframe-api/iframe-api-1-adim

This Node.js code snippet sets up parameters for a PayTR payment transaction. It defines merchant credentials, order details, user information, and callback URLs. The user basket is base64 encoded, and a unique order ID is generated using microtime. This code prepares the data to be sent to the PayTR API for token generation. Dependencies include express, ejs-layouts, microtime, crypto, nodejs-base64-converter, request, and path.

```javascript
var merchant_id = 'XXXXXX';
var merchant_key = 'YYYYYYYYYYYYYY';
var merchant_salt = 'ZZZZZZZZZZZZZZ';
var basket = JSON.stringify([
    ['Örnek Ürün 1', '18.00', 1],
    ['Örnek Ürün 2', '33.25', 2],
    ['Örnek Ürün 3', '45.42', 1]
]);
var user_basket = nodeBase64.encode(basket);
var merchant_oid = "IN" + microtime.now(); // Sipariş numarası: Her işlemde benzersiz olmalıdır!! Bu bilgi bildirim sayfanıza yapılacak bildirimde geri gönderilir.
// Sayfada görüntülenecek taksit adedini sınırlamak istiyorsanız uygun şekilde değiştirin.
// Sıfır (0) gönderilmesi durumunda yürürlükteki en fazla izin verilen taksit geçerli olur.
var max_installment = '0';
var no_installment = '0'  // Taksit yapılmasını istemiyorsanız, sadece tek çekim sunacaksanız 1 yapın.
var user_ip = '';
var email = 'XXXXXXXX'; // Müşterinizin sitenizde kayıtlı veya form vasıtasıyla aldığınız eposta adresi.
var payment_amount = 100; // Tahsil edilecek tutar. 9.99 için 9.99 * 100 = 999 gönderilmelidir.
var currency = 'TL';
var test_mode = '0'; // Mağaza canlı modda iken test işlem yapmak için 1 olarak gönderilebilir.
var user_name = ''; // Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız ad ve soyad bilgisi
var user_address = ''; // Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız adres bilgisi
var user_phone = '05555555555'; // Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız telefon bilgisi

// Başarılı ödeme sonrası müşterinizin yönlendirileceği sayfa
// Bu sayfa siparişi onaylayacağınız sayfa değildir! Yalnızca müşterinizi bilgilendireceğiniz sayfadır!
var merchant_ok_url = 'http://www.siteniz.com/odeme_basarili.php';
// Ödeme sürecinde beklenmedik bir hata oluşması durumunda müşterinizin yönlendirileceği sayfa
// Bu sayfa siparişi iptal edeceğiniz sayfa değildir! Yalnızca müşterinizi bilgilendireceğiniz sayfadır!
var merchant_fail_url = 'http://www.siteniz.com/odeme_hata.php';
var timeout_limit = 30; // İşlem zaman aşımı süresi - dakika cinsinden
var debug_on = 1; // Hata mesajlarının ekrana basılması için entegrasyon ve test sürecinde 1 olarak bırakın. Daha sonra 0 yapabilirsiniz.
```

--------------------------------

### PHP ile PayTR Ödeme Bilgileri Hazırlama ve Token Oluşturma

Source: https://dev.paytr.com/iframe-api/iframe-api-1-adim

Bu kod parçacığı, PHP kullanarak PayTR ödeme entegrasyonunun ilk adımı olan gerekli bilgileri hazırlamak ve güvenli bir `paytr_token` oluşturmak için kullanılır. API anahtarları, sipariş detayları ve kullanıcı bilgileri gibi zorunlu alanların doğru şekilde doldurulması gerekmektedir. Token oluşturma işlemi, `merchant_key` ve `merchant_salt` kullanılarak `sha256` hash algoritması ile gerçekleştirilir.

```php
<?php

    ## 1. ADIM için örnek kodlar ##

    ####################### DÜZENLEMESİ ZORUNLU ALANLAR #######################
    #
    ## API Entegrasyon Bilgileri - Mağaza paneline giriş yaparak BİLGİ sayfasından alabilirsiniz.
    $merchant_id    = 'XXXXXX';
    $merchant_key   = 'YYYYYYYYYYYYYY';
    $merchant_salt  = 'ZZZZZZZZZZZZZZ';
    #
    ## Müşterinizin sitenizde kayıtlı veya form vasıtasıyla aldığınız eposta adresi
    $email = "XXXXXXXX";
    #
    ## Tahsil edilecek tutar. 
    $payment_amount = ""; //9.99 için 9.99 * 100 = 999 gönderilmelidir.
    #
    ## Sipariş numarası: Her işlemde benzersiz olmalıdır!! Bu bilgi bildirim sayfanıza yapılacak bildirimde geri gönderilir.
    $merchant_oid = "";
    #
    ## Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız ad ve soyad bilgisi
    $user_name = "";
    #
    ## Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız adres bilgisi
    $user_address = "";
    #
    ## Müşterinizin sitenizde kayıtlı veya form aracılığıyla aldığınız telefon bilgisi
    $user_phone = "";
    #
    ## Başarılı ödeme sonrası müşterinizin yönlendirileceği sayfa
    ## !!! Bu sayfa siparişi onaylayacağınız sayfa değildir! Yalnızca müşterinizi bilgilendireceğiniz sayfadır!
    ## !!! Siparişi onaylayacağız sayfa "Bildirim URL" sayfasıdır (Bakınız: 2.ADIM Klasörü).
    $merchant_ok_url = "http://www.siteniz.com/odeme_basarili.php";
    #
    ## Ödeme sürecinde beklenmedik bir hata oluşması durumunda müşterinizin yönlendirileceği sayfa
    ## !!! Bu sayfa siparişi iptal edeceğiniz sayfa değildir! Yalnızca müşterinizi bilgilendireceğiniz sayfadır!
    ## !!! Siparişi iptal edeceğiniz sayfa "Bildirim URL" sayfasıdır (Bakınız: 2.ADIM Klasörü).
    $merchant_fail_url = "http://www.siteniz.com/odeme_hata.php";
    #
    ## Müşterinin sepet/sipariş içeriği
    $user_basket = "";
    #
    /* ÖRNEK $user_basket oluşturma - Ürün adedine göre array'leri çoğaltabilirsiniz
    $user_basket = base64_encode(json_encode(array(
        array("Örnek ürün 1", "18.00", 1), // 1. ürün (Ürün Ad - Birim Fiyat - Adet )
        array("Örnek ürün 2", "33.25", 2), // 2. ürün (Ürün Ad - Birim Fiyat - Adet )
        array("Örnek ürün 3", "45.42", 1)  // 3. ürün (Ürün Ad - Birim Fiyat - Adet )
    )));
    */
    ############################################################################################

    ## Kullanıcının IP adresi
    if( isset( $_SERVER["HTTP_CLIENT_IP"] ) ) {
        $ip = $_SERVER["HTTP_CLIENT_IP"];
    } elseif( isset( $_SERVER["HTTP_X_FORWARDED_FOR"] ) ) {
        $ip = $_SERVER["HTTP_X_FORWARDED_FOR"];
    } else {
        $ip = $_SERVER["REMOTE_ADDR"];
    }

    ## !!! Eğer bu örnek kodu sunucuda değil local makinanızda çalıştırıyorsanız
    ## buraya dış ip adresinizi (https://www.whatismyip.com/) yazmalısınız. Aksi halde geçersiz paytr_token hatası alırsınız.
    $user_ip=$ip;
    ##

    ## İşlem zaman aşımı süresi - dakika cinsinden
    $timeout_limit = "30";

    ## Hata mesajlarının ekrana basılması için entegrasyon ve test sürecinde 1 olarak bırakın. Daha sonra 0 yapabilirsiniz.
    $debug_on = 1;

    ## Mağaza canlı modda iken test işlem yapmak için 1 olarak gönderilebilir.
    $test_mode = 0;

    $no_installment = 0; // Taksit yapılmasını istemiyorsanız, sadece tek çekim sunacaksanız 1 yapın

    ## Sayfada görüntülenecek taksit adedini sınırlamak istiyorsanız uygun şekilde değiştirin.
    ## Sıfır (0) gönderilmesi durumunda yürürlükteki en fazla izin verilen taksit geçerli olur.
    $max_installment = 0;

    $currency = "TL";

    ####### Bu kısımda herhangi bir değişiklik yapmanıza gerek yoktur. #######
    $hash_str = $merchant_id .$user_ip .$merchant_oid .$email .$payment_amount .$user_basket.$no_installment.$max_installment.$currency.$test_mode;
    $paytr_token=base64_encode(hash_hmac('sha256',$hash_str.$merchant_salt,$merchant_key,true));
    $post_vals=array(
            'merchant_id'=>$merchant_id,
            'user_ip'=>$user_ip,
            'merchant_oid'=>$merchant_oid,
            'email'=>$email,
            'payment_amount'=>$payment_amount,
            'paytr_token'=>$paytr_token,
            'user_basket'=>$user_basket,
            'debug_on'=>$debug_on,
            'no_installment'=>$no_installment,

```

--------------------------------

### PayTR Token Oluşturma ve Ödeme Alma (Python)

Source: https://dev.paytr.com/iframe-api/iframe-api-1-adim

Bu kod parçacığı, PayTR API'sini kullanarak bir ödeme işlemi için gerekli olan güvenli token'ı oluşturur. Gerekli merchant bilgilerini, kullanıcı bilgilerini ve sipariş detaylarını kullanarak bir hash stringi oluşturur ve bu stringi HMAC-SHA256 ile şifreleyerek token elde eder. Ardından, bu token ile PayTR'ın ödeme API'sine POST isteği göndererek ödeme işlemini başlatır. Başarılı olursa token'ı yazdırır, aksi takdirde hata mesajını gösterir. `requests`, `hmac`, `hashlib`, `base64`, `json` kütüphanelerine bağımlıdır.

```python
import requests
import json
import hashlib
import hmac
import base64

# Merchant bilgileri ve sipariş detayları (örnek değerler)
merchant_id = "YOUR_MERCHANT_ID"
merchant_key = b"YOUR_MERCHANT_KEY"
merchant_salt = b"YOUR_MERCHANT_SALT"
user_ip = "192.168.1.1"
merchant_oid = "ORDER123"
email = "user@example.com"
payment_amount = "100.50"
user_basket = b"[{"id": "1", "name": "Ürün A", "price": "50.00", "quantity": "1"}, {"id": "2", "name": "Ürün B", "price": "50.50", "quantity": "1"}]"
no_installment = 1
max_installment = 3
currency = "TL"
test_mode = 1

user_name = "Kullanıcı Adı"
user_address = "Kullanıcı Adresi"
user_phone = "5555555555"
merchant_ok_url = "https://yourdomain.com/success"
merchant_fail_url = "https://yourdomain.com/fail"
timeout_limit = ""

# Hash stringi oluşturma
hash_str = merchant_id + user_ip + merchant_oid + email + payment_amount + user_basket.decode() + str(no_installment) + str(max_installment) + currency + str(test_mode)

# PayTR token oluşturma
paytr_token = base64.b64encode(hmac.new(merchant_key, hash_str.encode() + merchant_salt, hashlib.sha256).digest())

# API isteği için parametreler
params = {
    'merchant_id': merchant_id,
    'user_ip': user_ip,
    'merchant_oid': merchant_oid,
    'email': email,
    'payment_amount': payment_amount,
    'paytr_token': paytr_token.decode(), # base64 encode edilmiş token'ı string olarak gönder
    'user_basket': user_basket.decode(), # user_basket'ı string olarak gönder
    'debug_on': test_mode,
    'no_installment': no_installment,
    'max_installment': max_installment,
    'user_name': user_name,
    'user_address': user_address,
    'user_phone': user_phone,
    'merchant_ok_url': merchant_ok_url,
    'merchant_fail_url': merchant_fail_url,
    'timeout_limit': timeout_limit,
    'currency': currency,
    'test_mode': test_mode
}

# Ödeme API'sine istek gönderme
response = requests.post('https://www.paytr.com/odeme/api/get-token', params)
res = json.loads(response.text)

if res['status'] == 'success':
    print("Ödeme Tokeni:", res['token'])
    # Bu token ödeme formunu açmak için kullanılacak
else:
    print("Hata:", response.text)
```

--------------------------------

### POST /websites/dev_paytr_iframe-api

Source: https://dev.paytr.com/iframe-api/iframe-api-yeni-tasarim

This section details the process of initiating a payment transaction using the PayTR iframe API. It covers the necessary parameters and how to construct the request to open the payment form.

```APIDOC
## POST /websites/dev_paytr_iframe-api

### Description
This endpoint is used to initiate a payment transaction and open the PayTR payment form within an iframe on your website. You need to provide merchant details, customer information, and payment specifics to generate a secure payment token.

### Method
POST

### Endpoint
/websites/dev_paytr_iframe-api

### Parameters
#### Request Body
- **merchant_id** (string) - Required - Your unique merchant ID provided by PayTR.
- **merchant_key** (string) - Required - Your merchant key for API authentication.
- **merchant_salt** (string) - Required - A unique salt for generating the payment hash.
- **emailstr** (string) - Required - The email address of the customer.
- **payment_amountstr** (integer) - Required - The payment amount. Multiply the amount by 100 (e.g., 9.99 becomes 999).
- **merchant_oid** (string) - Required - A unique order ID for each transaction.
- **user_namestr** (string) - Required - The full name of the customer.
- **user_addressstr** (string) - Optional - The address of the customer.
- **user_phonestr** (string) - Optional - The phone number of the customer.
- **merchant_ok_url** (string) - Required - The URL to redirect the customer to upon successful payment.
- **merchant_fail_url** (string) - Required - The URL to redirect the customer to in case of payment failure.
- **user_ip** (string) - Required - The IP address of the customer.
- **user_basket** (object[][]) - Required - An array of objects representing the items in the customer's basket. Each object should contain: ["product_name", "price", "quantity"].
- **timeout_limit** (string) - Optional - The time limit for the transaction in minutes. Defaults to 30.
- **debug_on** (string) - Optional - Set to "1" for debugging, "0" for production. Defaults to "1".
- **test_mode** (string) - Optional - Set to "1" to perform test transactions, "0" for live transactions. Defaults to "1".
- **no_installment** (string) - Optional - Set to "1" to disable installments, "0" to allow installments. Defaults to "0".
- **max_installment** (string) - Optional - The maximum number of installments allowed. Set to "0" for the maximum allowed by PayTR.
- **currency** (string) - Optional - The currency of the transaction (e.g., "TL", "EUR", "USD"). Defaults to "TL".
- **lang** (string) - Optional - The language for the payment form (e.g., "tr", "en"). Defaults to "tr".
- **iframe_v2** (string) - Optional - Set to "1" to enable iframe v2.
- **iframe_v2_dark** (string) - Optional - Set to "1" to enable dark mode for iframe v2.

### Request Example
```csharp
using System.Collections.Specialized;

// ... (other using statements and variables as defined in the C# code)

NameValueCollection data = new NameValueCollection();
data.Add("merchant_id", merchant_id);
data.Add("merchant_key", merchant_key);
data.Add("merchant_salt", merchant_salt);
data.Add("emailstr", emailstr);
data.Add("payment_amountstr", payment_amountstr.ToString());
data.Add("merchant_oid", merchant_oid);
data.Add("user_namestr", user_namestr);
data.Add("user_addressstr", user_addressstr);
data.Add("user_phonestr", user_phonestr);
data.Add("merchant_ok_url", merchant_ok_url);
data.Add("merchant_fail_url", merchant_fail_url);
data.Add("user_ip", user_ip);

// Adding user_basket items
for (int i = 0; i < user_basket.Length; i++) {
    data.Add("user_basket[" + i + "][0]", user_basket[i][0].ToString()); // Product Name
    data.Add("user_basket[" + i + "][1]", user_basket[i][1].ToString()); // Price
    data.Add("user_basket[" + i + "][2]", user_basket[i][2].ToString()); // Quantity
}

data.Add("timeout_limit", timeout_limit);
data.Add("debug_on", debug_on);
data.Add("test_mode", test_mode);
data.Add("no_installment", no_installment);
data.Add("max_installment", max_installment);
data.Add("currency", currency);
data.Add("lang", lang);
data.Add("iframe_v2", iframe_v2);
data.Add("iframe_v2_dark", iframe_v2_dark);

// You would then typically use WebClient or HttpClient to POST this data to the PayTR API.
// Example using WebClient (simplified):
// using (var client = new WebClient()) {
//     byte[] responseBytes = client.UploadValues("https://api.paytr.com/..."), data);
//     string response = Encoding.UTF8.GetString(responseBytes);
//     // Process the response to get the payment token and iframe URL
// }
```

### Response
#### Success Response (200)
- **status** (string) - Indicates if the request was successful ('success' or 'fail').
- **token** (string) - A unique token generated for the payment transaction.
- **iframe_url** (string) - The URL of the PayTR payment iframe.

#### Response Example
```json
{
  "status": "success",
  "token": "some_secure_payment_token",
  "iframe_url": "https://www.paytr.com/odeme/get/iframe?token=some_secure_payment_token"
}
```

#### Error Response (400 or other)
- **status** (string) - Indicates if the request was successful ('success' or 'fail').
- **reason** (string) - A description of the error if the status is 'fail'.

#### Error Response Example
```json
{
  "status": "fail",
  "reason": "Invalid merchant ID or other authentication error."
}
```
```