.. _ErrorCodes: Hata Kodları ############ **Akifast HPP API Hata Kodları** .. list-table:: :width: 600px :widths: 25 15 15 :header-rows: 1 * - Hata Kodu - Açıklaması - Detay * - INVALID_PAN - Geçersiz kart numarası - İstekte gönderilen kart numarası geçerli değildir. Kart numarası Luhn algoritmasına uygun ve gerçek bir karta uygun olmalıdır. * - INVALID_CVV_VALUE - CVV numarası hatalı - Gönderdiğiniz CVV değeri hatalı. CVV kartın arka yüzündeki 3 ya da 4 haneli sayı olmalıdır. * - INVALID_EXPIRY_DATE - Geçersiz Son Kullanma Tarihi. - Gönderdiğimiz son kullanma tarihi bulunduğumuz aydan küçük olamaz. * - INVALID_MONTH_VALUE - Geçersiz ay değeri - Ay değeri 1 ile 12 arasında olmalıdır. * - EXPIRY_YEAR_SHOULD_BE_4_DIGITS - Son Kullanma Yılı 4 hane olmalıdır. - Kartın son kullanma yılının istekte 20XX formatında gönderilmesi gerekmektedir. * - INVALID_AMOUNT_VALUE - Geçersiz tutar. - İstekte gönderilen tutar bilgisi pozitif bir değer olmalıdır. * - SESSION_TOKEN_NOT_FOUND - Oturum bilgisi bulunamadı. - Gönderilen oturum bilgisi bulunamadığı durumda döner. Üye iş yeri yeni bir oturum başlatmalıdır. * - SESSION_TOKEN_SHOULD_NOT_BE_EMPTY - Oturum bilgisi boş olamaz. - İstekte işlem yapılacak oturum anahtarı gönderilmelidir. * - SESSION_TOKEN_EXPIRED - Oturum geçerli değil. - Oturum süresi içerisinde işlem yapılmadığında döner. Kullanıcının yeni bir oturum başlatarak işlem yapması gerekmektedir. * - SESSION_CARD_ALREADY_EXISTS - Bu oturumda daha önceden kart eklenmiş. - Aynı oturum içerisinde sadece bir kere kart ekleme yapılabilir. Yeni bir kart ile işlem yapılması istenildiğinde yeni bir oturum başlatılarak işlem yapılmalıdır. * - NO_SESSION_CARD_RELATION_FOUND - Kart bu oturumda kayıtlı değil. - Oturum ve kart bilgisi uyumsuz olduğunda gönderilir. * - SESSION_SHOULD_BE_ACTIVE_AND_BELONGS_TO_MERCHANT - Oturum üye iş yerine ait ve aktif olmalıdır. - Oturum aktif değil yada mevcut oturum ilgili iş yerine ait olmadığında gönderilir. * - TRANSACTION_TOKEN_SHOULD_NOT_BE_EMPTY - İşlem anahtarı boş olamaz. - Oturum sorgulama ve kart kaydetme işlemlerinde işlem anahtarı da gönderilmelidir. * - CARD_COULD_NOT_BE_TOKENIZED - Kart kaydedilemedi. - Sistemsel bir sorundan dolayı kart kaydedilemediğinde bu hata alınır. * - CARD_NOT_FOUND - Kart bulunamadı. - İşlem yapılmak istenen kart bulunamadığında bu hata alınır. * - UNIQUE_ID_GENERATION_ERROR - Tekil anahtar (token) oluşturma hatası - Oturum anahtarı veya işlem anahtarı oluşturma sırasında sistemsel bir sorun olursa bu hata alınır. * - INVALID_REQUEST_BODY - Geçersiz İstek. - Gönderilen istekte geçerli bir json objesi değilse ya da gönderilen istekte geçerli olmayan parametreler varsa bu hata alınır. Hatalı olan parametre dönüş değerindeki ``argument`` alanında yer alır. * - SYSTEM_ERROR - Sistem Hatası! - Yapılan isteklerde sistemsel, beklenmedik bir hata olduğu durumlarda bu hata alınır. Bu hatanın alınması durumunda istek tekrar denenmeli devam etmesi durumunda sistem yöneticisiyle iletişime geçilmelidir. * - NO_ERRORCODE_FOUND - Hata Kodu Bulunamadı. - Akifast'in döndüğü hata kodu sistem tarafında bulunamadığında bu hata kodu alınır. Bu hata kodu alındığında istek tekrar denenmeli hatanın devam etmesi durumunda sistem yöneticisiyle iletişime geçilmelidir. * - NO_MERCHANT_FOUND - Üye İş Yeri Bulunamadı. - Sorgulanmak istenen ya da giriş yapmak isteyen üye iş yeri bulunamadığında bu hata alınır. * - MERCHANT_IS_NOT_ACTIVE - Üye İş Yeri aktif değil. - Durumu sorgulanan üye iş yeri aktif değilse bu hata alınır. * - PARAMETER_REQUIRED - Gerekli parametre bulunamadı. - Yapılan istekte zorunlu parametrelerden biri yoksa bu hata alınır. Hataya sebep olan parametre dönüş değerindeki ``argument`` * - SESSION_STATUS_CAN_NOT_BE_UPDATED - Oturum durumu güncellenemez. - Oturum durumu sadece AKTİF ya da KARANTINA durumundayken güncellenebilir. AKTİF ya da KARANTINA durumda olmayan oturumlarda durum güncellemesi yapılmak istenirse bu hata alınır. * - INVALID_USER_TOKEN - Gönderilen Akinon-User-Access-Token bilgisi geçerli değildir. - Akinon sistemine Akinon tarafından üretilmiş Access Token ile istek atılmalıdır. * - UNAUTHORIZED_CLIENT_FOR_USER_TOKEN - Gönderilen tokena ait kullanıcısına yetkili olduğunuz durumda erişebilirsiniz. - Akinon sistemine gönderilen tokenın ilgili marka talebiyle oluşturulmuş olması gerekmektedir. * - INVALID_BASKET_ITEM_PRICE - Sepetteki bir ürünün birim fiyatı ile o ürünün toplam tutarının uyuşmazlığı. - Sepette ``basket_items`` içinde yer alan bir ürünün ``unit_price``, ``quantity`` ve ``price`` alanlarının uyuşmazlığı sonucu bu hata alınır. * - INVALID_TOTAL_PRODUCT_AMOUNT - Sepetteki toplam ürün tutarı ile hesaplanan ürün tutarının uyuşmazlığı. - Sepette hesaplanan toplam ürün tutarı ile sepet objesi içinde gönderilen ``total_product_amount`` değerinin aynı olmadığı durumda bu hata alınır. * - INVALID_TOTAL_AMOUNT - Sepetteki toplam sipariş tutarı ile hesaplanan sipariş tutarının uyuşmazlığı. - Sepette hesaplanan toplam sipariş tutarı ile sepet objesi içinde gönderilen ``total_amount`` değerinin aynı olmadığı durumda bu hata alınır. * - INVALID_TOTAL_DISCOUNT_AMOUNT - Sepetteki toplam indirim tutarı ile hesaplanan indirim tutarının uyumsuzluğu. - Sepette hesaplanan toplam indirim tutarı ile sepet objesi içinde gönderilen ``total_discount_amount`` değerinin aynı olmadığı durumda bu hata alınır. * - AMOUNTS_DONT_MATCH - Gönderilen sipariş tutarı ile sepette hesaplanan tutarın uyumsuzluğu. - Sepette hesaplanan toplam sipariş tutarı ile gönderilen sipariş tutarının aynı olmadığı durumda bu hata alınır. * - TRANSACTION_NOT_FOUND - İlgili işlemin bulunamaması. - Ödeme, iade, ya da işlem sorgulamada kullanılan işlemin sistemde bulunamaması durumunda bu hata alınır. * - TRANSACTION_ALREADY_REFUNDED - İadesi zaten yapılmış işlem. - İade edilmek istenen işlemin daha önceden iptal edilmiş olması durumunda bu hata alınır. * - TRANSACTION_CAN_NOT_BE_POST_AUTHED - Son-otorizasyonu yapılması istenen işlemin elverişli olmaması. - Son-otorizasyonu yapılması istenen işlem gerekli kriterleri sağlayamaması durumunda bu hata alınır. * - TRANSACTION_CAN_NOT_BE_UPDATED - İlgili işlemin işleniyor statüsü dışında güncellenememesi. - İlgili işlem üzerinde işleniyor statüsü dışında güncelleme yapılmaya çalışılırsa bu hata alınır. * - INVALID_USER_FOR_PAYMENT_SESSION - Ödeme oturumuna tahsis edilmek istenen kullanıcının geçersiz olması. - Ödeme oturumu oluştururken kullanıcı tahsisi yapılması esnasında uyumsuzluk oluşması durumunda bu hata alınır. Detaylı bilgi için ödeme oturumu oluşturma bölümü incelenebilir. * - SESSION_BELONGS_TO_DIFFERENT_USER - İlgili ödeme oturumu hali hazırda bir kullanıcıya aitse başka kullanıcı için tahsis edilemez. - Var olan bir ödeme oturumu hali hazırda bir kullanıcıya tahsis edilmişse, oturum kullanıcısı değiştirilemez ve bu hata alınır. * - AKIPAY_TRANSACTION_ID_ORDER_ID_CONFLICT - Sadece ``akipay_transaction_id`` ya da ``order_id`` parametresinin gönderilmesi zorunludur. - İstekte hem ``akipay_transaction_id`` hem de ``order_id`` parametresi gönderilirse bu hata alınır. * - USER_NOT_FOUND - Kullanıcı bulunamadı. - İşlem yapmak/yapılmak istenen kullanıcı bulunamadığında bu hata alınır. * - ORDER_ID_EXISTS - Bu Order Id ile daha önceden bir oturum oluşturulmuş. - Ödeme oturumu oluşturma isteğinde gönderilen ``order_id`` ile daha önceden ödeme oturumu oluşturulmuş ise bu hata alınır. * - INVALID_SESSION - Session geçerli değil - Ödeme oturumunda kullanılan ``session`` geçerli değilse bu hata alınır. * - CARD_LIMIT_EXCEEDED - Maksimum kart adedi aşılmış. - Başarılı ödeme sonrasında kart kaydedilmek istendiğinde maksimum kayıtlı kart adedi aşılmış ise bu hata alınır. * - AMOUNT_SHOULDNT_BE_EMPTY - Tutar boş olamaz. - Tutar boş gönderilirse bu hata alınır. * - INVALID_MIN_MAX_AMOUNT_VALUE - Geçersiz min-max tutarı. Lütfen geçerli bir min veya max değeri giriniz. - Taksit güncellemelerinde gönderilen min-max tutar değerlerinin uyumsuz olması durumunda bu hata alınır. * - POS_URL_SHOULDNT_BE_EMPTY - pos_url parametresi boş olamaz. Lütfen ödeme isteğinin gönderileceği url değerini gönderiniz. - Pos url parametresi boş gönderilirse bu hata alınır. * - TEMPLATE_SHOULDNT_BE_EMPTY - template parametresi boş olamaz. Lütfen ödeme isteğini gönderiniz. - template parametresi boş gönderilirse bu hata alınır. * - POS_URL_REQUEST_ERROR - pos_url parametresine istek atılırken sorun oluştu. Lütfen parametreyi kontrol edip tekrar deneyin. - pos_url parametresine istek atılırken bir hata oluştuğunda bu hata alınır. * - POS_URL_UNKNOWN_STATUS_CODE_ERROR - pos_url parametresinden istek cevabı olarak bilinmedik Http Status kodu. - pos_url parametresine istek atılırken bilinmeyen bir http status kodu dönerse bu hata alınır. * - REDIRECT_URL_SHOULD_NOT_BE_EMPTY - redirect_url parametresi boş olamaz. - redirect_url parametresi boş gönderilirse bu hata alınır. * - INVALID_PASSWORD_FORMAT - Şifre en az 8 karakter olmalı, rakam, sembol, büyük ve küçük harf içermelidir. - Şifre istenilen formatı sağlamıyorsa bu hata alınır. * - POS_DOMAIN_ALREADY_EXISTS - Pos domain daha önceden tanımlanmış. - Pos domain daha önceden tanımlanmış ise bu hata alınır. * - POS_DOMAIN_NAME_SHOULD_NOT_BE_EMPTY - Pos domain ismi boş olamaz. - Pos domain ismi boş gönderilirse bu hata alınır. * - POS_DOMAIN_DOMAIN_SHOULD_NOT_BE_EMPTY - Pos domain domaini boş olamaz. - Pos domain domaini boş gönderilirse bu hata alınır. * - INVALID_URL_FORMAT - Geçersiz url formatı. - Geçersiz bir url formatı gönderildiğinde bu hata alınır. * - POS_DOMAIN_NOT_FOUND - Pos domain bulunamadı. - Pos domain bulunamadığında bu hata alınır. * - INVALID_HASHERTYPE - Hashleme tipi bulunamadı. - Hashleme tipi bulunamadığında bu hata alınır. * - INVALID_HASH_VALUES - Hash değerleri, hash tipi ile uyumlu değil. - Hash değerleri, hash tipi ile uyumlu değilse bu hata alınır. * - CARD_IS_PERMANENT - Kayıtlı kart - Zaten kayıtlı bir kartın tekrar kaydedilmeye çalışılması durumunda bu hata alınır. * - INVALID_MERCHANT_CUSTOMER_ID - Geçersiz üye iş yeri müşteri numarası. - Kart kaydetme işlemi sırasında gönderilen üye iş yeri müşteri numarası geçerli değilse bu hata alınır. * - SESSION_DOESNT_HAVE_CUSTOMER - Bu oturum ile ilişkilendilmiş bir müşteri bulunmuyor. - Kart kaydetme işlemi sırasında gönderilen oturum ile ilişkilendirilmiş bir müşteri bulunmuyorsa bu hata alınır. * - INVALID_BIN - Geçersiz Bin Numarası. - Geçersiz bir bin numarası gönderildiğinde bu hata alınır. * - BIN_NOT_FOUND - Bin Numarası bulunamadı. - Bin numarası gönderilmediğinde bu hata alınır. * - BIN_ALREADY_EXIST - Bin Numarası zaten mevcut. - Bin numarası daha önceden kaydedilmiş ise bu hata alınır. * - HASH_MISMATCH - Hash değeri uyuşmazlığı. - Hash değerleri arasında uyuşmazlık olduğunda bu hata alınır. * - PAYMENT_SYSTEM_NOT_FOUND - Ödeme sistemi bulunamadı. - İstekte gönederilen ödeme sistemi bulunamadığında bu hata alınır. * - PAYMENT_SYSTEM_ALREADY_EXIST - Ödeme sistemi zaten mevcut. - Yeni payment system eklenmek istendiğinde daha önceden eklenmiş ise bu hata alınır. * - MERCHANT_POS_NOT_FOUND - Sistemde Tanımlı POS Bilgisi Bulanamadı. - İşlem yapılmak istenen POS bilgisi bulunamadığında bu hata alınır. * - MERCHANT_POS_CODE_ALREADY_EXIST - Pos zaten mevcut. - Kaydedilmek istenen pos daha önceden kaydedilmiş ise bu hata alınır. * - TRANSACTION_ALREADY_REFUNDED - Ödeme iadesi zaten gerçekleşmiş. - Gönderilen işlem daha önceden iade edilmiş ise bu hata alınır. * - TRANSACTION_CAN_NOT_BE_REFUNDED - Ödeme iadesi gerçekleştirilemiyor. - Gönderilen iade tutarı uyuşmazlığından işlem iadesi gerçekleştirilemiyorsa bu hata alınır. * - TRANSACTION_CAN_NOT_BE_POST_AUTHED - Ön Otorizasyon Kapama işlemi gerçekleştirilemiyor. - Ön otorizasyon kapama işlemi gerçekleştirilemiyorsa bu hata alınır. * - CARD_NETWORK_NOT_FOUND - Kart ağı bulunamadı. - Kart ağı bulunamadığında bu hata alınır. * - INSTALLMENT_ALREADY_EXIST - Taksit zaten mevcut. - Taksit kaydedilmek istendiğinde daha önceden kaydedilmiş ise bu hata alınır. * - INSTALLMENT_NOT_FOUND - Taksit bulunamadı. - İşlem yapılmak istenen taksit bulunamadığında bu hata alınır. * - INVALID_INSTALLMENT_COUNT - Geçersiz taksit sayısı. - İşlem yapılmak istenen taksit sayısı geçerli değilse bu hata alınır. * - UNSUPPORTED_CURRENCY_BY_PAYMENT_SYSTEM - Bu kur ödeme sistemi tarafından desteklenmemektedir. - Ödeme sistemi tarafından desteklenmeyen bir kur gönderildiğinde bu hata alınır. * - UNSUPPORTED_ORDER_ID_LENGTH_BY_PAYMENT_SYSTEM - Sipariş numarası uzunluğu ödeme sistemi tarafından desteklenmemektedir. - Sipariş numarası uzunluğu ödeme sistemi tarafından desteklenmeyen bir uzunlukta ise bu hata alınır. * - INVALID_TOTAL_DISCOUNT_AMOUNT - Toplam indirim tutarı (total_discount_amount) parametresi hatalı - Toplam indirim tutarı parametresi hatalı ise bu hata alınır. * - INVALID_BASKET_ITEM_PRICE - Sepet ürünü fiyatı (basket_item_price) parametresi hatalı - Sepet ürünü fiyatı hatası durumunda bu hata alınır. * - INVALID_TOTAL_PRODUCT_AMOUNT - Toplam ürün bedeli (total_product_amount) parametresi hatalı - Toplam ürün bedeli parametresi hatalı ise bu hata alınır. * - INVALID_TOTAL_AMOUNT - Sepet toplam tutar (total_amount) parametresi hatalı - Sepet toplam tutarı ve hesaplanan tutar uyuşmazlığı durumunda bu hata alınır. * - INVALID_TOTAL_AMOUNT - Sepet ve Sipariş tutarları örtüşmüyor. - Gönderilen ve kaydedilmiş olan sipariş tutarları uyuşmazlığı durumunda bu hata alınır. * - MULTIPLE_REFUNDABLE_TRANSACTIONS_FOUND - Birden fazla geri iade edilebilir işlem bulunamaz. - Birden fazla geri iade edilebilir işlem gönderilmek istendiğinde bu hata alınır. * - INVALID_USER_FOR_PAYMENT_SESSION - Kullanıcı adı ödeme oturumu için geçerli değil. - Kullanıcı işlem yapılmak istenen ödeme oturumu ile uyumsuz olduğunda bu hata alınır. * - TRANSACTION_CAN_NOT_BE_UPDATED - Devam etmekte olan işlem harici güncellenemez. - İşlem devam ederken işlem güncellenmek istendiğinde bu hata alınır. * - TRANSACTION_NOT_FOUND - İşlem bulunamadı. - İşlem bulunamadığında bu hata alınır. * - ONLY_PREAUTH_SESSION_CAN_BE_POSTAUTHED - Sadece provizyonlu işlemler onaylanabilir. - Sadece provizyonlu işlemler onaylanabilir. * - MERCHANT_AGREEMENT_COULD_NOT_BE_FETCHED - Üye işyerinden sözleşme alınamadı. - Sorgulanmak istenen sözleşme bulunamadığında bu hata alınır. * - MERCHANT_AGREEMENT_TYPES_COULD_NOT_BE_FETCHED - Üye işyerinden sözleşme tipleri alınamadı. - Sorgulanmak istenen sözleşme tipleri bulunamadığında bu hata alınır. * - GATEWAY_CODE_NOT_FOUND - Ödeme tipi bulunamadı. - İşlem yapılmak istenen ödeme tipi bulunamadığında bu hata alınır. * - ORDER_ID_LIST_SHOULD_NOT_BE_EMPTY - Sipariş listesi boş olamaz. - Sipariş listesi boş gönderildiğinde bu hata alınır. * - MERCHANT_POS_IS_NOT_ACTIVE - Pos aktif değil. - İşlem yapılmak istenen pos aktif değilse bu hata alınır. * - ALREADY_WAITING_EXPORT_REPORT_REQUEST - Bekleyen rapor yükleme talebi mevcut. - Bekleyen rapor yükleme talebi mevcutsa bu hata alınır. * - ONE_SHOT_CANNOT_BE_INACTIVE - Tek taksit pasif olamaz! - Tek taksit pasif yapılmak istendiğinde bu hata alınır. * - PARTIAL_VOID_NOT_SUPPORTED - Kısmi iptal işlemi desteklenmemektedir. - Desteklenmeyen bir işlem kısmi iptal işlemi yapılmak istendiğinde bu hata alınır. * - THE_AMOUNT_DOES_NOT_MATCH_TO_TOTAL_PAID_AMOUNT - İptal edilecek tutar toplam ödenen tutara eşit değil. - İptal edilmek istenen tutar ve toplam ödenen tutar uyuşmazlığı durumunda bu hata alınır. * - REFUND_AMOUNT_CANNOT_EXCEED_TRANSACTION_AMOUNT - İade tutarı, işlem tutarını aşamaz. - İade tutarı, işlem tutarını geçersen bu hata alınır. * - SESSION_TOKEN_OR_BASKET_ITEM_NOT_FOUND - Oturum bilgisi veya sepet ürünü bulunamadı. - Oturum bilgisi veya sepet ürünü bulunamadığında bu hata alınır. * - INVALID_SESSION_TO_REVIEW - Değerlendirme yapılacak oturum geçerli değil. - Değerlendirme yapılmak istenen oturum geçerli değilse bu hata alınır. * - INVALID_REVIEW_DATE - Değerlendirme yapılabilecek tarih aralığı geçerli değil. - Değerlendirme yapılmak istendiğinde tarih geçerli değilse bu hata alınır. * - PRODUCT_REVIEW_ALREADY_EXISTS - Bu ürüne ait bir değerlendirme zaten mevcut. - Değerlendirme yapılacak ürüne ait bir değerlendirme zaten mevcut ise bu hata alınır. * - PRODUCT_REVIEW_ALREADY_DELETED - Ürün değerlendirmesi daha önce silinmiş. - Silinmek istenen ürün değerlendirmesi daha önceden silinmiş ise bu hata alınır. * - BASKET_ITEM_NOT_FOUND - Sepet ürünü bulunamadı. - İşlem yapılmak istenen sepet ürünü bulunamadığında bu hata alınır. * - PRODUCT_REVIEW_NOT_FOUND - Ürün değerlendirmesi bulunamadı. - Sorgulanan ürün değerlendirmesi bulunamadığında bu hata alınır. * - INVALID_REVIEW_STATUS - Değerlendirme durumu geçerli değil. - Kullanılmak istenen değerlendirme durumu geçerli değilse bu hata alınır. * - REVIEW_ALREADY_REJECTED - Değerlendirme daha önce reddedilmiş. - Değerlendirme daha önce reddedilmiş ise bu hata alınır. * - REVIEW_INVITATION_ALREADY_EXISTS - Değerlendirme davet zaten mevcut - Değerlendirme daveti daha önceden yapılmış ise bu hata alınır. * - REVIEW_INVITATION_NOT_FOUND - Değerlendirme daveti bulunamadı. - Değerlendirme daveti bulunamadığında bu hata alınır. * - REVIEW_INVITATION_EXPIRED - Değerlendirme davetinin süresi doldu. - Değerlendirme davetinin süresi geçtiğinde bu hata alınır. * - PAYMENT_INTENT_FAILED - Üye İşyeri kaynaklı hata oluştu. - Ödeme niyetinde bir hata oluştuğunda bu hata alınır.