# Joomla'da HikaShop için Paymos kurulumu

> HikaShop'a Paymos eklentisini kurun, Sandbox'ta sipariş verin ve ödeme durumunu kontrol edin.

HikaShop'ta kripto ödemeyi açmadan önce Sandbox'ta sipariş verin. Böylece hem müşterinin ödeme ekranını görürsünüz hem de siparişin ne zaman onaylandığını yönetim ekranından kontrol edersiniz.

## Kuruluma başlamadan önce

Joomla 5.4 veya 6.2 kullanın. HikaShop sürümü 6.8.1 ya da 6.8 serisinin daha yeni bir yaması olmalı. Sunucuda PHP 8.3 veya üzeri, cURL ve OpenSSL gerekir. Mağazaya internetten HTTPS ile erişilebilmeli. HikaShop'un sipariş, geçmiş, ürün, sipariş kalemi, indirim ve kullanıcı tabloları InnoDB kullanmalı. HikaShop ayarlarında **Order created status** alanında `created` seçin. `confirmed` ve `refunded` durumlarının tanımlı olduğunu kontrol edin.

## Ödeme yöntemini ekleyin

1. [Joomla için ücretsiz ZIP dosyasını indirin](https://github.com/Paymos-labs/hikashop/releases/latest). Joomla yönetim ekranında **System → Install → Extensions** yolundan dosyayı yükleyin. Ardından **System → Manage → Plugins** bölümünde **Payment - Paymos for HikaShop** eklentisini etkinleştirin.
2. HikaShop'ta **System → Payment methods** bölümünü açın. Ödeme yöntemi oluşturup kaydedin, ardından **Connect Paymos** düğmesine basıp projenizi seçin.
3. **Sandbox** modunu seçip kaydedin. Deneme yapacağınız yerde test yöntemini yayımlayın. Sepete ürün ekleyip ödeme adımlarını tamamlayın. Bu modda gerçek para hareketi olmaz. Mağazada gerçek ödeme almaya hazır olduğunuzda **Live** modunu seçip kaydedin.

Anahtarlar, Joomla kurulumuna özel gizli anahtarla şifrelenir. Sitenizin asıl adresi değişirse bağlantıyı yeniden kurun.

## Test siparişine dönün

Ödeme sayfası siparişteki tutarı ve para birimini kullanır. Eklenti bildirimin imzasını denetler ve bildirimi API üzerinden aldığı ödeme bilgileriyle ve siparişle karşılaştırır. Bilgiler eşleşir ve sipariş tutarının tamamı ya da fazlası ödenirse sipariş bir kez `confirmed` durumuna geçer. Tutar eksikse sipariş onaylanmaz. Geç gelen ödemeleri ve siparişle uyuşmayan işlemleri ayrıca inceleyin.

Müşterinin mağazaya dönmesi siparişi onaylamaz. Ödeme sonrası HikaShop'un kendi sayfasını açmak isterseniz proje ayarlarındaki **Success URL** alanına Joomla'nın ana adresini ve ardından `/index.php?option=com_hikashop&ctrl=checkout&task=after_end` yolunu yazın. Bu adres projenin tamamı için geçerlidir.

Ödeme bildirimi ulaşmadıysa yönetim ekranında siparişi açıp **Check payment** düğmesine basın. Bu kontrol için cron gerekmez.

## İade sırasında siparişe ne olur?

İade açıksa ve ödeme koşulları karşılıyorsa sipariş üzerinden ödemenin tamamını veya fazla ödenen kısmı iade edebilirsiniz. API tutarı hesaplar ve alıcıyı ilk ödemeyi gönderen adrese göre belirler. İade sonuçlanana kadar sipariş aynı durumda kalır. Tam iade bittiğinde sipariş `refunded` durumuna geçer. Fazla ödeme iadesinde siparişin durumu değişmez ve geçmişe iade kaydı eklenir.

Başlattığınız iadenin son durumunu **Check refund** ile görün. Ağ ücreti çıkabilir. [İade koşulları](/tr/docs/support/refunds.md).

Eklentiyi ayırmadan veya kaldırmadan önce bekleyen işlemleri sonuçlandırın. **Disconnect** düğmesi ve eklentiyi kaldırma işlemi yerel anahtarları siler. Sipariş geçmişi HikaShop'ta kalır.

## Lisans

Eklenti [GPL-2.0-or-later](https://github.com/Paymos-labs/hikashop/blob/main/LICENSE), SDK ise MIT lisansıyla dağıtılır.
