Ön Hazırlıklar

Hepsipay olarak, fintech sektöründe sorunsuz ve kesintisiz bir ödeme deneyiminin önemini anlıyoruz. Hepsipay dijital cüzdan ve ödeme altyapısını kendi platformunuza en uygun şekilde entegre edebilmeniz için farklı entegrasyon modelleri geliştirdik.

İlk olarak, entegrasyon yönteminden bağımsız olarak Hepsipay’de iş yeri kaydını oluşturabilmek için iş yerinizi aşağıdaki bilgiler ile Hepsipay’e tanımlatmanız gerekmektedir. Hepsipay tarafındaki iş yeri tanımlarınızın ve kimlik bilgilerinizin oluşması için Hepsipay merchant panel üzerinden aşağıdaki bilgilerin girişlerini yapmalısınız. Girişler sonrası panelde otomatik olarak oluşacak bilgileriniz ile Hepsipay entegrasyonlarınızı gerçekleştirebilirsiniz.

Yetkili Kişi Bilgileri

İş Yeri Bilgileri

CraftGate Ödeme sayfası kullanan iş yerleri için Hepsipay aktivasyonu

Eğer uygulamanızın veya websitenizin ödeme sayfasını iş ortağımız olan CraftGate’ten hizmet alıyorsanız herhangi bir entegrasyon gerekmeden Hepsipay’i aktive edebilirsiniz. Sadece Craftgate panel üzerinden partner olarak Hepsipay seçilip yeni bir yetki oluşturulduktan sonra, apiKey ve secretKey bilgilerini, https://panel.craftgate.io/manage/settings (opens in a new tab) sayfasından Genel Ayarlar -> Üye İşyeri Callback Key adımlarını izleyerek de CallBackKey bilgilerinizi iletmelisiniz.

Bu bilgileri Hepsipay entegrasyon ekibine iletmeniz ile birlikte birlikte Hepsipay’i aktive etmiş olacaksınız.

*Taksit süreçlerini CraftGate üzerinden yürüten işyerleri, herhangi bir geliştirme eforu harcamasına gerek yoktur. Mevcut taksit yönetim süreçlerini olduğu gibi devam ettirebileceklerdir.

Hazır e-ticaret platformu kullanan iş yerleri için Hepsipay aktivasyonu

Hazır E-Ticaret Platformları

• Ticimax ( Hazır )
• Shopify ( Hazır )
• Akinon ( Hazırlanıyor )
• Tsoft ( Hazır )
• İdeasoft ( Hazırlanıyor )
• Inveon ( Hazırlanıyor )
• Ikas ( Hazırlanıyor )

Yukarıda listelediğimiz e-ticaret platformu sağlayıcılarından hizmet alıyorsanız ve

• Craftgate,
• Payten ya da
• Paygate -> Direkt banka sanal POS’u kullanan iş yerleri için Hepsipay’in sunduğu Gateway çözümüdür. (Akbank, İş Bankası, Garanti, Yapı Kredi, QNB Finansbank, Ziraat, Halkbank kullanıyorsanız ya da Sipay, Param, İyzico sanal poslarına entegre çalışıyorsanız Paygate kullanabilirsiniz)

Yukarıdaki Payment Gateway Provider’lardan biri ile çalışıyor olmanız durumunda herhangi bir entegrasyon gerekmeden Hepsipay’i hızlıca aktive edebilirsiniz.

İlk aşamadaki iş yeri bilgileriniz ile otomatik oluşturulan Hepsipay kimlik bilgilerinizi e-ticaret sağlayıcılarınızın panelleri üzerinden girerek Hepsipay’i kolayca aktive edebilirsiniz. Paygate kullanacaksanız; Taksitlerinizin yönetimiyle ilgili tercihlerinizi ve POS tanımlarınızı yine Hepsipay merchant panel üzerinden yapabilirsiniz.

*Taksit süreçlerini CraftGate üzerinden yürüten işyerleri, herhangi bir geliştirme eforu harcamasına gerek yoktur. Mevcut taksit yönetim süreçlerini olduğu gibi devam ettirebileceklerdir.

*Paygate üzerinden POS kullanan işyerlerimizin, Hepsipay IP adreslerini kendi bankalarına ileterek yetki istemesi ve IP tanımlarını tamamlaması gerekmektedir. Aksi halde Hepsipay üzerinden banka erişim sorunu yaşanmaktadır.

Hazır E-Ticaret Panellerinden Hepsipay’i Nasıl Aktif Edebilirim?

TİCİMAX

Ticimax paneline giriş yaptıktan sonra Ayarlar menüsünden Genel Ayarlar Menüsüne tıklanır. Çıkan Menülerden Ödeme Yöntemleri menüsünden alta inerek Hepsipay alanına gidilir. Bu alanda Hepsipay Üye İş Yeri panelinden otomatik olarak oluşturulan Merchant No, Terminal No, Store Key bilgileri girilir ve Aktif statüsü tıklanıp kaydedilir.

• 1
• 2

Shopify (Craftgate)

• 1 Test ve prod ortam için işyerinin credential bilgileri Hepsipay ekibi tarafından iletilir. İletilen bu bilgileri Craftgate panelinde ekleyerek Hepsipay'i yetkilendirmeniz gerekmektedir.

• 2 Hepsipay yetkilendirildikten sonra; Hepsipay delivery ekibine Craftgate için apiKey ve secretKey bilgilerini ve https://panel.craftgate.io/manage/settings (opens in a new tab) sayfasından Genel Ayarlar -> Üye İşyeri Callback Key adımlarını izleyerek de CallBackKey bilgisini iletmelisiniz. Aktivasyon için delivery ekibinin bilgilendirmesini bekleyiniz.

T-soft

• 1 T-soft üzerinden bizi aktifleştirebilmeniz için Hepsipay’den aldığınız credential bilgileriniz ile (Üye işyeri no, terminal no, store key) nildesk üzerinden t-soft'a talep oluşturmalısınız.

• 2 T-soft bu bilgilerle işyeri adına bir versiyon geçişi yaptıktan sonra size bir IP numarası iletecek ve bu IP'yi bize tanımlamak üzere iletmelisiniz.

• 3 IP tanımı tamamlandığında, son aşama olarak aşağıdaki t-soft arayüzünden Hepsipay’I aktifleştirmelisiniz.

Ödeme sayfasını kendi yöneten iş yerleri için Hepsipay entegrasyonu

Ödeme entegrasyonunuzun güvenilirliğini ve doğruluğunu sağlamak için hem Live hem de QA ortamları sunuyoruz.

Live ortam, gerçek işlemleri gerçekleştirmenize izin verirken, müşterilerinizin ödemelerinin güvenli bir şekilde işlenmesini ve fonların sorunsuz bir şekilde transfer edilmesini sağlar.

Öte yandan QA ortamımız, güvenli ve kontrollü bir test ortamı sağlar. Gerçek işlemleri veya fonları etkilemeden işlemleri simüle etmenize ve ödeme akışlarınızı test etmenize izin vererek Canlı ortamın davranışını taklit eder.

Base URL

Baseurl değerleri mimariyle tamamen aynı. LIVE ve QA baseurl değerleri arasındaki tek fark, API çağrınızdaki URL yollarıdır. Health check ile hem LIVE hem de QA’de erişimlerinizi kontrol edebilirsiniz

Kimlik Bilgileri

Hepsipay tarafında iş yerine ait Kimlik bilgilerinin oluşturulabilmesi için aşağıdaki bilgilerinizi Hepsipay merchant panel üzerinden girerek Hepsipay kimlik bilgilerinizi oluşturmalısınız.

Yetkili Kişi Bilgileri

İş Yeri Bilgileri

Hepsipay servislerinin kullanılabilmesi için aşağıda yer alan bilgiler gerekmektedir ve yukarıdaki bilgileri temin ettikten sonra Hepsipay tarafından oluşturulacaktır.

• Signature gerektiren requestlerde header da merchant-no terminal-no ve signature alanları gönderilmelidir

• Live ve QA kimlik bilgilerinin tamamen farklıdır. Entegrasyon süreci başlarken Live ve QA için gerekli bilgiler Hepsipay tarafından tarafınıza iletilecektir.

İmza Hesaplama Algoritmaları

Entegrasyon yöntemleri ve konumlandırma belirlendikten sonra öncelik olarak backend entegrasyonu sonrasında ise frontend entegrasyonunun yapılması Hepsipay tarafından önerilir. Backend entegrasyonunda dikkat edilmesi gereken maddeler ve backend servislerinin header’ında iletilecek olan imza hesaplama algoritmalarını bu bölümde aktaracağız.

• Signature gerektiren requestlerde header da merchant-no terminal-no ve signature alanları gönderilmelidir.

• Tüm requestlerde finansal değer içeren tüm Amount alanları için son 2 hane ondalıklı kısmı temsil edecek şekilde,orjinal tutarın 100 ile çarpılmasıyla elde edilen INTEGER değer beklenecektir.

• Tüm responselarımızda Amount(Tutar) değerleri için aynı kuralı işletip değerleri 100 ile çarparak response bilgisi dönüyor olacağız.

  • Örnek 1: 100,50 TL (100 lira 50 kuruş) tutarındaki bir işlem için, 100,50 * 100 = 10050(int) göndermelisiniz.
  • Örnek 2: 500 TL (500 lira) tutarındaki bir işlem için 500 * 100 = 50000(int) göndermelisiniz.
  • Örnek 3: 0,5 TL (50 kuruş) tutarındaki bir işlem için 0,5 * 100 = 50(int) göndermelisiniz.

• Aşağıdaki değerler uç uca birleştirilir

  • İsteğin yapıldığı URL (hostname, protocol ve query string dahil)
  • Merchant No
  • Terminal No
  • Eğer mevcut ise isteğin body'si

• Birleştirilen string ve store key ile SHA-512 algoritması ile şifreleme gerçekleştirilir.

Signature Oluşturma Örneği

1.Adım:

{
"Amount": 10000,
"AccountKey": "905110001111",
"MerchantCallBackUrl": "https://www.hepsipay.com",
"BasketItems": [
{
"Product": "Çikolata",
"Price": 10000,
"SubMerchantMemberId": null,
"SubMerchantMemberPrice": null,
"CategoryId": "3",
"ExternalId": "10"
}
],
"IsGuestUser": false,
"Force3ds": false,
"AllowedInstallments": [1,2,3],
"MerchantOrderNumber": "1234-5679"
}

2.Adım:Birleştirilmiş String:

https://merchantpfpayment-gatewayqa.Hepsipay.com/v2/Hepsipayframe/init1016116{
"Amount": 10000,
"AccountKey": "905110001111",
"MerchantCallBackUrl": "https://www.Hepsipay.com",
"BasketItems": [
{
"Product": "Çikolata",
"Price": 10000,
"SubMerchantMemberId": null,
"SubMerchantMemberPrice": null,
"CategoryId": "3",
"ExternalId": "10"
}
],
"IsGuestUser": false,
"Force3ds": false,
"AllowedInstallments": [1,2,3],
"MerchantOrderNumber": "1234-5679"
}

3.Adım:Signature Edinimi

Örnek Kodlar

function generate_signature($path, $request_body)
{
    $url = "https://merchantpfpayment-gateway-qa.hepsipay.com/";
    $merchant_no = "XXXXX"; // Hepsipay tarafından iletilir
    $terminal_no = "YYYYY"; // Hepsipay tarafından iletilir
    $store_key = "ZZZZZ"; // Hepsipay tarafından iletilir
    $body = json_encode($request_body);
 
    $hashString = $url . $path . $merchant_no . $terminal_no . $body;
 
    return hash_hmac('sha512', $hashString, $store_key);
}

Test Hesapları ve Kartları

Test amacıyla, QA ortamında kullanabileceğiniz bir dizi test kartı ve Hepsipay hesap bilgileri sağlıyoruz. Bu test kartlarını ve hesap bilgilerini, farklı ödeme senaryolarını simüle ederek ödeme akışlarınızı doğrulamanıza, çeşitli yanıt kodlarını işlemenize ve yalnızca QA ortamında sorunsuz işlem gerçekleştirmenize olanak tanır.

PayGate kullanılabilmesi için MerchantNo, TerminalNo ve StoreKey bilgilerini talep etmelisiniz.

Paygate Test Kartları:

PayGate Ödül Kartları:

Ödeme altyapısı olarak CraftGate kullanan iş yerleri için test hesapları ve kartlar:

Başarılı Tüm Test Kartları: https://developer.craftgate.io/test-cards/all-successful-test-cards (opens in a new tab)

Hata Alan Tüm Test Kartları: https://developer.craftgate.io/test-cards/all-test-cards-receive-error/ (opens in a new tab)

Ödül ve Puan Özellikli Test Kartları: https://developer.craftgate.io/test-cards/reward-point-featuredtest-cards (opens in a new tab)