> For the complete documentation index, see [llms.txt](https://developer.paywall.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.paywall.one/odeme-servisi/19.-parcali-odeme/1.-odeme-baslat.md).

# 1. Ödeme Başlat

## Ödeme Başlat

<mark style="color:green;">`POST`</mark> `{{Base Adres}}/api/paywall/payment/start/split`

{% hint style="info" %}
**Önemli:** Parçalı ödeme başlatma servisini kullanabilmeniz için **Header** alanında **apikeypublic** ve **apiclientpublic** parametrelerini göndermeniz gerekmektedir.\
[<mark style="color:green;">**PaymentAPI Adresi**</mark>](/ortam.md)
{% endhint %}

<table><thead><tr><th width="188">Parametre</th><th width="79">Tip</th><th width="107">Zorunlu</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Evet</td><td>Üye işyeri panelinden temin etmiş olduğunuz Public Key.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>Üye işyeri panelinden temin etmiş olduğunuz Public Client.</td></tr></tbody></table>

**Servise gönderilecek örnek&#x20;**<mark style="color:green;">**JSON**</mark>**&#x20;ve&#x20;**<mark style="color:green;">**örnek kodlar**</mark>**&#x20;aşağıdaki gibidir.**

{% tabs %}
{% tab title="JSON" %}
{% code lineNumbers="true" %}

```json5
{
    "PaymentDetail": {
        "Amount": 600.00,
        "MerchantUniqueCode": "{{$guid}}",
        "CurrencyId": 1,
        "Installment": 1,
        "CallbackAddress": "https://webhook.site/6dbedd75-2e39-47cf-a389-4a2e4b1afdd4", // sadece rollback senaryosu için 
        "ClientIP": "1.1.1.1",
        "Half2D": false,
        "ProviderBased": false,
        "ProviderKey": "test",
        "TrackingCode": "tracking-code-1234567830",
        "PosBased": false,
        "PosId": 4712,
        "AutoRollback": false
    },
    "CardModel": 1, //Ecommerce Insurance
    "Payments": [
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 150
            },
            "Card": {
                "OwnerName": "Enes Tütüncü",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2026",
                "Cvv": "123"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        }
    ]
}
```

{% endcode %}
{% endtab %}

{% tab title="C#" %}

```csharp
// Soon
```

{% endtab %}

{% tab title="GO" %}

```go
// Soon
```

{% endtab %}

{% tab title="Java" %}

```java
// Soon
```

{% endtab %}

{% tab title="PHP" %}

```php
// Soon
```

{% endtab %}

{% tab title="Python" %}

```python
// Soon
```

{% endtab %}

{% tab title="Ruby" %}

```ruby
// Soon
```

{% endtab %}

{% tab title="TypeScript" %}

```typescript
// Soon
```

{% endtab %}

{% tab title="Curl" %}

```sh
// Soon
```

{% endtab %}
{% endtabs %}

**Kayıtlı Kart ile Gerçekleştirilen İşlem –&#x20;**<mark style="color:green;">**JSON**</mark>**&#x20;Formatı**&#x20;

{% tabs %}
{% tab title="JSON" %}

```json5
{
    "PaymentDetail": {
        "Amount": 400.00,
        "MerchantUniqueCode": "{{$guid}}",
        "CurrencyId": 1,
        "Installment": 1,
        "CallbackAddress": "https://webhook.site/6dbedd75-2e39-47cf-a389-4a2e4b1afdd4", // sadece rollback senaryosu için 
        "ClientIP": "1.1.1.1",
        "Half2D": false,
        "ProviderBased": false,
        "ProviderKey": "test",
        "TrackingCode": "tracking-code-1234567830",
        "PosBased": false,
        "PosId": 4712,
        "AutoRollback": false
    },
    "CardModel": 1, //Ecommerce Insurance
    "Payments": [
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 150
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        }
    ]
}
```

{% endtab %}
{% endtabs %}

<mark style="color:blue;">Ana Dizin</mark>

<table><thead><tr><th width="238">Parametre</th><th width="153">Tip</th><th width="113">Zorunlu</th><th width="336">Açıklama</th></tr></thead><tbody><tr><td>PaymentDetail</td><td>PaymentDetail</td><td>Evet</td><td>Ödeme detaylarının konumlandırılacağı Json nesnesidir</td></tr><tr><td>CardModel</td><td>int</td><td>Evet</td><td>Ödeme alınacak kart yöntemidir<br><br><a href="/pages/VfSDpdFi2LfYlvXDqkK3">Tipler</a></td></tr><tr><td>Payments</td><td>List&#x3C;Payment></td><td>Evet</td><td>Parçalı ödeme kapsamında alınacak olan ödemelerin yer aldığı liste şeklinde Json nesnesidir</td></tr></tbody></table>

<mark style="color:blue;">Ana Dizin:</mark> <mark style="color:orange;">`PaymentDetail`</mark>

<table><thead><tr><th width="235">Parametre</th><th width="106">Tip</th><th width="109">Zorunlu</th><th width="336">Açıklama</th></tr></thead><tbody><tr><td>Amount</td><td>string</td><td>Evet</td><td>Ödeme işleminde tahsil edilecek toplam tutardır.</td></tr><tr><td>MerchantUniqueCode</td><td>decimal</td><td>Evet</td><td>Üye işyerine özgü olarak tanımlanan benzersiz bir koddur.</td></tr><tr><td>CurrencyId</td><td>string</td><td>Evet</td><td>İşlemin gerçekleştirileceği para birimini ifade eder.<br><br><a href="/pages/bahfUMz1dqpN1ZCnpVtM">Para birimleri</a></td></tr><tr><td>Installement</td><td>integer</td><td>Evet</td><td>Müşterinin ödeme planında seçtiği taksit adedini gösterir.</td></tr><tr><td>CallbackAddress</td><td>string</td><td>Evet</td><td>İşlem tamamlandıktan sonra sistemin sonuç bilgisini ileteceği adrestir.</td></tr><tr><td>ClientIP</td><td>string</td><td>Evet</td><td>İşlem yapan kullanıcının IP adresini ifade eder.</td></tr><tr><td>Half2D</td><td>bool</td><td>Hayır</td><td>Ödemelerinizi özel bir çağrı ile finansallaştırabilmeniz için size destek olacak parametredir. Half2D parametresini true göndermeniz durumunda ödeme bitirme çağrısını siz yapana kadar ödemeniz bankada <mark style="color:yellow;">provizyonda</mark> kalacaktır.</td></tr><tr><td>ProviderBased</td><td>bool</td><td>Hayır</td><td>Ödemenizin hangi sağlayıcıdan geçmesi gerektiğine kendi tarafınızda karar verdiğinizde kullanılır</td></tr><tr><td>ProviderKey</td><td>string</td><td>Koşullu</td><td>Ödemenizin geçmesini istediğiniz sağlayıcı anahtarı</td></tr><tr><td>PosBased</td><td>bool</td><td>Hayır</td><td>Ödemenizin hangi sağlayıcıdan geçmesi gerektiğine kendi tarafınızda karar verdiğinizde kullanılır</td></tr><tr><td>PosId</td><td>int</td><td>Koşullu</td><td>Ödemenizin geçmesini istediğiniz sağlayıcının bağlantı kimlik numarasıdır. Paywall panelinden temin bağlı sağlayıcılar listesinde yer almaktadır</td></tr><tr><td>AutoRollback</td><td>bool</td><td>Hayır</td><td>Parçalı işlemlerden herhangi biri başarısız olursa, başarılı olanlar otomatik olarak geri alınsın mı?</td></tr></tbody></table>

<mark style="color:blue;">Ana Dizin:</mark> <mark style="color:orange;">`Payments`</mark>

<table><thead><tr><th width="198">Parametre</th><th width="106">Tip</th><th width="139">Zorunlu</th><th width="336">Açıklama</th></tr></thead><tbody><tr><td><mark style="color:yellow;">Customer</mark> > FullName</td><td>string</td><td>Evet</td><td>Müşteri tam adı</td></tr><tr><td><mark style="color:yellow;">Customer</mark> > Phone</td><td>string</td><td>Evet</td><td>Müşteri telefon numarası</td></tr><tr><td><mark style="color:yellow;">Customer</mark> > Email</td><td>string</td><td>Evet</td><td>Müşteri e-posta adresi</td></tr><tr><td><mark style="color:yellow;">Customer</mark> > Country</td><td>string</td><td>Evet</td><td>Müşteri ülkesi</td></tr><tr><td><mark style="color:yellow;">Customer</mark> > City</td><td>string</td><td>Evet</td><td>Müşteri şehir bilgisi</td></tr><tr><td><mark style="color:yellow;">Customer</mark> > Address</td><td>string</td><td>Hayır</td><td>Müşteri adres bilgisi</td></tr><tr><td><mark style="color:yellow;">Customer</mark> > IdentityNumber</td><td>string</td><td>Hayır</td><td>Müşteri kimlik bilgisi</td></tr><tr><td><mark style="color:yellow;">Customer</mark> > TaxNumber</td><td>string</td><td>Hayır</td><td>Müşteri vergi no bilgisi</td></tr><tr><td><mark style="color:orange;">Product</mark> > ProductId</td><td>string</td><td>Evet</td><td>Satışı gerçekleşen ürün kimlik bilgisi</td></tr><tr><td><mark style="color:orange;">Product</mark> > ProductName</td><td>string</td><td>Evet</td><td>Satışı gerçekleşen ürün adı</td></tr><tr><td><mark style="color:orange;">Product</mark> > ProductCategory</td><td>string</td><td>Evet</td><td>Satışı gerçekleşen ürünün kategori bilgisi</td></tr><tr><td><mark style="color:orange;">Product</mark> > ProductDescription</td><td>string</td><td>Hayır</td><td>Satışı gerçekleşen ürünün açıklama bilgisi</td></tr><tr><td><mark style="color:orange;">Product</mark> > ProductAmount</td><td>decimal</td><td>Evet</td><td>Satışı gerçekleşen ürünün tutar bilgisi<br><br><strong>Not</strong>: <strong>Tüm ürünlerin tutar bilgilerinin toplamı ana tutara eşit olmalıdır</strong></td></tr><tr><td><mark style="color:red;">Card</mark> > OwnerName</td><td>string</td><td><mark style="color:purple;">Koşullu</mark></td><td>Kart sahibi adı</td></tr><tr><td><mark style="color:red;">Card</mark> > Number</td><td>string</td><td><mark style="color:purple;">Koşullu</mark></td><td>Kart numarası</td></tr><tr><td><mark style="color:red;">Card</mark> > IdentityNumber</td><td>string</td><td><mark style="color:purple;">Koşullu</mark></td><td>Kart sahibi kimlik bilgisi</td></tr><tr><td><mark style="color:red;">Card</mark> > CardNoFirst</td><td>string</td><td><mark style="color:purple;">Koşullu</mark></td><td>Kartın ilk 8 hanesi</td></tr><tr><td><mark style="color:red;">Card</mark> > CardNoLast</td><td>string</td><td><mark style="color:purple;">Koşullu</mark></td><td>Kartın son 4 hanesi</td></tr><tr><td><mark style="color:red;">Card</mark> > ExpireMonth</td><td>string</td><td><mark style="color:purple;">Koşullu</mark></td><td>Kartın son kullanım ay bilgisi</td></tr><tr><td><mark style="color:red;">Card</mark> > ExpireYear</td><td>string</td><td><mark style="color:purple;">Koşullu</mark></td><td>Kartın son kullanım yıl bilgisi</td></tr><tr><td><mark style="color:red;">Card</mark> > Cvv</td><td>string</td><td><mark style="color:purple;">Koşullu</mark></td><td>Kartın CVV bilgisi</td></tr></tbody></table>

**Servisten Dönen Cevap:**

<table><thead><tr><th width="189">Parametre</th><th width="100.33333333333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td>ErrorCode</td><td>int</td><td>Hata kodu. İşlem başarılı ise '0' değerini döner.</td></tr><tr><td>Result</td><td>bool</td><td>İşlem başarılı ise <strong>true</strong>, hatalı ise <strong>false</strong> döner.</td></tr><tr><td>Message</td><td>string</td><td>İşlemle ilgili bilgi veya hata mesajını içerir.</td></tr><tr><td>Body</td><td>json</td><td>Toplu ödeme işlemine ait detaylı bilgiler.</td></tr></tbody></table>

**Servisten Dönen Cevap:**  <mark style="color:orange;">`Body`</mark>

<table><thead><tr><th width="203">Parametre</th><th width="145.33333333333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td>SplitPaymentId</td><td>int</td><td>Parçalı ödeme kimlik bilgisi</td></tr><tr><td>MerchantUniqueCode</td><td>string</td><td>Parçalı ödeme başlatma anında sizin tarafınızdan verilen tekil takip numarası</td></tr><tr><td>Status</td><td>int</td><td>Parçalı ödeme durum bilgisi</td></tr><tr><td>Payments</td><td>List&#x3C;Payment></td><td>Parçalı ödeme kapsamında gerçekleşen her işlemin detay bilgisi</td></tr></tbody></table>

**Örnek Kod:**

{% tabs %}
{% tab title="JSON" %}

```json5
{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "SplitPaymentId": 238,
        "MerchantUniqueCode": "65451a10-7e26-4df7-9149-7d6d3d35de56",
        "Status": 5,
        "Payments": [
            {
                "PaymentId": 4045720,
                "UniqueCode": "90d0b03e-3ab8-418a-aedb-6d808437d43d",
                "MerchantUniqueCode": "0c4f61e1-4ee7-4ad3-868a-f7b3e0558434",
                "IsSuccessful": true,
                "StatusMessage": "Success",
                "Error": null
            },
            {
                "PaymentId": 4045721,
                "UniqueCode": "5db8b112-6554-48ab-b4f8-9e7b3f85393b",
                "MerchantUniqueCode": "6a3c7464-5f9d-4ef3-a8cb-66e17327d743",
                "IsSuccessful": false,
                "StatusMessage": "Failed",
                "Error": null
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.paywall.one/odeme-servisi/19.-parcali-odeme/1.-odeme-baslat.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.