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 |
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.
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 |
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
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
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ı bekleyinpaymentVerification = 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.
|
shopCode |
String | Mağaza kodunuz |