# Amazon Pay Modülü

https://docs.wisecp.com/tr/amazon-pay-modulu

Amazon Pay'i bağlayarak müşterilerin Amazon hesaplarıyla ödeme yapmasını sağlayın ve ödemelerle iadeleri WISECP'te takip edin.

## Ekrana Erişim

**Ayarlar → Finansal → Ödeme Ağ Geçitleri → Tüm Modüller** yolunu izleyip **Amazon Pay** kartına tıklayın: `{admin}/modules/payment?module=AmazonPay`

## Ekranda Neler Var

Formda hesap bilgileri, bölge, dil ve dönüş adresi bulunur. Amazon Pay butonu Amazon'un ödeme sayfasını açar. Modül, Checkout v2 ile tek seferlik ödeme ve anında tahsilat kullanır.

WISECP'te kart saklama, otomatik ödeme, abonelik, taksit seçimi ve ayrı provizyon/tahsilat işlemi yoktur. Amazon'da saklanan ödeme yöntemleri Amazon'da kalır.

## Yapılandırmadan Önce

İşletmenizin desteklenen bölgesi için Amazon Pay satıcı hesabı açıp onayı tamamlayın. Geliştirici hesabı sandbox testine izin verir. HTTPS kullanın ve [resmi başlangıç rehberinden](https://developer.amazon.com/docs/amazon-pay-checkout/get-set-up-for-integration.html) sandbox alıcı hesabı oluşturun.

ABD için USD, Japonya için JPY kullanın. Avrupa hesabı EUR, Birleşik Krallık hesabı GBP üzerinden ödeme alır. Onaylı EUR/GBP hesapları AUD, GBP, DKK, EUR, HKD, JPY, NZD, NOK, ZAR, SEK, CHF veya USD tahsil edebilir.

Mevcut modül ortak dönüşüm ayarını uygulamadan fatura para birimini gönderir. Faturayı desteklenen birimde oluşturun; TRY desteklenmez. Özellikle tam yene yuvarlanan JPY ödemelerinde tutarı ve para birimini kontrol edin.

## Alanlar

- **Merchant ID**: Zorunlu; başlangıçta boş. Seller Central, Settings → Account Info bölümündeki satıcı kimliğiniz.
- **Public Key ID**: Zorunlu; başlangıçta boş. SANDBOX- veya LIVE- öneki ortamı belirler ve Test Modu seçiminin önüne geçer.
- **Özel Anahtar (Private Key)**: Zorunlu; başlangıçta boş. Public Key ID'ye ait PEM özel anahtarını başlangıç ve bitiş satırlarıyla eksiksiz yapıştırın.
- **Store ID**: Zorunlu; başlangıçta boş. Integration Central'daki mağaza istemci kimliği; amzn1.application-oa2-client ile başlar.
- **Bölge**: Zorunlu; varsayılan Amerika Birleşik Devletleri (USD). Satıcı hesabınıza göre ABD, Avrupa, Birleşik Krallık veya Japonya'yı seçin.
- **Ödeme Dili**: İsteğe bağlı; varsayılan Otomatik. ABD İngilizce, Japonya Japonca sunar. Avrupa/Birleşik Krallık İngilizce, Almanca, Fransızca, İtalyanca ve İspanyolca sunar. Uygun olmayan seçimde bölge varsayılanı kullanılır.
- **Test Modu**: Başlangıçta kapalı. SANDBOX-/LIVE- öneki olmayan eski anahtar kimliklerinde sandbox ortamını seçer.
- **Dönüş URL'i**: Otomatik ve zorunlu; burada değiştirilemez. HTTPS adresinin tamamını Amazon'un izin verilen dönüş adreslerine kopyalayın.

**Durum**, komisyon, tutar sınırları ve ülke listeleri [Ödeme Modülleri](https://docs.wisecp.com/tr/odeme-modulleri) rehberindedir. Otomatik **Callback URL**, **Success URL** ve **Failed URL** hesap bilgisi alanları değildir.

## İşlemler

### Hesabı Yapılandırma

1. Seller Central'da **Integration Central** bölümünü açıp sandbox pazarını seçin. **Self-developed** ve tek seferlik ödeme seçeneğini işaretleyip **Get instructions** butonuna tıklayın.
2. **API keys → Create keys** yolunu açın. **Generate API credentials** seçeneğiyle anahtarı adlandırıp **Create keys** butonuna tıklayın. İndirilen PEM dosyasını güvenle saklayın.
3. WISECP Amazon Pay formuna dört hesap bilgisini ve uygun bölgeyi girin. **Durum** seçeneğini açıp **Ayarları Kaydet** butonuna tıklayın.
4. **Ödeme Ağ Geçitleri → Başlangıç → Etkin Modül Seçimi** bölümünde Amazon Pay'i seçip **Ayarları Kaydet** butonuna tıklayın. Yöntem, sınırları içinde kullanılabilir.

### Siteyi ve Dönüşü Kaydetme

Integration Central'da canlı ödeme sitenizi **JavaScript Origins** alanına, WISECP'teki **Dönüş URL'i** değerini izin verilen dönüş adreslerine ekleyin. Protokolü ve varsa özel portu dahil edin. Yeni adresin Amazon incelemesi 48 saate kadar sürebilir.

Modül ödeme isteğini imzalar; dönüşte oturumu ve tahsilatı Amazon API'sinden okur. Ayrı IPN/webhook alıcısı yoktur. Dönüş URL'ini Amazon SNS bildirim adresi olarak kaydetmeyin.

### Test Etme ve Canlıya Geçme

1. Ödenmemiş test faturasını müşterisi olarak açın, Amazon Pay'i seçip **Şimdi Öde** butonuna tıklayın. Amazon Pay butonuyla sandbox alıcısını kullanın.
2. Başarıyı, iptali ve kesilen dönüşü ayrı deneyin. Amazon tahsilat kimliğini, tutarı ve para birimini faturanın ödeme kaydıyla karşılaştırın.
3. Tekrar denemeden önce bekleyen işlemi Seller Central'da kontrol edin. Modülde bağlantı testi butonu veya arka planda IPN ile kurtarma yoktur.
4. Hesap onayı ve başarılı testlerden sonra uyumlu LIVE bilgilerini girip **Ayarları Kaydet** butonuna tıklayın. Test Modu seçili kalsa bile LIVE öneki gerçek ödemeyi açar.

### Ödemeyi İade Etme

1. Ödenmiş faturayı açın: `{admin}/invoices/detail?id={invoice}`.
2. **Özet → Durumu Değiştir** bölümünde **İade Edildi** ve **Ödeme altyapısı ile iade** seçimini yapın. **Durumu Güncelle** butonuna tıklayın.
3. WISECP, çok faturayı kapatan ödemeler dahil, bu faturanın kayıtlı Amazon tahsilat payını ister. Pay bulunamazsa iadeyi Seller Central'dan yapın.
4. İadenin son durumunu Seller Central'da doğrulayın. Kabul edilen istek RefundInitiated aşamasında kalabilir; WISECP tamamlanmayı sonradan eşitlemez.

## Dikkat Edilecekler

> **Başlayan İşlem Kesin Sonuç Değildir**
> 
> Modül Captured ve CaptureInitiated durumlarını ödeme başarısı kabul eder. Tahsilat sorgusu başarısızsa ödeme bekler. Belirsiz ödemede hizmet açmadan veya yeniden tahsilat istemeden önce Amazon'un son durumunu kontrol edin.

> **Hesap Anahtarlarını Koruyun**
> 
> Eski ödemelerin iade ihtiyacı sürerken hesap bilgilerini değiştirmeyin. Tam fatura iadesi özel kısmi iadeden farklıdır; özel tutarı Seller Central'da işleyip iki kaydı karşılaştırın.

## Gerekli Yetkiler

Ayarlar **Modüller → Ödeme Altyapıları** (`MODULES_PAYMENT_SETTINGS`) yetkisini gerektirir. İade için **Faturalandırma → Düzenleme** (`INVOICES_OPERATION`) ve ilgili Seller Central erişimi gerekir.

## İlgili Makaleler

- [Ödeme Modülleri](https://docs.wisecp.com/tr/odeme-modulleri)
- [Fatura Detayı Genel Görünüm](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis)
- [Amazon Pay Çoklu Para Birimi](https://developer.amazon.com/docs/amazon-pay-checkout/multi-currency-integration.html)
- [Amazon Pay İade Durumları](https://developer.amazon.com/docs/amazon-pay-api-v2/refund.html)