For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Belirteç türleri ve bunları nerede bulabileceğiniz hakkında bilgi için bakın: Kimlik Bilgileri.

Webhooks (ödeme bildirimleri)

  1. Entegrasyon ayarlarında, Webhooks / bildirimler bölümünü açın (bkz.: Webhooks).

  2. Bildirim URL'sini ayarlayın:

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

  1. şuna abone olun: Ödemeler olayları, böylece ödeme oluşturulması ve durum güncellemeleri hakkında bildirim alabilirsiniz.

  2. şunu kaydedin: Webhook gizli anahtarı — entegrasyon ayarlarına girilmelidir.

Mavibot'a bağlanma

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

Ardından şunları girin:

  • Erişim Belirteci — kopyaladığınız belirteç.

  • Webhook gizli anahtarı — webhooks'leri doğrulamak için kullanılan gizli anahtar.

Ödeme bağlantısı oluşturma

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

Parametreler

Açıklama

! amount

Ödeme tutarı.

Bu zorunlu bir parametredir.

description

Ödeme açıklaması.

Bu isteğe bağlı bir parametredir.

currency

ISO para birimi kodu (örn. BRL, ARS, MXN, USD, EUR, CLP, COP, PEN, UYU) — isteğe bağlıdır; varsayılan BRL'dir.

customer_email

Müşteri e-postası — isteğe bağlı.

product_name

Alternatif ürün adı — isteğe bağlı;

sağlanmazsa, bunun yerine açıklama kullanılır.

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

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.

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.

Ö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>

Ö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).

Bu, Tetikleyici alanında bir geri çağırma bulunan Başlangıç bloğudur
Bu, Tetikleyici alanında bir geri çağırma bulunan Tetikleyici bloğudur

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).

Projede herhangi bir ödemeye yanıt ayarlamanız gerekiyorsa, 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

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.

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>

Ö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.

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

Son güncelleme