HepsipayFrameInit

Üye iş yerinin Hepsipay ile ödeme akışını başlatma noktası olup Hepsipay ile Ödeme ekranını Hosted veya Redirected (Common Payment Page) olarak çağırmak için tetiklenen servistir. Üye iş yeri ödeme akışını başlatabilmek için gerekli ön bilgileri bu servis üzerinden gönderir.

Üye işyerinin Hepsipay ile ödeme akışını başlatma noktasıdır.

{
    "Amount": 1200,
    "AccountKey": "905551112233",
    "MerchantCallBackUrl": "https://www.Hepsipay.com",
    "BasketItems": [
{
    "Product": "Çikolata",
    "Price": 1200,
    "SubMerchantMemberId": 2,
    "SubMerchantMemberPrice": 100,
    "ExternalId": "12345",
    "CategoryId": "987"
}
    ],
    "IsGuestUser": false,
    "Force3ds": false,
    "AllowedInstallments": [1,2,3],
    "MerchantOrderNumber": "1234",
    "FrameType": 1,
    "CheckoutMerchantUrl": "test.com/checkout/cart",
    "BankOrderId": "f5135f15-5484-4312-8591-ba8d94557dde",
    "PosAlias": "GARANTI",
    "ExternalId": "cdfd292d-5111-4f18-9141-4df1860fb20c"
}

İşyeri ödeme için akışı başlatmak için gerekli ön bilgileri bu servise gönderir.

{
    "FrameUrl": "https://pf-uiqa.hepsipay.com/EC95B242CD88940B6972869C12C30C70893DD80ED7C86E0713CF088CBDEC354EC4C911D97527F792A606BF240A34781E",
    "Token": "EC95B242CD88940B6972869C12C30C70893DD80ED7C86E0713CF088CBDEC354EC4C911D97527F792A606BF240A34781E",
    "Success": true,
    "MessageCode": "0000",
    "Message": "İşlem Başarıyla Gerçekleştirildi.",
    "UserMessageTitle": null,
    "UserMessage": "İşlem Başarıyla Gerçekleştirildi."
}

Örnek Kodlar

try {
 
        $header = ["Content-Type: application/json"];
        $header = ["merchant-no: XXXXX"]; // Hepsipay tarafından iletilir.
        $header = ["terminal-no: YYYYY"]; // Hepsipay tarafından iletilir.
        $header = ["signature-no: e74ef7c4994cd3f5ff03f89a310cda8bcf29af12a39ebf1e7dbf27c99efe3784eb5eaaf4f535d666eb513620c8b66ec483a2dfa281c85bc2bb8ff18518f5cdf2"];
 
        $data_string = '{"Amount":1000,"AccountKey":"905998868296","MerchantCallBackUrl":"http:\/\/hepsipaysdk.entegrasyon.alttantire.local\/examples\/payment_result.php","BasketItems":[{"Product":"\u00c7ikolata","Price":500,"SubMerchantMemberId":null,"SubMerchantMemberPrice":null,"CategoryId":"3","ExternalId":"10"},{"Product":"\u00c7ikolata","Price":500,"SubMerchantMemberId":null,"SubMerchantMemberPrice":null,"CategoryId":"3","ExternalId":"10"}],"AllowedInstallments":[1,2,3],"FrameType":1,"MerchantOrderNumber":"1234-56797","BankOrderId":"ABC-123-4567","ExternalId":"EXT-ID-123-4567"}';
 
        $ch = @curl_init("https://merchantpfpayment-gateway-qa.hepsipay.com/v2/hepsipayframe/init");
 
        @curl_setopt($ch, CURLOPT_POST, true);
        @curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);
        @curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
        @curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        @curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
        @curl_setopt($ch, CURLOPT_TIMEOUT, 10); //timeout in seconds
 
        $result = curl_exec($ch);
 
        if (@curl_errno($ch)) {
        $error_msg = curl_error($ch);
        @curl_close($ch);
        throw new Exception($error_msg);
    } else {
 
        $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        $header_size = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
        $header = substr($result, 0, $header_size);
        $body = substr($result, $header_size);
 
        if ($http_code === 401) {
        throw new Exception("Yetkisiz Erişim. " . $http_code);
    }
 
        $data = json_decode($result);
        @curl_close($ch);
 
        return $data;
 
    }
 
} catch (Exception $e) {
    throw new Exception($e->getMessage());
}

iFrame olarak Kullanım

Eğer işyeri mevcut checkout ekranlarında Hepsipay ile Ödemeyi alternatif bir ödeme yöntemi olarak sunmak istiyor ise o halde HepsipayFrameInit servisini çağırırken FrameType : 1 olarak geçmelidir. Bu değer geçilmese de default olarak “1” değeriyle frame init olur. İşyerinin kendi checkout sayfasında embedded şekilde Hepsipay Frame’inin yerleştirilmesi sağlanmalıdır. Bu seçenekle ilerlendiğinde UI/UX organizasyonu işyeri tarafından yapılmalıdır.

(UI/UX entegrasyonu konusunda daha detaylı bilgi için dokümandaki “Hepsipay Frontend / UI Entegrasyonu – WEB SDK” ve “Hepsipay Frontend / UI Entegrasyonu – Embed Iframe with JS Events” başlıklarını inceleyebilirsiniz.)

Common Payment Page (Redirected) olarak Kullanım

Eğer işyerinin bir checkout sayfası yok ve hepsipay frame’i ana ödeme sayfası olarak görüntülemek istiyorsa (yani alternatif bir ödeme seçeneği değil ana ödeme yapısı olarak Hepsipay’in ekranlarının açılması isteniyorsa) o halde işyeri, ödemenin alınacağı sayfada önce “Checkavailability” servisi çağrılır ve bu servis sonucunda “true” değer alınmışsa sonrasında HepsipayFrameInit servisini çağırmalıdır. HepsipayFrameInit servisini çağırırken FrameType : 2 olarak geçilmelidir.

Bu şekilde FrameType : 2 olarak çağrılan HepsipayFrameInit servis sonucunda gelen URL direkt olarak redirect edilerek yeni bir pencerede açılacaktır. Bu yöntem (Common Payment Page) sadece Web Browser üzerinden kullanılabilmektedir, native mobil uygulama üzerinde kullanılamayacaktır (mobilde browser üzerinden açılan web uygulaması değilse).

Common Payment Page yöntemiyle açılan Hepsipay ödeme sayfasında kullanıcının ödemeyi sonlandırması (başarılı/başarısız) sonucunda, Hepsipay ödeme sayfası kapatılır ve “CheckoutMerchantUrl” parametresi ile belirtilen adrese (sipariş özeti sayfası vb.) yönlendirilir. Yine bu yöntemle ilerlendiğinde işyerinin backend’ine ödeme sonuç bildirimi senkron olarak “MerchantCallbackURL” input parametresinde işyerinin geçtiği endpoint üzerinden yapılmaktadır.

Cüzdan Bakiyesi ile Ödeme – Common Payment Page Akış Diagramı

Kayıtlı Kartı Seçerek Ödeme – Common Payment Page Diagramı

Alışveriş Kredisi ile Ödeme – Common Payment Page Diagramı