# Sipay API Documentation

## Docs
- Genel Bakış [Başlangıç](https://apidocs.sipay.com.tr/tr/ba%C5%9Flang%C4%B1%C3%A7-1699520m0.md): 
- Genel Bakış [Test Kartları ](https://apidocs.sipay.com.tr/tr/test-kartlar%C4%B1-2130967m0.md): 
- [Non-Secure Ödeme](https://apidocs.sipay.com.tr/tr/non-secure-%C3%B6deme-7245899f0.md): 
- Non-Secure Ödeme [Non-Secure Ödeme Akışı ](https://apidocs.sipay.com.tr/tr/non-secure-%C3%B6deme-ak%C4%B1%C5%9F%C4%B1-2009892m0.md): 
- [3D Secure Ödemesi](https://apidocs.sipay.com.tr/tr/3d-secure-%C3%B6demesi-7245902f0.md): 
- 3D Secure Ödemesi [3D Secure Ödeme Akışı](https://apidocs.sipay.com.tr/tr/3d-secure-%C3%B6deme-ak%C4%B1%C5%9F%C4%B1-2042941m0.md): 
- Sipay ile Non-Secure ve 3D Ödeme  [Purchase Link Örneği](https://apidocs.sipay.com.tr/tr/purchase-link-%C3%B6rne%C4%9Fi-2202667m0.md): 
- [Ödeme Durumu Sorgulama](https://apidocs.sipay.com.tr/tr/%C3%B6deme-durumu-sorgulama-5348690f0.md): 
- [Taksitler & Komisyonlar](https://apidocs.sipay.com.tr/tr/taksitler-komisyonlar-6248393f0.md): 
- HASH [Hash Oluşturma ](https://apidocs.sipay.com.tr/tr/hash-olu%C5%9Fturma-2106879m0.md): 
- HASH [Hash Doğrulama](https://apidocs.sipay.com.tr/tr/hash-do%C4%9Frulama-2106880m0.md): 
- [Kayıtlı Kart ile Ödeme](https://apidocs.sipay.com.tr/tr/kay%C4%B1tl%C4%B1-kart-ile-%C3%B6deme-6247061f0.md): 
- [Tekrarlayan Ödeme](https://apidocs.sipay.com.tr/tr/tekrarlayan-%C3%B6deme-6263014f0.md): 
- Webhook [Webhook](https://apidocs.sipay.com.tr/tr/webhook-2009891m0.md): 
- Hata Statü Kodları [Statü Kodları](https://apidocs.sipay.com.tr/tr/stat%C3%BC-kodlar%C4%B1-2006876m0.md): 

## API Docs
- Kimlik Doğrulama [Token Oluşturma](https://apidocs.sipay.com.tr/tr/token-olu%C5%9Fturma-23283730e0.md): Bu endpoint, üye işyerinin sonraki API isteklerinde kimliğini doğrulamak için kullanılacak bir token oluşturur.
- Non-Secure Ödeme [Non-Secure Kart Ödemesi](https://apidocs.sipay.com.tr/tr/non-secure-kart-%C3%B6demesi-23308516e0.md): Bu endpoint, Non-Secure kart ödemeleri için kullanılmaktadır.
- Non-Secure Ödeme [Non-Secure Tekrarlayan Ödeme](https://apidocs.sipay.com.tr/tr/non-secure-tekrarlayan-%C3%B6deme-31329114e0.md): Bu endpoint ve ilgili parametreleri, tekrarlayan ödemelerin gerçekleştirilmesi için kullanılmaktadır.
- Non-Secure Ödeme [Non-Secure Sigorta Ödemesi](https://apidocs.sipay.com.tr/tr/non-secure-sigorta-%C3%B6demesi-31340612e0.md): #### `vpos_type`
- Non-Secure Ödeme [Non-Secure Ön Provizyon Ödemesi](https://apidocs.sipay.com.tr/tr/non-secure-%C3%B6n-provizyon-%C3%B6demesi-31343298e0.md): Ön provizyon, kartın kullanılabilir limitinin bir ödeme işlemi için geçici olarak rezerve edilmesi sürecidir.
- Non-Secure Ödeme [Ödeme Onaylama](https://apidocs.sipay.com.tr/tr/%C3%B6deme-onaylama-33925946e0.md): `confirm_payment` endpoint’i ödemeyi onaylamak için kullanılır.
- 3D Secure Ödemesi [3D Secure Kredi Kart Ödemesi](https://apidocs.sipay.com.tr/tr/3d-secure-kredi-kart-%C3%B6demesi-25721952e0.md): 3DS, online işlemleri şifreli bağlantılar üzerinden gerçekleştiren güvenli bir ödeme altyapısıdır. Ödeme sırasında paySmart3D seçildikten sonra kullanıcılar, işlemi tamamlamak için güvenli ödeme sayfasına yönlendirilir. Ödeme başarıyla yetkilendirildiğinde sistem, gerçek zamanlı ödeme onayı döndürür.
- 3D Secure Ödemesi [3D Secure Tekrarlayan Ödeme](https://apidocs.sipay.com.tr/tr/3d-secure-tekrarlayan-%C3%B6deme-31339735e0.md): Bu endpoint ve ilgili parametreleri, tekrarlayan ödemelerin gerçekleştirilmesi için kullanılmaktadır.
- 3D Secure Ödemesi [3D Secure Ön Provizyon Ödemesi ](https://apidocs.sipay.com.tr/tr/3d-secure-%C3%B6n-provizyon-%C3%B6demesi-31344786e0.md): Ön Provizyon (Pre-Authorization), bir kartın kullanılabilir limitinin ödeme işlemi için geçici olarak rezerve edilmesi işlemidir. Tutar, karttan hemen tahsil edilmez; bunun yerine kart sahibinin kullanılabilir bakiyesinde bloke edilir. Bu işlemin amacı, ödemenin daha sonra tamamlanması (complete-confirm) için güvence altına alınmasıdır.
- 3D Secure Ödemesi [Ödeme Tamamlama](https://apidocs.sipay.com.tr/tr/%C3%B6deme-tamamlama-26547484e0.md): İşlem 3D Secure ödeme yöntemi üzerinden gerçekleştirildiğinde ve `payment_completed_by` parametresi **`merchant`** olarak gönderildiğinde, **Ödeme Tamamlama (Complete Payment)** endpoint'i çağrılmalıdır.
- 3D Secure Ödemesi [Ödeme Onaylama](https://apidocs.sipay.com.tr/tr/%C3%B6deme-onaylama-39834171e0.md): `confirm_payment` endpoint’i ödemeyi onaylamak için kullanılır.
- 3D Secure Ödemesi [3D Secure Tarım Ödemesi](https://apidocs.sipay.com.tr/tr/3d-secure-tar%C4%B1m-%C3%B6demesi-33736680e0.md): Bu endpoint, tarımsal ödemeler için 3D Secure ödeme sürecini açıklamaktadır.
- Sipay ile Non-Secure ve 3D Ödeme  [Sipay ile Non-Secure ve 3D Secure Ödeme](https://apidocs.sipay.com.tr/tr/sipay-ile-non-secure-ve-3d-secure-%C3%B6deme-26902318e0.md): Sipay yöneticisi, üye işyeri web sitesinden gerçekleştirilen ödemelerin **Non-Secure** veya **3D Secure** işlem olarak gerçekleştirilip gerçekleştirilmeyeceğini belirler. Bu endpoint için gönderilecek istek, üye işyeri web sitesinden Sipay ödeme entegrasyon sistemine iletilmelidir.
- Ödeme Durumu Sorgulama [Durum Sorgulama](https://apidocs.sipay.com.tr/tr/durum-sorgulama-25727396e0.md): Bu endpoint, bir işlemin durumunu kontrol etmek için kullanılmaktadır. Üye işyerlerinin, bir ödemenin başarıyla tamamlanıp tamamlanmadığını, beklemede olup olmadığını veya başarısız sonuçlanıp sonuçlanmadığını doğrulamasını sağlar.
- Taksitler & Komisyonlar [Taksit Bilgisi Sorgulama](https://apidocs.sipay.com.tr/tr/taksit-bilgisi-sorgulama-23284389e0.md): Bu endpoint, ödeme sayfasında girilen kart numarasına göre taksit seçeneklerini almak için kullanılmaktadır.
- Taksitler & Komisyonlar [Komisyon Bilgisi Sorgulama](https://apidocs.sipay.com.tr/tr/komisyon-bilgisi-sorgulama-26908946e0.md): Bu endpoint, belirtilen kart programı ve para birimi koduna göre üye işyeri komisyonunu ve son kullanıcı komisyonunu döndürür.
- Taksitler & Komisyonlar [Üye İşyeri Taksit Bilgisi Sorgulama](https://apidocs.sipay.com.tr/tr/%C3%BCye-i%CC%87%C5%9Fyeri-taksit-bilgisi-sorgulama-26909434e0.md): Bu endpoint, üye işyerlerinin aktif taksit seçeneklerini almasını ve görüntülemesini sağlar. Bu sayede ödeme süreci sırasında kullanıcılara uygun taksit seçenekleri sunulabilir.
- Kayıtlı Kart ile Ödeme [3D Secure Kart Token ile Ödeme](https://apidocs.sipay.com.tr/tr/3d-secure-kart-token-ile-%C3%B6deme-26908142e0.md): Kayıtlı kart ile ödeme servisi, daha önce kaydedilmiş kart bilgileri kullanılarak ödeme işlemlerinin gerçekleştirilmesini sağlar.
- Kayıtlı Kart ile Ödeme [Kart Kaydetme](https://apidocs.sipay.com.tr/tr/kart-kaydetme-26908219e0.md): Kart Kayıt endpoint'i, kart bilgilerinin Sipay sistemi içerisinde güvenli bir şekilde saklanmasını sağlar.
- Kayıtlı Kart ile Ödeme [Kayıtlı Kart Bilgilerini Sorgulama](https://apidocs.sipay.com.tr/tr/kay%C4%B1tl%C4%B1-kart-bilgilerini-sorgulama-26908225e0.md): Bu endpoint, bir müşteriye ait kayıtlı kart bilgilerini almak için kullanılır.
- Kayıtlı Kart ile Ödeme [Kayıtlı Kart Düzenleme](https://apidocs.sipay.com.tr/tr/kay%C4%B1tl%C4%B1-kart-d%C3%BCzenleme-26908250e0.md): Bu endpoint, müşteriye ait kart bilgilerinde **değişiklik yapmak** için kullanılır.
- Kayıtlı Kart ile Ödeme [Kayıtlı Kart Silme](https://apidocs.sipay.com.tr/tr/kay%C4%B1tl%C4%B1-kart-silme-26908277e0.md): Bu endpoint, müşteriye ait daha önce kaydedilmiş bir kartın silinmesi için kullanılır.
- Kayıtlı Kart ile Ödeme [Non-Secure Kart Token ile Ödeme](https://apidocs.sipay.com.tr/tr/non-secure-kart-token-ile-%C3%B6deme-26908291e0.md): `payByCardTokenNonSecure` endpoint'i, üye işyerlerinin Sipay ödeme entegrasyon sistemi içerisinde daha önce kaydedilmiş bir kart token kullanarak ödeme işlemi başlatmasını sağlar.
- Tekrarlayan Ödeme [Tekrarlayan Ödeme Sorgulama ](https://apidocs.sipay.com.tr/tr/tekrarlayan-%C3%B6deme-sorgulama-26965533e0.md): Bu endpoint, daha önce ödeme talebi oluşturulmuş tekrarlayan ödeme işlemlerini sorgulamak için kullanılır. Response içerisinde ilgili tekrarlayan ödeme işlemine ait detaylar yer alır.
- Tekrarlayan Ödeme [Tekrarlayan Ödeme Plan Süreci](https://apidocs.sipay.com.tr/tr/tekrarlayan-%C3%B6deme-plan-s%C3%BCreci-23283314e0.md): Bu endpoint, ilgili tekrarlayan ödemenin (recurring payment) başarıyla işlenip işlenmediğini görüntülemek için kullanılır.
- Tekrarlayan Ödeme [Tekrarlayan Ödeme Planı Güncelleme](https://apidocs.sipay.com.tr/tr/tekrarlayan-%C3%B6deme-plan%C4%B1-g%C3%BCncelleme-26965560e0.md): Bu endpoint, tekrarlayan ödemenin (recurring payment) güncellenmesi için kullanılır.
- İade [İade](https://apidocs.sipay.com.tr/tr/i%CC%87ade-26908125e0.md): Bu endpoint, daha önce başarıyla tamamlanmış ve ödemesi alınmış bir işlem için iade (refund) talebi oluşturmak amacıyla kullanılır. Merchantların, kendi iş kuralları ve ödeme sağlayıcı politikaları doğrultusunda tam veya kısmi iade sürecini başlatmasına olanak sağlar.
- Para Dağıtımı  [Banka Hesabına Para Aktarımı](https://apidocs.sipay.com.tr/tr/banka-hesab%C4%B1na-para-aktar%C4%B1m%C4%B1-27078845e0.md): Bu API, Sipay hesabındaki bakiyenin banka hesabına aktarılması amacıyla kullanılır. Fonlar aynı zamanda müşterilerin banka hesaplarına da transfer edilebilir.