Pay Hesap Entegrasyon Dokümanı

Anasayfa

PayHesap API servisi web siteleriniz üzerinden sorunsuz bir şekilde ödeme hizmeti alabilmeniz için geliştirilmiştir.

• Pay Hesap Panel Adresimiz : https://www.payhesap.com
• Sorularınız veya destek talepleriniz için [email protected] adresinden bize 7/24 ulaşabilirsiniz.
• Ödeme isteği gönderebilmek için gerekli olan, üye işyerinize özel oluşturulan API Hash bilginize panel üzerinden ulaşabilirsiniz.
• Kullanacağınız ödeme modeline göre soldaki menüden ilerleyip entegrasyon işlemlerinizi gerçekleştirebilirsiniz.

Entegrasyon Sürecimiz

• Kullanacağınız ödeme modeline göre entegrasyon işlemlerinizi gerçekleştirdikten sonra test bilgileri ile işlem gerçekleştirerek sisteme sorunsuz bir şekilde entegre olduğunuzdan emin olmalısınız.
• İşlem sonuçlarını kullanıcılarınızın daha rahat anlayabilmesi için bizden gelen hata kod ve mesajlarını kendinize göre düzenlemelisiniz.
• İşlem sonunda sizin belirttiğiniz geri dönüş sayfasına verilerin eksiksiz ve doğru bir şekilde geldiğinden emin olmalısınız.
• Tüm bu süreçler de sorularınızı veya destek taleplerinizi [email protected] adresinden bize ulaştırabilirsiniz.

Opencart Dönüş Callback URL Adresi : Opencart kullanacağınızı bize bildirmeniz durumunda , dönüş urlniz ayarlanacaktır.

WooCommerce, WordPress'in açık kaynaklı e-ticaret eklentisidir. Wordpress kullanıcıları tarafından kolaylıkla yönetilebilen WooCommerce pratik ve kullanışlı bir e-ticaret çözümü sunmakatdır. Pay Hesap WooCommerce modülü eklentisiz WooCommerce kurulumu üzerinden geliştirilip test edilmiştir.

WHMCS, tüm gereklilikleri içerisinde barındıran hazır paket bir web hosting yönetim yazılımı, otomasyonudur. WHMCS kurulumu üzerinden geliştirilip test edilmiştir.

PHP ile yazılmış hazır kodları indirip yazılımınıza entegrasyonunu yapabilirsiniz.

iFrame Ödeme Modeli

Güvenli Ödeme Sayfası Servisi İstek Modeli;

Güvenli ödeme sayfası modelini kullanarak başarılı bir tahsilat gerçekleştirmek için aşağıda maddeler halinde açıklanan işlemleri takip ederek entegrasyonunuzu tamamlamanız gerekmektedir.

İstek Mesajı

Örnek PHP Kod

İstek Kod

                

<?php

$posts = [
    "hash" => "xxxxxxxxxxxx",
    "order_id" => "43",
    "callback_url" => "https://site-adresi.com/callback.php", //İşlem durumu hakkında bilgiler ve Payhesap üzerinden ödeme sorgulama aşaması
    "amount" => "1",
    "installment" => "1",
    "success_url" => "https://site-adresi.com/success.php", //Ödeme başarılı ise sayfa buraya yönlencek
    "fail_url" => "https://site-adresi.com/fail.php",  //Ödeme başarısız ise sayfa buraya yönlencek
    "name" => "Onur Samancı",
    "email" => "[email protected]",
    "phone" => "123123123",
    "city" => "İstanbul",
    "state" => "Şişli",
    "address" => "Test işlem adres",
    "ip" => $_SERVER['REMOTE_ADDR']
];

$encode = json_encode($posts, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

$ch = curl_init('https://www.payhesap.com/api/iframe/pay');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $encode);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json',
        'Content-Length: ' . strlen($encode)
    ]
);
$result = curl_exec($ch);

$decode = json_decode($result, true);

if(isset($decode['data']['token'])){ ?>

    <script src="https://www.payhesap.com/iframe/iframeResizer.min.js"></script>
    <iframe src="https://payhesap.com/api/iframe/<?=$decode['data']['token'];?>" id="payhesapiframe" frameborder="0" scrolling="yes" style="width: 100%;"></iframe>
    <script>iFrameResize({},'#payhesapiframe');</script>

<?php

}else{
    print_r($decode); // Bir sorun var mesajlar burada
}
                
                

Cevap Kod (Callback)

                    

<?php
if(isset($_POST['STATUS'])){

    $orderID = $_POST['ORDER_REF_NUMBER'];
    $hash = $_POST['HASH'];

    $ch = curl_init('https://www.payhesap.com/api/pay/checkOrder');
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
    curl_setopt($ch, CURLOPT_POSTFIELDS, array('hash' => $hash));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);;
    $result = json_decode(curl_exec($ch),true);

    //$orderID ile siparişinizn işlemlerini yapabilirsiniz
    if($result['statusID'] == 1 ){
        // Ödeme Başarılı
    }else{
        // Ödeme Başarısız
    }


}



                    
                

Mağaza iFrame Ödeme Servisi İstek Modeli

İstek Mesajı

Örnek İstek

    "hash" => "TEST1234",
    "order_id" => "123456789PAYHESAP001",
    "amount" => "200",
    "callback_url" => "https://site-adresi.com/callback.php",
    "installment" => "1",
    "name" => "Firstname",
    "lastname" => "Lastname",
    "email" => "[email protected]",
    "phone" => "02122356600",
    "postcode" => "90",
    "country" => "Türkiye",
    "city" => "İstanbul",
    "state" => "Şişli",
    "address" => "Merkez Mah. Akar Cd. No:3/115 ITower Plaza Kat:17 Bomonti Şişli/İstanbul",
    "ip" => "1.1.1.1",
    "products" => [
       [
         "sku" => "MCNT",
         "name" => "Mavi Çanta",
         "price" => "100",
         "qty" => "1",
       ],
       [
         "sku" => "KCNT",
         "name" => "Kırmızı Çanta",
         "price" => "100",
         "qty" => "1",
       ],
    ]

Cevap Mesajı

Örnek PHP Kod

<?php
 $posts = [
    "hash" => "TEST1234",
    "order_id" => "123456789PAYHESAP001",
    "amount" => "200",
    "callback_url" => "https://site-adresi.com/callback.php",
    "installment" => "1",
    "name" => "Firstname",
    "lastname" => "Lastname",
    "email" => "[email protected]",
    "phone" => "02122356600",
    "postcode" => "90",
    "country" => "Türkiye",
    "city" => "İstanbul",
    "state" => "Şişli",
    "address" => "Merkez Mah. Akar Cd. No:3/115 ITower Plaza Kat:17 Bomonti Şişli/İstanbul",
    "ip" => $_SERVER['REMOTE_ADDR'],
    "products" => [
       [
         "sku" => "MCNT",
         "name" => "Mavi Çanta",
         "price" => "100",
         "qty" => "1",
       ],
       [
         "sku" => "KCNT",
         "name" => "Kırmızı Çanta",
         "price" => "100",
         "qty" => "1",
       ],
    ]
];

$encode = json_encode($posts, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

$ch = curl_init('https://www.payhesap.com/api/shop/pay');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $encode);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json',
        'Content-Length: ' . strlen($encode)
    ]
);
$result = curl_exec($ch);

$response = json_decode($result, true);

if(isset($response['status']) && $response['status'] == 'true'){
     echo '<iframe src="https://payhesap.com/api/shop/'.$response['data']['token'].'" id="payhesapiframe" frameborder="0" scrolling="yes" style="width: 100%;"></iframe><script> let iframe = document.querySelector("#payhesapiframe"); window.addEventListener(\'message\', function(e) { let message = e.data;iframe.style.height = (message.height + 100) + \'px\';},false);</script>';
}elseif(isset($response['status']) && $response['status'] == 'false'){
    print_r($response['errors']);
}

                

Sipariş Durumu Sorgulama

Oluşturulan siparişin durumunu kontrol etmek için aşağıdaki komutları kullanabilirsiniz.

İstek Mesajı

Örnek PHP Kod

                    

<?php

 if(isset($_POST['STATUS'])){

 $orderID = $_POST['ORDER_REF_NUMBER'];
 $hash = $_POST['HASH'];

 $ch = curl_init('https://www.payhesap.com/api/pay/checkOrder');
 curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
 curl_setopt($ch, CURLOPT_POSTFIELDS, array('hash' => $hash));
 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);;
 $result = json_decode(curl_exec($ch));

 //$orderID ile siparişinizn işlemlerini yapabilirsiniz
 if($result['statusID'] == 1 ){
     // Ödeme Başarılı
 }else{
     // Ödeme Başarısız
 }