diff --git a/docs/migration-guide/MIGRATION_GUIDE.md b/docs/migration-guide/MIGRATION_GUIDE.md new file mode 100644 index 0000000..5128e32 --- /dev/null +++ b/docs/migration-guide/MIGRATION_GUIDE.md @@ -0,0 +1,467 @@ +# Migration Guide — Legacy iFrame SDK → Checkout Web SDK + +A side-by-side API map for merchants moving from the legacy `Spreedly.*` iFrame +library to the new Checkout Web SDK (`SpreedlyHostedFields` / +`SpreedlyExpressCheckout`). + +**Conventions used in this doc** + +- ✅ — direct equivalent +- 🆕 — new in Checkout Web SDK (no legacy counterpart) +- ❌ TODO — exists in legacy, not yet in Checkout Web SDK + +> Click to Pay (legacy `c2p*`) and Stripe Radar (legacy `Spreedly.stripeRadar`) +> are **out of scope** for this guide. + +--- + +## Table of Contents + +1. [Script tag](#script-tag) +2. [Initialization & lifecycle](#initialization--lifecycle) +3. [Field configuration](#field-configuration) +4. [Tokenization (submit)](#tokenization-submit) +5. [Recaching](#recaching) +6. [Events](#events) +7. [3DS — Global / Forter](#3ds--global--forter) +8. [3DS — Gateway-Specific](#3ds--gateway-specific) +9. [Offsite payments — PayPal & redirect-style](#offsite-payments--paypal--redirect-style) +10. [Offsite payments — Stripe APM](#offsite-payments--stripe-apm) +11. [Offsite payments — Braintree (PayPal/Venmo)](#offsite-payments--braintree-paypalvenmo) +12. [ACH payments 🆕](#ach-payments-) +13. [Express Checkout 🆕](#express-checkout-) +14. [Not yet migrated](#not-yet-migrated) + +--- + +## Script tag + +| Legacy iFrame | Checkout Web SDK | +|---|---| +| `