Mavibot'ta PagBank'ı ödeme sağlayıcısı olarak kullanmak için PagBank hesabınızdan bir erişim jetonu almanız ve bunu ödeme ayarlarına girmeniz gerekir.

Jeton Alma

Üretim ortamı: Bilgisayarınızdan PagBank hesabınıza giriş yapın, Vendas → Integrações (Satışlar → Entegrasyonlar) bölümüne gidin ve Gerar token (Jeton oluştur) seçeneğine tıklayın.

Test ortamı (sandbox): PagBank Geliştirici Portalı'na giriş yapın, Tokens sekmesini açın ve sandbox jetonunuzu kopyalayın.

Jeton yalnızca bir kez görüntülenir. Güvenli bir yerde saklayın: kaybederseniz yeni bir tane oluşturmanız gerekir ve eski jeton çalışmayı durdurur.

PagBank hesabınızda bir ödeme bildirim URL'si yapılandırmanız gerekmez — Mavibot, her ödeme oluşturulduğunda bunu otomatik olarak sağlar.

Kurulum

Ödeme sistemi ayarlarında PagBank'ı seçin ve aşağıdakileri girin:

  • Token — PagBank hesabınızdan alınan API erişim jetonu.
  • Test modu — Bir sandbox jetonu girdiyseniz bunu etkinleştirin. Test modunda istekler sandbox.api.pagseguro.com adresine gönderilir ve gerçek para tahsil edilmez.

Kurulum tamamlandı.

Ödeme Bağlantısı Oluşturma

Hesap makinesi işlevi:

get_pagbank_payment_url(amount, description, product_name, customer_email, customer_phone, full_name, identity_number)

Parametreler

Parametre Açıklama
amount Ödeme tutarı. Zorunlu. Minimum: 1 BRL; maksimum: 9.999.999 BRL. Tutarı 10055 değil, 100.55 olarak girin.
description Ödeme açıklaması. İsteğe bağlı, en fazla 255 karakter. Müşteri bunu ödeme sayfasında görecektir.
product_name Ürün adı, en fazla 100 karakter. İsteğe bağlı; varsayılan olarak description kullanılır.
customer_email Müşterinin e-posta adresi. İsteğe bağlı; ödeme sayfasında önceden doldurulur.
customer_phone Müşterinin telefon numarası. İsteğe bağlı; ödeme sayfasında önceden doldurulur. PagBank yalnızca Brezilya cep telefonu numaralarını kabul eder: ülke kodu 55, iki haneli alan kodu ve 9 ile başlayan dokuz haneli bir numara (örneğin, +55 11 99999-8888).
full_name Müşterinin adı ve soyadı. İsteğe bağlı; ödeme sayfasında önceden doldurulur.
identity_number Müşterinin CPF'si (11 hane) veya CNPJ'si (14 hane). İsteğe bağlı; ödeme sayfasında önceden doldurulur.

İşlev bir ödeme URL'si döndürür.

PagBank, müşteri bilgilerini yalnızca eksiksiz bir set olarak kabul eder: ad, e-posta, telefon numarası ve CPF/CNPJ'nin tümü sağlanmalıdır. Bu dört alandan herhangi biri eksikse veya telefon numarası geçerli bir Brezilya cep telefonu numarası değilse, Mavibot müşteri bilgilerinin hiçbirini PagBank'a göndermez. Müşteri bunları ödeme sayfasında doldurur. Bu, ödemenin kendisini etkilemez.

Bir Düğmede Ödeme Bağlantısı

Ödeme bağlantısı içeren bir düğme göndermek için ödeme düğmesi türünü seçin ve ödeme sistemi olarak PagBank'ı seçin. Ürün adını ve ödeme tutarını girin. Gerekirse müşterinin adını, e-posta adresini ve telefon numarasını içeren değişkenleri belirtin.

Ödeme Sonrası Geri Aramalar

Müşteri bağlantıyı takip edip ödemeyi tamamladıktan sonra, diyaloğa başarılı bir ödeme geri araması gönderilir:

A1B2C3D4E5_success 100.55

Burada A1B2C3D4E5, jetonunuzun ilk 10 karakteridir ve 100.55 ödeme tutarıdır.

Ödeme başarısız olursa, aşağıdaki geri arama gönderilir:

A1B2C3D4E5_fail 100.55

Başarısızlık geri araması yalnızca ödeme bağlantısı artık kullanılamadığında gönderilir: banka ödemeyi kalıcı olarak reddetmiş veya iptal etmişse veya ödeme bağlantısının süresi dolmuşsa. Ödeme incelenirken, boleto ödemesi beklenirken veya kartta yetkilendirilmiş ancak beklemeye alınmışken geri arama gönderilmez, çünkü ödeme bağlantısı etkin kalır. Süresi dolmuş bir ödeme bağlantısıyla ilişkili bir ödeme yoktur, bu nedenle geri arama bir tutar içermez.

Başarılı veya başarısız bir ödemeyi işlemek için şu adımları izleyin:

  1. Bir tetikleyiciye sahip bir blok oluşturun (gri bir Tetikleyici bloğu veya yeşil bir Başlangıç bloğu — ödemeden sonra huniyi oluşturmaya devam etmek istiyorsanız yeşil bloğu kullanın).
  2. Tetikleyici alanına, ödeme tutarı olmadan geri aramayı girin:
A1B2C3D4E5_success

Bloğun her başarılı ödemeye tepki vermesini istiyorsanız bu seçeneği kullanın.

Eşleme türünü Anahtar Kelime Eşlemesi olarak ayarlayın.

Alternatif olarak, tam geri aramayı girin:

A1B2C3D4E5_success 100.55

Bloğun yalnızca belirli bir tutardaki bir ödemeye tepki vermesini istiyorsanız bu seçeneği kullanın.

Eşleme türünü Tam Eşleme olarak ayarlayın.

Başarılı Bir Ödemeden Sonra Müşteri Değişkenleri

Değişken Değer
pagbank_callback_data Ödeme sisteminden alınan ödeme bilgileri
pagbank_payment_completed "True" — ödeme başarıyla işlendi
pagbank_order_id PagBank sipariş kimliği (ORDE_…)
pagbank_charge_id PagBank tahsilat kimliği (CHAR_…)
pagbank_payment_method Ödeme yöntemi: CREDIT_CARD, DEBIT_CARD, PIX veya BOLETO