Sürüm notları

0.11.0Copy Anchor Link

EklenenlerCopy Anchor Link

• chaos plugin'i: uygulamanızın ret, kaybolan yanıt (NETWORK_ERROR) ve gecikmeleri nasıl karşıladığını test etmek için işlemlere bunları enjekte eder. allowProduction verilmedikçe production modunda çalışmaz.
• EST sağlayıcısı: İş Bankası, Ziraat Bankası, Halkbank, TEB ve Şekerbank tek bir sağlayıcıyla. 3D'siz ve 3D Secure ödeme (3D, 3D Pay, 3D Host, hash ver3), iade, iptal ve sipariş durumu sorgusu desteklenir. 3D callback'leri bankayla doğrulanır.
• notifications plugin'i: satışları, iadeleri ve başarısız ödemeleri arka planda ve kart verisi olmadan Slack, Discord, Telegram veya kendi kanalınıza gönderir. Başarısız olan bir kanal ödemeyi asla etkilemez.
• Sipay sağlayıcısı: 3D'siz ve 3D Secure ödeme, Sipay'in şifreli hash_key alanıyla doğrulanan 3D callback'leri, tam ve kısmi iade, iptal, durum sorgusu, ön provizyon ve BIN/taksit sorgusu. Sipay test ortamında uçtan uca doğrulandı.

0.10.0Copy Anchor Link

EklenenlerCopy Anchor Link

• Kuveyt Türk sağlayıcısı: KT Pay Gate üzerinden 3D Secure ödeme; sipariş bankada kontrol edildikten sonra Provision ile tamamlanır. Aynı gün iptal, tam ve kısmi iade ve durum sorgusu da desteklenir.

0.9.0Copy Anchor Link

EklenenlerCopy Anchor Link

• Handler yanıtları exposeRawResponse: true verilmedikçe sağlayıcının rawResponse alanını içermez; idempotency.scope farklı çağıranların Idempotency-Key yanıtlarını birbirinden ayırır.

DüzeltilenlerCopy Anchor Link

• buyer.email doğrulaması boş alan adı bölümlerini reddeder ve artık geri izleme yapan bir düzenli ifade kullanmaz.

0.8.1Copy Anchor Link

DüzeltilenlerCopy Anchor Link

• Framework adapter'ları 1 MiB'tan büyük istek gövdelerini belleğe okumak yerine 413 ile yanıtlar; sınırı maxBodySize ile değiştirebilirsiniz.
• Akbank: 3D Secure callback'leri sipariş geçmişi sorgusuyla doğrulanır; Akbank'taki sipariş kaydıyla eşleşmeyen callback reddedilir.
• HTTP handler form gövdesini yalnızca sağlayıcı callback'lerinde kabul eder; diğer aksiyonlar 415 döner, böylece başka bir sitedeki form bunları kullanıcının cookie'leriyle çağıramaz.
• Logger'a verilen hatalar artık sağlayıcı isteğinin gövdesini ve başlıklarını (kart verisi, kimlik bilgileri) içermiyor.
• iyzico: başarısız bir 3D Secure sonucu artık callback isteğinden alınan paymentId veya conversationId taşımıyor.

0.8.0Copy Anchor Link

React Router adaptörü.

EklenenlerCopy Anchor Link

• React Router adaptörü: better-payment/react-router, bir splat resource route için loader ve action döndürür; React Router v7 ve Remix v2 ile çalışır.

0.7.0Copy Anchor Link

Sepet yardımcısı, Arapça hata mesajları ve iyzico'da paymentId ile iade. iyzico için geriye uyumsuz: aşağıdaki iade maddesine bakın.

Değişenler (geriye uyumsuz)Copy Anchor Link

• iyzico iadeleri: refund(), cancel() ve getPayment() gibi ödemenin paymentId'sini alır ve ödemenin tamamından bir tutarı iade eder (/v2/payment/refund). Tek bir sepet kalemini iade etmek için ayrıca o kalemin paymentTransactionId'sini verin. paymentId alanına paymentTransactionId geçen kodun bu değeri yeni paymentTransactionId alanına taşıması gerekir.

EklenenlerCopy Anchor Link

• buildBasket(): indirimleri ve kargoyu sepet kalemlerine dağıtır; kalemlerin toplamı ödeme tutarını kuruşu kuruşuna tutar.
• Hata mesajları için dil desteği: Arapça (ar). Handler'da Accept-Language: ar Arapça'yı seçer. Katkısı için @poyrazavsever'e teşekkürler.

0.6.0Copy Anchor Link

EklenenlerCopy Anchor Link

• Elysia adapter'ı: better-payment/elysia handler'ı Elysia'ya (Bun) tek satırda bağlar: app.all('/api/pay/*', toElysiaHandler(payment), { parse: 'none' }). Katkısı için @ScottHallchico'ya teşekkürler.

0.5.2Copy Anchor Link

EklenenlerCopy Anchor Link

• Hata mesajları için dil desteği: Rusça (ru). Handler'da Accept-Language: ru-RU Rusça'yı seçer. Katkısı için @ius-sharma'ya teşekkürler.

0.5.1Copy Anchor Link

EklenenlerCopy Anchor Link

• Hata mesajları için dil desteği: Almanca (de). Handler'da Accept-Language: de-DE Almanca'yı seçer. Katkısı için @ius-sharma'ya teşekkürler.

DeğişenlerCopy Anchor Link

• Repo czaydev/better-payment adresine taşındı.

0.5.0Copy Anchor Link

Plugin'ler ve tipli ödeme olayları. Geriye uyumsuz: new BetterPayment() yerine betterPayment() geldi; sağlayıcılar fabrika fonksiyonlarıyla oluşturuluyor. Bkz. 0.5'e geçiş.

Değişenler (geriye uyumsuz)Copy Anchor Link

• BetterPayment sınıfının yerini betterPayment({ providers, plugins }) aldı; sağlayıcılar iyzico(), paytr(), akbank() ve parampos() ile oluşturuluyor. enabled alanı kaldırıldı.
• providers içindeki her anahtar bir sağlayıcı kimliğidir; payment.<id> sağlayıcıya göre tiplidir. getEnabledProviders() string[] döner.

EklenenlerCopy Anchor Link

• Plugin'ler: sağlayıcı işlemleri için before/after hook'ları, tipli metotlar, handler endpoint'leri ve hata kodları. Kendi plugin'inizi birkaç satırda yazın.
• Ödeme olayları: her sağlayıcı ve akış için tek bir tipli dinleyici; yalnızca doğrulanmış sonuçlar için yayınlanır.
• Hata mesajları için dil desteği: better-payment/plugins altındaki ilk resmi plugin. Müşteriye yönelik İngilizce ve Türkçe mesajlar.
• defineProvider() ile özel sağlayıcılar ve imzalama için WebCrypto yardımcıları.

0.4.0Copy Anchor Link

Sandbox olmadan test ve tek satırlık framework entegrasyonu. Mevcut 0.3.0 kodu çalışmaya devam eder.

EklenenlerCopy Anchor Link

• better-payment/testing: uygulama testleri için kimlik bilgisi ve ağ erişimi gerektirmeyen, bellek içi bir sağlayıcı olan MockProvider. Sihirli kart numaraları retleri, 3D Secure hatalarını, kaybolan yanıtları ve başarısız iadeleri kapsar; 3D Secure callback'leri gerçek handler'dan geçer.
• Framework adapter'ları: better-payment/next, better-payment/express, better-payment/fastify ve better-payment/hono handler'ı tek satırda bağlar; toFetchHandler Workers, Deno ve Bun'u kapsar.
• Dokümantasyon artık Türkçe de okunabiliyor.

DeğişenlerCopy Anchor Link

• PROVIDER_DEFAULT_URLS, RemoteProviderType ile tiplenir (mock dışındaki tüm sağlayıcılar).

0.3.0Copy Anchor Link

Edge ortamları ve sıfır runtime bağımlılığı. Uygulama kodu değişmeden çalışmaya devam eder.

EklenenlerCopy Anchor Link

• Edge ortamı desteği: aynı paket Node.js 20+, Vercel Edge, Cloudflare Workers, Deno ve Bun'da çalışır. Yalnızca fetch ve WebCrypto kullanır.
• Özel bir fetch uygulaması (proxy, test stub'ları) için fetch seçeneği.
• Özel sağlayıcılar için HttpClient ve HttpError dışa açıldı.

DeğişenlerCopy Anchor Link

• Runtime bağımlılığı yok: axios kaldırıldı. Zaman aşımları, loglama ve yeniden deneme kuralları değişmedi.
• PaymentProvider'dan türeyen özel sağlayıcılar setupAxiosLogging() / setupAxiosRetry() yerine createHttpClient() kullanır.

0.2.0Copy Anchor Link

Ön provizyon ve kayıtlı kartlar. Mevcut 0.1.0 kodu çalışmaya devam eder. İki özellik de her gece gerçek iyzico sandbox'ına karşı test edilir.

EklenenlerCopy Anchor Link

• Ön provizyon: authorize() / initThreeDSAuthorize() tutarı bloke eder, capture() tahsil eder (kısmi capture desteklenir) ve voidAuthorization() serbest bırakır. iyzico, Parampos ve Akbank; PayTR henüz desteklenmiyor.
• Kayıtlı kartlar: ödeme sırasında saveCard ile kartı kaydedin, sonra storedCard: { customerToken, cardToken } ile ödeme alın ve kartları saveCard(), listCards() ve deleteCard() ile yönetin. iyzico ve PayTR; Parampos ve Akbank henüz desteklenmiyor.
• İkisi için handler route'ları ve tarayıcı client metotları. Capture, void ve kart route'ları bir authorize hook'u gerektirir.

DeğişenlerCopy Anchor Link

• PaymentRequest.paymentCard tiplerde opsiyonel; çalışma anında paymentCard ya da storedCard'dan biri zorunludur.
• Bir sağlayıcı bir işlemi desteklemediğinde handler 500 yerine 400 döner.

0.1.0Copy Anchor Link

Sıfırlamadan sonraki ilk özellik sürümü. Mevcut 0.0.1 kodu çalışmaya devam eder; davranış değişiklikleri "Değişenler" altında listelenir. iyzico entegrasyonu artık her gece gerçek iyzico sandbox'ına karşı test ediliyor.

EklenenlerCopy Anchor Link

• Birleşik hata kodları: her başarısız sonuç bir code taşır (INSUFFICIENT_FUNDS, CARD_DECLINED, THREEDS_FAILED, INVALID_HASH, ...). errorCode sağlayıcının ham kodunu korur.
• Sağlayıcı çağrılmadan önce istek doğrulama. Geçersiz istekler tüm geçersiz alanları listeleyerek code: 'INVALID_REQUEST' döner. validate: false ile kapatılabilir.
• Parampos taksitleri: installmentInfo(), calculatePaidPrice() ve getInstallmentRates() Param oranlarınızı kullanır.
• Tekrar eden callback'ler bir kez işlenir; veri değiştiren handler route'ları Idempotency-Key başlığını kabul eder. IdempotencyStore varsayılan olarak bellek içidir; birden çok örnekle Redis ya da bir veritabanı kullanın.
• PaymentErrorCode ve PaymentStatus, better-payment/client'tan dışa açılır.

DeğişenlerCopy Anchor Link

• İstek doğrulama hataları errorCode: 'VALIDATION_ERROR' döner; önceden errorCode boştu.
• any içermeyen daha sıkı public tipler: rawResponse ve handler gövdeleri unknown; onCallback / callbackRedirect bir PaymentResponse alır.
• NETWORK_ERROR mesajları taşıma hatasının adını verir (ECONNRESET, zaman aşımı, ...).
• Yayınlanan build küçültüldü: 29.6 kB yerine yaklaşık 19 kB gzip.

0.0.1Copy Anchor Link

GüvenlikCopy Anchor Link

• Parampos: 3D callback hash'i yalnızca yapılandırmanızdaki GUID ile doğrulanır. Önceki sürümler GUID'i callback içeriğinden okuyordu; bu da herkesin başarılı bir ödeme uydurmasına izin veriyordu.
• Parampos / Akbank: bir 3D callback tek başına artık başarılı ödeme sayılmıyor. Parampos TP_WMD_Pay ile tamamlar; Akbank HMAC imzalı sonuçla 3D_PAY modelini kullanır. Eksik bir sonuç kodu artık başarı sayılmıyor.
• HTTP handler: varsayılan olarak güvenli. Varsayılan olarak yalnızca callback'leri ve kart sorgularını açar. İade, iptal, ödeme sorgusu ve abonelik yönetimi bir authorize hook'u gerektirir.
• Yeniden denemeler yalnızca idempotent istekleri tekrar gönderir; böylece bir zaman aşımı artık çift çekime ya da çift iadeye yol açamaz.
• İmzalar sabit sürede karşılaştırılır.

Sağlayıcı düzeltmeleriCopy Anchor Link

• PayTR: istekler merchant_key ile, imzalanan veriye merchant_salt eklenerek imzalanır. user_basket, TL fiyatlı base64 JSON'dur. merchant_oid alfanümerik olmalıdır. test_mode sandbox moduna göre ayarlanır. İade tutarları TL cinsindendir. Durum sorguları /odeme/durum-sorgu kullanır. Bildirimler düz OK ile yanıtlanır. Gizli anahtarlar artık istek gövdelerinde gönderilmiyor.
• Parampos: TP_WMD_UCD / TP_WMD_Pay, virgüllü ondalık tutarlar ve dokümante edilen hash kullanılır. İade ve iptaller TP_Islem_Iptal_Iade_Kismi2, durum sorguları TP_Islem_Sorgulama4, BIN sorguları BIN_SanalPos kullanır. Uydurma taksit oranları kaldırıldı.
• Akbank: Akbank Sanal POS JSON API'sine göre yeniden yazıldı.
• iyzico: Checkout Form ve PWI sonuçları ödemenin kendi durumunu (paymentStatus) bildirir. 3DS tamamlama mdStatus=1 şartı arar. retrieveSubscription GET kullanır.

Geriye uyumsuz değişiklikler (3.x'e göre)Copy Anchor Link