> For the complete documentation index, see [llms.txt](https://docs.mavibot.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mavibot.ai/doc/tr/integrations/payment/mercado-pago.md).

# Mercado Pago

Mercado Pago ödeme sistemini kullanmak için, aşağıdaki ayarları Mercado Pago Geliştiriciler kontrol panelinizde tamamlayın ve ardından entegrasyon ayarlarına bilgileri girin.

## Uygulama ve Erişim Belirteci

1. Mercado Pago'ya giriş yapın ve Geliştiriciler bölümünü açın (**Geliştiriciler / Entegrasyonlarınız**).
2. Bir uygulama oluşturun (**Entegrasyonlarınız → Uygulama oluştur**) eğer henüz bir tane yoksa.
3. şunu kopyalayın: **Üretim Erişim Belirteci** veya **Test Erişim Belirteci** — bu belirteç ana API belirteci olarak kullanılacaktır.

<div data-with-frame="true"><figure><img src="/files/0ea5d556c0430674e47ad7c45b048474ff927458" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Belirteç türleri ve bunları nerede bulabileceğiniz hakkında bilgi için bakın: [Kimlik Bilgileri.](https://www.mercadopago.com.br/developers/en/docs/your-integrations/credentials)
{% endhint %}

## Webhooks (ödeme bildirimleri)

1. Entegrasyon ayarlarında, **Webhooks / bildirimler** bölümünü açın (bkz.: [**Webhooks**](https://www.mercadopago.com.br/developers/en/docs/your-integrations/notifications/webhooks)).
2. Bildirim URL'sini ayarlayın:

`https://chatter.mavibot.ai/mercado_pago_callback/result`

3. şuna abone olun: **Ödemeler** olayları, böylece ödeme oluşturulması ve durum güncellemeleri hakkında bildirim alabilirsiniz.
4. şunu kaydedin: **Webhook gizli anahtarı** — entegrasyon ayarlarına girilmelidir.

<div data-with-frame="true"><figure><img src="/files/d3b41b8a7934947d85c1d9c881f558c562966671" alt=""><figcaption></figcaption></figure></div>

## Mavibot'a bağlanma

Satın Alma bölümünde şunu seçin: **Mercado Pago**.

<div data-with-frame="true"><figure><img src="/files/b1bfbbc8b766f88b56aae9e9b879e428b05ea1d2" alt=""><figcaption></figcaption></figure></div>

Ardından şunları girin:

* **Erişim Belirteci** — kopyaladığınız belirteç.
* **Webhook gizli anahtarı** — webhooks'leri doğrulamak için kullanılan gizli anahtar.

<div data-with-frame="true"><figure><img src="/files/a2e0b78ffd134e741592ccc731ce9f4370760d1f" alt=""><figcaption></figcaption></figure></div>

## Ödeme bağlantısı oluşturma

Hesaplayıcı işlevi:\
`get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)`

<table data-header-hidden><thead><tr><th width="241.3828125"></th><th></th></tr></thead><tbody><tr><td>Parametreler</td><td>Açıklama</td></tr><tr><td><mark style="color:$danger;"><strong>!</strong></mark><strong> amount</strong></td><td><p><strong>Ödeme tutarı.</strong></p><p>Bu zorunlu bir parametredir.</p></td></tr><tr><td><strong>description</strong></td><td><p><strong>Ödeme açıklaması.</strong> </p><p>Bu isteğe bağlı bir parametredir.</p></td></tr><tr><td><strong>currency</strong></td><td><strong>ISO para birimi kodu</strong> (örn. BRL, ARS, MXN, USD, EUR, CLP, COP, PEN, UYU) — isteğe bağlıdır; varsayılan BRL'dir.</td></tr><tr><td><strong>customer_email</strong></td><td><strong>Müşteri e-postası</strong> — isteğe bağlı.</td></tr><tr><td><strong>product_name</strong></td><td><p><strong>Alternatif ürün adı</strong> — isteğe bağlı; </p><p>sağlanmazsa, bunun yerine açıklama kullanılır.</p></td></tr></tbody></table>

İşlev bir ödeme bağlantısı döndürür.

<div data-with-frame="true"><figure><img src="/files/bdaa3e42374a6b33a1f82ffbc9574c679bfb3e58" alt=""><figcaption><p>Bu örnek, parametrelerin işleve nasıl geçirileceğini ve ödeme bağlantısının bir mesaj içinde nasıl gönderileceğini gösterir.</p></figcaption></figure></div>

## Düğme ile ödeme

Mercado Pago üzerinden bir ödeme düğmesi göndermek için, düğme oluşturucuda ödeme desteği olan bir düğme türü seçin ve **Mercado Pago** ödem sistemi olarak seçin. Gerekirse tutarı, açıklamayı ve para birimini girin.

<div data-with-frame="true"><figure><img src="/files/5e9617dd96e7bb16fa0b4fd8cc4849da5c12e113" alt=""><figcaption></figcaption></figure></div>

## Ödeme sonrası diyalogdaki geri çağırmalar

### **Başarılı ödeme**

Müşteri bağlantıyı takip edip başarılı bir ödemeyi tamamladıktan sonra, diyaloğa aşağıdaki biçimde bir geri çağırma gönderilebilir:

`<Webhook_secret_anahtarının_ilk_10_karakteri>_success <amount>`

<div data-with-frame="true"><figure><img src="/files/70dfdd0675963ed1c2d1deaf0249b1e4e940148d" alt="" width="524"><figcaption></figcaption></figure></div>

**Örnek:**\
`gltubgnDle_success 100` — burada önek, Webhook gizli anahtarınızın ilk 10 karakteridir ve `100` ödeme tutarıdır.

### Başarılı bir ödemeye nasıl tepki eklenir

Başarılı bir ödemeden sonra müşterinize bir mesaj göndermek için (örneğin, “Ödeme başarıyla tamamlandı” veya başka bir mesaj), bir tetikleyici ve bir geri çağırma içeren bir blok kullanarak bir tepki kurmanız gerekir.

#### 1. Adım

Bir koşullu blok oluşturun (Başlangıç bloğu veya Tetikleyici bloğu).

<div data-with-frame="true"><figure><img src="/files/218aaec6400c38efb195420709158d5dedc53b5e" alt=""><figcaption><p>Bu, Tetikleyici alanında bir geri çağırma bulunan Başlangıç bloğudur</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/80cd73a79eae7f94f687fac7e54f7801c6718210" alt=""><figcaption><p>Bu, Tetikleyici alanında bir geri çağırma bulunan Tetikleyici bloğudur</p></figcaption></figure></div>

#### 2. Adım

Geri çağırmanın bir kısmını belirtin (tüm ödemelere tepki vermeniz gerekiyorsa, örn. birden fazla farklı ürününüz olduğunda) ya da tam geri çağırmayı belirtin (yalnızca belirli bir ürün satışı için bir tepki kurmak istiyorsanız).

<div data-with-frame="true"><figure><img src="/files/16a633aafc8af46108277ded73d70b950cf8cb58" alt=""><figcaption><p>Projede herhangi bir ödemeye yanıt ayarlamanız gerekiyorsa, <br>geri çağırmanın bir kısmını bırakın ve eşleşme türü olarak "Anahtar kelime eşleşmesi"ni seçin</p></figcaption></figure></div>

#### 3. Adım

Başarılı bir ödeme için yanıt mesajını yazın ve bloğu kaydedin.3. Adım. Başarılı bir ödeme için yanıt mesajını yazın ve bloğu kaydedin.

<div data-with-frame="true"><figure><img src="/files/6abb65f65be2b62737f30f2aef293f9507f53518" alt=""><figcaption></figcaption></figure></div>

### Başarısız ödeme

Ödeme başarılı olmazsa (API'deki duruma bağlı olarak reddedildi, iptal edildi vb.), aşağıdaki biçimde bir geri çağırma gönderilebilir:

`<Webhook_secret_anahtarının_ilk_10_karakteri>_fail <amount>`

<div data-with-frame="true"><figure><img src="/files/505990644ce9e2d11b815423b076fe70ef1b154f" alt="" width="563"><figcaption></figcaption></figure></div>

**Örnek:**\
`gltubgnDle_fail 100` — burada önek, Webhook gizli anahtarınızın ilk 10 karakteridir ve `100` tutardır.

#### Başarısız bir ödemeye nasıl tepki eklenir

Başarısız bir ödemeden sonra müşterinize bir mesaj göndermek için (örneğin, “Ödeme başarısız oldu” veya başka bir mesaj), bir tetikleyici ve bir geri çağırma içeren bir blok kullanarak bir tepki kurmanız gerekir.

{% hint style="info" %}
[Başarısız ödeme tepkisi, başarılı olandakiyle aynı şekilde yapılandırılır.](#how-to-add-a-reaction-to-a-successful-payment)
{% endhint %}

#### 1. Adım

Bir koşullu blok oluşturun (Başlangıç bloğu veya Tetikleyici bloğu).

#### 2. Adım

Geri çağırmanın bir kısmını belirtin (tüm ödemelere tepki vermeniz gerekiyorsa, örn. birden fazla farklı ürününüz olduğunda) ya da tam geri çağırmayı belirtin (yalnızca belirli bir ürün satışı için bir tepki kurmak istiyorsanız).

#### 3. Adım

Başarısız bir ödeme için yanıt mesajını yazın ve bloğu kaydedin.

### Başarılı ödeme sonrası müşteri değişkenleri

| Değişkenler                       | Açıklama                                  |
| --------------------------------- | ----------------------------------------- |
| mercado\_pago\_callback\_data     | Ödeme sisteminden alınan ödeme bilgileri. |
| mercado\_pago\_payment\_completed | “True” — ödeme başarılı olarak işlendi.   |
| mercado\_pago\_payment\_id        | Mercado Pago ödeme kimliği                |


---

# 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:

```
GET https://docs.mavibot.ai/doc/tr/integrations/payment/mercado-pago.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.