Changelog

Reset note. payfyio was rebooted as v1.0 — a clean break with a unified contract across every provider. Anything from earlier development cycles is archived at the bottom of this page for historical reference only and does not apply to v1.x. Migration from pre-reset versions is unsupported; install v1.0 fresh.

v1.0.0 — Initial release

The first stable release. One contract, every provider.

Providers

• 5 gateways — İyzico, PayTR, Parampos, Stripe, PayPal
• 5 Turkish bank Virtual POS integrations — Akbank, Garanti BBVA, İş Bankası, Yapı Kredi, Ziraat Bankası

Core API

• Single Payfyio class — defaultProvider + providers map
• Runtime provider switching via payment.use("provider")
• Typed getters per provider (payment.iyzico, payment.akbank, …)
• getEnabledProviders() and isProviderEnabled() helpers

Payment surface

• createPayment — direct card charge (2D)
• initThreeDSPayment / completeThreeDSPayment — 3D Secure flow
• initCheckoutForm — hosted checkout / iframe
• refund — full and partial
• cancel — same-day void
• getPayment — status lookup
• Provider extras: binCheck, installmentInfo, subscription billing (İyzico)

Transport

• PayfyioHandler — drop-in REST handler for Next.js / Express
• PayfyioClient + createPayfyioClient — typed browser client
• Unified error shape across every provider
• Normalized currency codes and amount formats

Engineering

• 100% TypeScript, fully typed
• One peer dependency (axios)
• HMAC-SHA256 / SHA-512 signature validation built in
• MIT licensed

Coming next

• payfyio cloud — hosted dashboard, GitHub OAuth, encrypted credential vault, snippet embed (separate beta track)

---

Pre-1.0 (archived)

Earlier iterations of this library shipped under different class names and adapter layouts before the v1.0 reset. They are listed here for historical context only — do not target them in new code.

• Older internal class hierarchy (now unified under Payfyio*)
• payfyio/adapters/next-js, payfyio/adapters/node adapter layout
• Previous provider count and feature scope