> For the complete documentation index, see [llms.txt](https://docs.iyzico.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iyzico.com/urunler/mass-payout/mass-payout-toplu-odeme-entegrasyonu.md).

# Mass Payout (Toplu Ödeme) Entegrasyonu

Toplu Ödeme (Mass Payout) servisi, üye işyerlerinin tek bir işlemle birden fazla alıcıya ödeme göndermesine olanak tanır.\
Bu servis özellikle **pazaryerleri**, **freelance platformları**, **fintech çözümleri** ve **düzenli olarak birden fazla ödemenin işlendiği sistemler** için tasarlanmıştır.

**Mass Payout API** ile her bir ödeme için ayrı işlem başlatmak yerine, tek bir istekle birden fazla alıcıya ödeme yapabilirsiniz.

***

#### **Entegrasyon Öncesi Gereksinimler**

{% hint style="info" %}
Bu özelliği kullanabilmek için **iç kontrol ve onayı gerekmektedir**.\
Gerekli kontrollerin yapılması ve özelliğin aktif edilmesi için **iyzico destek ekibi** ile iletişime geçebilirsiniz.
{% endhint %}

### Entegrasyon Adımları

1. [Toplu Ödeme Başlatma](/urunler/mass-payout/mass-payout-toplu-odeme-entegrasyonu/toplu-odeme-baslatma.md)
2. [Toplu Ödeme Tamamlama](/urunler/mass-payout/mass-payout-toplu-odeme-entegrasyonu/toplu-odeme-tamamlama.md)
3. [Toplu Ödeme Raporlama](/urunler/mass-payout/mass-payout-toplu-odeme-entegrasyonu/toplu-odeme-raporlama.md)

## Örnek Uygulama

### Toplu Ödeme Başlatma

#### Örnek İstek

```json
{
    "externalId": "massPayoutId-323ddd",
    "conversationId": "conversationId-323f",
    "purpose" : "SALARY",
    "items": [
        {
            "itemExternalId": "ext-65656",
            "recipientType": "IBAN",
            "recipientInfo": "TR920086402100005482911108",
            "amount": {
                "value": 100,
                "currency": "TRY"
            },
            "description": "Payment for services",
            "recipientName": "John Doe"
        },
        {
            "itemExternalId": "ext-9545455",
            "recipientType": "MEMBER_ID",
            "recipientInfo": "2228853",
            "amount": {
                "value": 8000,
                "currency": "TRY"
            }
        },
        {
            "itemExternalId": "ext-545454542",
            "recipientType": "IDENTITY_NUMBER",
            "recipientInfo": "22222222220",
            "amount": {
                "value": 20000,
                "currency": "TRY"
            }
        },
         {
            "itemExternalId": "ext-50070945",
            "recipientType": "PHONE",
            "recipientInfo": "+905555555555",
            "amount": {
                "value": 7000,
                "currency": "TRY"
            }
        }

    ]
}
```

#### Örnek Yanıt

```json
{
    "status": "success",
    "systemTime": 1759231970716,
    "conversationId": "conversationId-894",
    "requestId": "79cdefc1-3ce6-4f51-bdd9-0c050274db64"
}
```

####

### Ödeme İşlemini Tamamlama

#### Örnek İstek

```json
{
    "requestId" : "79cdefc1-3ce6-4f51-bdd9-0c050274db64"
}
```

#### Örnek Yanıt

```json
{
    "status": "success",
    "systemTime": 1759231995145
}
```

####

### İşlem Sorgulama

#### Örnek İstek

<pre class="language-json"><code class="lang-json">{
    "requestId": "c95e344a-c7c9-4605-91b8-3f48ee9dece6",
    "externalMassPayoutId": "massPayoutId-323",
<strong>    "itemType": "VALID",
</strong>    "page": 0,
    "size": 40
}
</code></pre>

#### Örnek Yanıt

```json
{
    "status": "success",
    "systemTime": 1759155442830,
    "massPayout": {
        "externalId": "massPayoutId-323",
        "merchantId": 000000,
        "totalAmount": 201.00,
        "totalSuccessfulAmount": 0,
        "massPayoutStatus": "PUBLISHED_TO_QUEUE",
        "totalCommissionAmount": 0,
        "currency": "TRY"
    },
    "massPayoutItems": {
        "items": [
            {
                "itemExternalId": "ext-0077",
                "referenceCode": "a97b142a-1e22-4ceb-bafb-38d6c1c4a4f7",
                "recipientType": "IBAN",
                "recipientInfo": "TR920086402100005111981111",
                "recipientName": "John Doe",
                "description": "Payment for services",
                "itemStatus": "INIT",
                "errorMessages": [],
                "totalAmount": 100.50,
                "commissionAmount": 20.00000000,
                "currencyCode": "TRY"
            },
            {
                "itemExternalId": "ext-0099",
                "referenceCode": "050b8f81-aaf7-400d-80fa-21bbed27a816",
                "recipientType": "IBAN",
                "recipientInfo": "TR920086402100005111981111",
                "recipientName": "John Doe",
                "description": "Payment for services",
                "itemStatus": "INIT",
                "errorMessages": [],
                "totalAmount": 100.50,
                "commissionAmount": 20.00000000,
                "currencyCode": "TRY"
            }
        ],
        "page": 0,
        "size": 40,
        "total": 2
    }
}
```