Mercado Pago ödeme sistemini kullanmak için, Mercado Pago Geliştirici panelinizde aşağıdaki ayarları tamamlayın ve ardından bilgileri entegrasyon ayarlarına girin.
Uygulama ve Erişim Anahtarı
- Mercado Pago'ya giriş yapın ve Geliştiriciler bölümünü açın (Developers / Suas integrações).
- Henüz yoksa bir uygulama oluşturun (Your integrations → Create application).
- Production Access Token veya Test Access Token değerini kopyalayın — bu anahtar, ana API anahtarı olarak kullanılacaktır.
Anahtar türleri ve nerede bulunacağı hakkında bilgi için bkz: Credentials.
Webhooks (ödeme bildirimleri)
- Entegrasyon ayarlarında Webhooks / уведомления bölümünü açın (bkz: Webhooks).
- Bildirim URL'sini ayarlayın:
https://chatter.mavibot.ai/mercado_pago_callback/result
- Ödeme oluşturma ve durum güncellemeleri hakkında bildirim almak için Payments etkinliklerine abone olun.
- Webhook secret değerini kaydedin — bu değer entegrasyon ayarlarına girilmelidir.
Mavibot'a Bağlanma
Alma (Acquiring) bölümünde Mercado Pago seçeneğini seçin.
Ardından aşağıdakileri girin:
- Access Token — kopyaladığınız anahtar.
- Webhook secret — webhook'ları doğrulamak için kullanılan gizli anahtar.
Ödeme bağlantısı oluşturma
Hesap makinesi işlevi:
get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)
İşlev bir ödeme bağlantısı döndürür.
Buton ile ödeme
Mercado Pago üzerinden bir ödeme butonu göndermek için, buton oluşturucuda ödeme destekli bir buton türü seçin ve ödeme sistemi olarak Mercado Pago'yu seçin. Gerekirse tutarı, açıklamayı ve para birimini girin.
Ödeme sonrası diyalogda geri aramalar
Başarılı ödeme
Müşteri bağlantıyı takip edip başarılı bir ödeme yaptıktan sonra, diyaloğa aşağıdaki formatta bir geri arama gönderilebilir:
<Webhook_secret_ilk_10_karakteri>_success <tutar>
Örnek:
gltubgnDle_success 100 — burada ön ek, Webhook secret değerinizin 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 geri arama içeren bir blok kullanarak bir tepki ayarlamanız gerekir.
Adım 1
Bir koşul bloğu oluşturun (Başlangıç bloğu veya Tetikleyici bloğu).
Adım 2
Geri aramanın bir kısmını (birden fazla farklı ürününüz varsa tüm ödemelere tepki vermeniz gerekiyorsa) veya tam geri aramayı (yalnızca belirli bir ürün satışına tepki ayarlamak istiyorsanız) belirtin.
Adım 3
Başarılı ödeme için yanıt mesajını yazın ve bloğu kaydedin.
Başarısız ödeme
Ödeme başarısız olursa (reddedildi, iptal edildi vb., API'deki duruma bağlı olarak), aşağıdaki formatta bir geri arama gönderilebilir:
<Webhook_secret_ilk_10_karakteri>_fail <tutar>
Örnek:
gltubgnDle_fail 100 — burada ön ek, Webhook secret değerinizin 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 geri arama içeren bir blok kullanarak bir tepki ayarlamanız gerekir.
Başarısız ödeme tepkisi, başarılı ödeme ile aynı şekilde yapılandırılır.
Adım 1
Bir koşul bloğu oluşturun (Başlangıç bloğu veya Tetikleyici bloğu).
Adım 2
Geri aramanın bir kısmını (birden fazla farklı ürününüz varsa tüm ödemelere tepki vermeniz gerekiyorsa) veya tam geri aramayı (yalnızca belirli bir ürün satışına tepki ayarlamak istiyorsanız) belirtin.
Adım 3
Başarısız ö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şlenmiştir. |
| mercado_pago_payment_id | Mercado Pago ödeme kimliği |