Modüller ve Örnek Kodlar
Platform Versiyon Son Güncelleme Modül Link
PHP
Yapılandırma Bilgisi: Standart PHP örneğidir. Özel yazılımınıza entegre ederken sorun yaşamanız durumunda [email protected] adresinden ücretsiz destek alabilirsiniz.
All Version 01.02.2022
WooCommerce
Kurulum Bilgisi: Öncelikle modülü indirin ve wordpress [Eklenti Yükle] bölümünden modülü yükleyin ve etkileştirin.
Ayarlar bölümünden gerekli api bilgilerinizi tanımlayın ve [CallBack] URLnizi merchant.paymax.com.tr adresindeki gerekli alana ekleyin.

Modül Beta Versiyondur. Yaşadığınız sorunlar ile alakalı [email protected] mail adresi üzerinden destek alabilirsiniz.
WOO 6.x.x 01.02.2022
Wisecp
Kurulum Bilgisi: Öncelikle modülü indirin ve anadizin/coremio/modules/Payment dizini içerisine Paymax klasörünü yükleyin.
Wisecp Admin Ödeme Yöntemleri bölümünden gerekli api bilgilerinizi tanımlayın ve [CallBack] URLnizi merchant.paymax.com.tr adresindeki gerekli alana ekleyin.

Modül Beta Versiyondur. Yaşadığınız sorunlar ile alakalı [email protected] mail adresi üzerinden destek alabilirsiniz.
All Version 01.02.2022
WHMCS
Kurulum Bilgisi: Öncelikle modülü indirin ve anadizin içerisine indirdiğiniz dosyaları yükleyin.
Whmcs Admin Ödeme Yöntemleri bölümünden gerekli api bilgilerinizi tanımlayın ve [CallBack] URLnizi merchant.paymax.com.tr adresindeki gerekli alana ekleyin.

Modül Beta Versiyondur. Yaşadığınız sorunlar ile alakalı [email protected] mail adresi üzerinden destek alabilirsiniz.
WHMCS 7.x / 8.x 01.02.2022
NivuSosyal SMM Panel
Kurulum Bilgisi: Öncelikle modülü indirin ve anadizin içerisine yükleyin.
Nivu Admin Ödeme Araçları bölümünden gerekli api bilgilerinizi tanımlayın ve [CallBack] URLnizi merchant.paymax.com.tr adresindeki gerekli alana ekleyin.

Modül Beta Versiyondur. Yaşadığınız sorunlar ile alakalı [email protected] mail adresi üzerinden destek alabilirsiniz.
All Version 01.02.2022
Opencart
Kurulum Bilgisi: Öncelikle modülü indirin ve anadizin içerisine yükleyin.
Ardından opencart yönetim panelinizden gerekli alanları aktif edin.

Modül Beta Versiyondur. Yaşadığınız sorunlar ile alakalı [email protected] mail adresi üzerinden destek alabilirsiniz.
3.X.X 01.02.2022
Başlangıç

Paymax Entegrasyon merkezine hoşgeldiniz.
Entegrasyon merkezi üzerinde hazır modülleri bulabilir yada özel yazılımınıza entegrasyon için gerekli kaynaklara ulaşabilirsiniz.
Api bağlantılarını tamamlamak için öncelikle aktif bir paymax hesabınızın bulunması gerekiyor.
Eğer hala bir paymax hesabınız yoksa Buradan Başvuru yapabilirsiniz.
Herhangi bir entegrasyon sorunu için [email protected] mail adresi ile iletişime geçebilirsiniz.
Whatsapp Hattımız üzerinden teknik destek verilmemektedir.
Lütfen sizlere daha hızlı yardımcı olabilmemiz adına sadece [email protected] mail adresi ile iletişime geçiniz.

Giriş

Aşağıdaki bilgiler her api isteğinde zorunlu olarak gönderilmelidir.

Parametre Tip Uzunluk Zorunluluk Açıklama
userName String 20 Evet Api User
password String 20 Evet Api Key
shopCode String 4 Evet Mağaza Kodu
Sipariş Oluşturma

Sorgu Url Adresi : hhttps://apiv1.paymax.com.tr/api/create-payment-link

Parametre Tip Uzunluk Zorunluluk Açıklama
productName String 200 Evet Sipariş yada Fatura Adı
productData Object / Array Yok Evet Sepetteki ürünlerin listesini dizi yada nesne olarak gönderin Bknz: *1
productType String Yok DIJITAL_URUN yada FIZIKSEL_URUN Ürünleriniz Kargo yoluyla gönderilecekse kesinlikle fiziksel ürün seçilmelidir.
productsTotalPrice Decimal Yok Evet Siparişe ait sepetteki ürünlerin toplam tutarı.
orderPrice Decimal Yok Evet Api üzerinden geçecek nihai tutar. Taksit oranları bu tutar üzerine eklenerek hesaplanır.
currency String 3 TRY Para Birimi TRY,EUR,USD Varsayılan Değer: TRY
orderID String 50 Evet İlgili siparişinizin sizin sisteminiz tarafındaki sipariş ID yada Sipariş Kodu. Ödenmemiş bir sipariş yada benzersiz olmalıdır.
locale String 2 Hayır tr,en,de,ru opsiyonel Varsayılan Değer: tr
conversationId String 200 Hayır İstekte gönderilirse response olarak size geri döndürülür. Request/response eşlemesi yapmak için kullanılır.
buyerName String 4 Evet Sipariş Sahibi Adı
buyerSurName String 4 Evet Sipariş Sahibi Soyadı
buyerGsmNo String 4 Evet Sipariş Sahibi Telefon Numarası Uyarı: Telefon yanlış olan siparişler iptal edilir. Güvenlik doğrulaması için müşteriye ulaşılması gerekebilir.
buyerEmail String 80 Hayır Sipariş Sahibi E-Posta adresi.
buyerAdress String 200 Hayır Sipariş Sahibi Adresi
BuyerCountry String 70 Hayır Sipariş Sahibi Ülke
BuyerCity String 70 Hayır Sipariş Sahibi Şehir
buyerDistrict String 70 Hayır Sipariş Sahibi İlçe
hash String Evet OrderID,currency,orderPrice,productsTotalPrice,productType,callbackOkUrl,callbackFailUrl
değişkenlerinden birleştirilerek oluşturulan metnin işyeri hash kodunuzla şifrelenmiş halidir. Örnek Kod İnceleyiniz.
callbackOkUrl String Evet Müşterinin başarılı işlemde yönlendirileceği sayfa
callbackFailUrl String Evet Müşterinin başarısız işlemde yönlendirileceği sayfa

"hash" Örneklendirme

									$hash = base64_encode(pack('H*',sha1($this->userName.$this->password.$this->shopCode.$order_data['orderId'].$order_data['currency'].$order_data['orderPrice'].$order_data['productsTotalPrice'].$order_data['productType'].$order_data['callbackOkUrl'].$order_data['callbackFailUrl'].$this->hash)));									
								

Sepetteki Ürün yada Nesne Sisteminin Örneklendirilmesi "productData"

									$product_data = array(
 array(
 'productName'=>'1. Ürün Adı',
 'productPrice'=>50,
 'productType'=>'DIJITAL_URUN'
 ),
 array(
 'productName'=>'2.Ürün Adı',
 'productPrice'=>30,
 'productType'=>'DIJITAL_URUN'
 ),
 );									
								

Şifreleme örnek kodunu Modüller ve Örnek Api dosyalarında bulabilirsiniz

Callback
Parametre Tip Zorunluluk Açıklama
status String error, success Başarısız , Başarılı
errorMessage String Status error dönerse hata mesajını içerir. Success durumlarda boş döner.
payment_page_url String status==success ve başarılı bir işlem ise müşteriye göstereceğiniz ödeme sayfası url adresini döndürür.

status==success ve paymentPageUrl!='' müşterinizi paymentPageUrl adresine yönlendirin yada iframe ile gösterin
yukarıdaki durum sağlanmadığında hatayı yönetin

Haberleşme

Siparişinizle ilgili ödeme hareketi olduğunda Callback Confirm Adresinize siparişin ödenme durumu ile ilgili bilgiler iletilir. Size gönderilecek bilgilerin yapısı aşağıdaki gibidir.

Parametre Tip Açıklama
status String success, error
paymentStatus String paymentWait,paymentVerification, paymentOk, paymentNotPaid paymentWait = Sipariş Ödenmemiş. Ödemeyi bekliyor. paymentOk cevabını bekleyin
paymentVerification = Tahsilat işlemi tamamlanmamış yada tahsilat inceleme beklemektedir. paymentOk cevabı alana kadar hizmetinizi satmayın
paymentOk = Tutar Müşteriden tahsil edilmiştir. Tutar hesabınıza geçmiştir.
paymentNotPaid = Sipariş Ödemesi Rededildi
hash String Üretilen İmza
paymentAmount Decimal Ödenen sipariş tutarı
paymentType String KART, BANKA_HAVALE, YURT_DISI
conversationId String Sipariş oluştururken geri cevapta olmasını istediğiniz veri
orderId String Siparişi oluştururken gönderdiğiniz, sisteminize ait sipariş numarası
hash String OrderID,currency,orderPrice,productsTotalPrice,productType,shopCode,MAGAZA_HASH değişkenlerinden birleştirilerek oluşturulan metnin işyeri hash kodunuzla şifrelenmiş halidir. Örnek Kod İnceleyiniz.
											//Callback Örnek Hash Kod
base64_encode(pack('H*', sha1($post['orderId'].'TRY'.$post['orderPrice'].$post['productsTotalPrice'].$post['productType'].'Mağaza Kodunuz'.'Mağaza Hash Kodunuz')));
											
										
shopCode String Mağaza kodunuz