توضیحات
پرداختهای پیپل ووکامرس یک راهکار همه-در-یک است تا به شما کمک کند با ارائه پیپل، Venmo (ایالات متحده)، گزینههای پرداخت در آینده، کارتهای اعتباری و نقدی و موارد دیگر نرخ تبدیل را به حداکثر برسانید.
امکانات
- دسترسی فوری به وجوه در حالی که پرداخت در حال پردازش است.
- تشخیص تقلب و انطباق جهانی (شامل PCI، PSD2 و 3D Secure).
- پرداخت نهایی سریعتر از طریق دکمههای پیپل در صفحات محصول و در سبد خرید.
- راحتی برای پرداخت در طول زمان با پرداخت در آینده پیپل.
- اجازه به خریداران Venmo (فقط ایالات متحده) برای اشتراکگذاری خریدها با دوستان.
- گزینههای پردازش کارت استاندارد و پیشرفته.
- روشهای پرداخت مختص کشور برای ایجاد اعتماد جهانی.
- گزینههای متعدد پرداخت اشتراک برای کمک به ایجاد کسبوکار تکرارشونده.
شروع کنید
اگر در پیپل تازهکار هستید، امروز آن را به فروشگاه خود اضافه کنید. کاربر فعلی هستید؟ ادغام خود را ارتقا دهید تا اکنون به این ویژگیهای هیجانانگیز دسترسی پیدا کنید.
استفاده از پیپل میارزد
دریافت دسترسی فوری به وجوه در حساب تجاری پیپل خود در حالی که پرداخت در حال پردازش است. صرفهجویی در زمان و هزینه با ویژگیهای تشخیص تقلب و حفاظت فروشنده†.
علاوه بر این، شما با استانداردهای انطباق جهانی (مانند PCI، PSD2، SCA و 3D Secure) مطابقت خواهید داشت، که بازارهای بینالمللی را در دسترس قرار میدهد.
†موجود در خریدهای واجد شرایط. محدودیتها اعمال میشود.
گزینههای پرداخت انعطافپذیر
خریداران تقریباً سه برابر بیشتر تمایل به خرید دارند زمانی که شما پیپل را ارائه میدهید.¹ افزایش نرخ تبدیل با نمایش خودکار دکمههای پیپل در صفحات محصول، در سبد خرید و در پرداخت نهایی.
گزینههای پرداخت در آینده پیپل به افزایش نرخ تبدیل و افزایش حجم سبد خرید تا ۳۹٪ کمک میکنند.² به مشتریان اجازه دهید در طول زمان پرداخت کنند در حالی که شما وجه را پیشاپیش دریافت میکنید — بدون هزینه اضافی. موجود در کشورهای منتخب. درباره پیامرسانی پرداخت در آینده بیشتر بدانید.
کاربران Venmo سالانه ۲.۲ برابر بیشتر در خریدهای آنلاین نسبت به سایر خریداران آنلاین خرج میکنند.³ اکنون میتوانید به خریداران Venmo دسترسی پیدا کنید (فقط ایالات متحده) و به آنها اجازه دهید خریدهای خود را با دوستانشان به اشتراک بگذارند.
پرداختهای مختص کشور
- پردازش کارت استاندارد: مناسب برای تمام حسابهای فروشنده تجاری و شخصی. تراکنشهای کارتی از طریق یک تجربه کاربری پیشساخته مدیریت میشوند، که انطباق را ساده میکند.
- پردازش کارت پیشرفته: شخصیسازی ظاهر، حس و محل قرارگیری فیلدهای پرداخت کارت نقدی و اعتباری. شما همچنین میتوانید از ابزارهای مقابله با تقلب برای راهاندازی فیلترهای تحمل ریسک شخصی استفاده نمایید.
کسب درآمد دورهای از طریق اشتراکها
ایجاد کسبوکار تکرارشونده برای درآمد پایدار و قابل پیشبینی با استفاده از اشتراکهای ووکامرس یا اشتراکهای پیپل.
شما همچنین میتوانید از ویژگی ذخیرهسازی امن پیپل استفاده کنید برای:
- ارائه طرحهای انعطافپذیر با قیمتگذاری ثابت یا مبتنی بر تعداد.
- تنظیم دورههای صورتحساب برای هر بازه زمانی.
- ارائه دورههای آزمایشی تخفیفدار یا پرداختهای محاسبه نسبی.
بدون کارمزد ماهانه یا راهاندازی، برای مشتریان شما ساده است — و برای کسبوکار شما عالی است (تأیید حساب مورد نیاز است).
افشای حقوقی:
*For Australian users, the PayPal service is provided by PayPal Australia Pty Limited AFSL 304962. Any information provided is general only and does not take into account your objectives, financial situation, or needs. Please read and consider the CFSGPDS (paypal.com.au) before acquiring or using the service. See website for TMD.
- یک مطالعه آنلاین به سفارش پیپل و انجامشده توسط Netfluential در نوامبر ۲۰۲۰، شامل ۱۰۰۰ خریدار آنلاین آمریکایی ۱۸ تا ۳۹ ساله.
- درآمد سه ماهه دوم پیپل ۲۰۲۱.
- روندهای ادیسون به سفارش پیپل، آوریل ۲۰۲۰ تا مارس ۲۰۲۱. روندهای ادیسون یک پنل رفتاری از رسیدهای ایمیل ۳۰۶،۹۳۹ مصرفکننده آمریکایی و بیش از ۳.۴ میلیون خرید را در سطح عمودی بین کاربران پرداخت با Venmo و غیر Venmo در طی یک دوره ۱۲ ماهه انجام داد.
عکسهای صفحه






بلوکها
این افزونه 6 بلوک ارائه میدهد.
- Single Product – PayPal buttons PayPal Smart Buttons shown on the single product page so eligible customers can check out directly.
- Single Product – PayPal Pay Later messaging PayPal Pay Later messaging shown on the single product page. Customers automatically see the most relevant Pay Later offering.
- PayPal Pay Later messaging PayPal Pay Later messaging will be displayed for eligible customers. Customers automatically see the most relevant Pay Later offering.
- Cart – PayPal Pay Later messaging PayPal Pay Later messaging will be displayed for eligible customers. Customers automatically see the most relevant Pay Later offering.
- Checkout – PayPal Pay Later messaging PayPal Pay Later messaging will be displayed for eligible customers. Customers automatically see the most relevant Pay Later offering.
- Mini-Cart – PayPal buttons PayPal Smart Buttons shown in the Mini-Cart so eligible customers can check out directly.
نصب
الزامات
برای نصب و پیکربندی پرداختهای پیپل ووکامرس، نیاز خواهید داشت به:
- نسخه وردپرس ۶.۳ یا جدیدتر (نصب شده)
- نسخه ووکامرس ۹.۶ یا جدیدتر (نصب و فعال شده)
- نسخه PHP 7.4 یا جدیدتر
- حساب تجاری یا شخصی پیپل
دستورالعملهای نصب
- به مدیریت وردپرس وارد شوید.
- به افزونهها > افزودن بروید.
- افزونه پرداختهای پیپل ووکامرس را جستجو نمایید.
- روی هماکنون نصب نمایید کلیک کنید و منتظر بمانید تا افزونه با موفقیت نصب شود.
- شما میتوانید افزونه را بلافاصله با کلیک بر روی فعال نمایید اکنون در صفحه موفقیت فعال کنید. اگر میخواهید بعداً آن را فعال نمایید، میتوانید این کار را از طریق افزونهها > افزونههای نصبشده انجام دهید.
راهاندازی و پیکربندی
مراحل زیر را برای اتصال افزونه به حساب پیپل خود دنبال نمایید:
- پس از اینکه افزونه پرداختهای پیپل ووکامرس را فعال کردید، به ووکامرس > پیکربندی بروید.
- روی زبانه پرداختها کلیک نمایید.
- لیست روشهای پرداخت ممکن است شامل دو گزینه پیپل باشد. روی پیپل کلیک نمایید (نه پیپل استاندارد).
- روی دکمه فعالسازی پیپل کلیک نمایید.
- به حساب پیپل خود وارد شوید. اگر هنوز حساب پیپل ندارید، برای یک حساب تجاری یا شخصی جدید پیپل نامنویسی کنید.
- پس از اینکه با موفقیت حساب پیپل خود را متصل کردید، روی زبانه پرداختهای استاندارد کلیک نمایید و کادر انتخاب فعالسازی ویژگیهای پیپل برای فروشگاه شما را علامت بزنید تا پیپل فعال شود.
- روی ذخیره تغییرات کلیک نمایید.
دستورالعملهای کامل آمادهسازی را میتوان در مستندات اینجا یافت.
بهروزرسانی
بهروزرسانیهای خودکار باید بهطور کلی روان کار کنند، اما ما همچنان توصیه میکنیم از سایت خود پشتیبانگیری نمایید.
اگر پس از بهروزرسانی با مشکل عدم نمایش دکمههای پیپل مواجه شدید، کش وبسایت خود را پاکسازی نمایید. کش کردن یا فشردهسازی جاوا اسکریپت میتواند بر پرداختهای پیپل تأثیر بگذارد و باید برای اسکریپتهای پیپل یا صفحات مربوط به پرداخت غیرفعال شود.
سوالات متداول
-
کجا میتوانم مستندات و راهنمای راهاندازی را پیدا کنم؟
-
شما به جای درستی آمدهاید. مستندات ما برای پرداختهای پیپل ووکامرس شامل دستورالعملهای دقیق راهاندازی، نکات عیبیابی و موارد دیگر است.
-
کجا میتوانم پشتیبانی دریافت کنم، باگها را گزارش دهم یا ویژگیهای جدید درخواست کنم؟
-
برای شروع، نکات عیبیابی ما را بررسی کنید برای پاسخ به سوالات رایج. سپس، اگر به کمک بیشتری نیاز دارید، از طریق انجمن پشتیبانی رسمی تماس بگیرید.
لطفاً باگها را از طریق گیتهاب یا انجمن پشتیبانی رسمی گزارش دهید. شما میتوانید ویژگیهای جدید را در تخته درخواست ویژگی ما درخواست کنید (یا به آنها رأی دهید).
-
پرداختهای پیپل ووکامرس متوقف شده است — چه کاری باید انجام دهم؟
-
ابتدا، مشکل را با استفاده از راهنمای عیبیابی ما تشخیص دهید. اگر پس از بهروزرسانی یک افزونه یا پوسته متوجه خطایی شدید، ممکن است یک مشکل ناسازگاری وجود داشته باشد.
ما توصیه میکنیم یک آزمایش تداخل با استفاده از بررسی سلامت (که به شما اجازه میدهد پوستهها و افزونهها را بدون تأثیر بر فروشگاه زنده خود غیرفعال کنید) اجرا کنید یا از طریق یک سایت آزمایشی آزمایش نمایید.
-
آیا این افزونه از اشتراکها پشتیبانی میکند؟
-
بله! پرداختهای پیپل ووکامرس میتواند با اشتراکهای ووکامرس و اشتراکهای پیپل استفاده شود. شما همچنین میتوانید از ذخیرهسازی امن برای ذخیره روشهای پرداخت مشتریان برای تراکنشهای آینده استفاده نمایید. سوالات متداول اشتراکهای ما را بررسی کنید.
-
آیا این افزونه از بلوکهای ووکامرس پشتیبانی میکند؟
-
بله! پرداختهای پیپل ووکامرس پشتیبانی آزمایشی برای بلوکهای سبد خرید و پرداخت نهایی ارائه میدهد. سوالات متداول بلوکهای ما را بررسی کنید.
-
آیا ویژگیهای جدیدی در حال توسعه هستند؟
-
بله! سوالات متداول پیشنمایش ویژگیهای ما را بررسی کنید برای جزئیات بیشتر.
-
آیا میتوانم در پرداختهای پیپل ووکامرس مشارکت کنم؟
-
بله، میتوانید! به مخزن گیتهاب ما بپیوندید.
اگر این افزونه را دوست دارید، لطفاً یک دیدگاه در WordPress.org یا WooCommerce.com بگذارید — بازخورد ارزشمند شما قدردانی میشود.
-
سوال من در لیست نیست؛ کجا میتوانم پاسخهای بیشتری پیدا کنم؟
نقد و بررسیها
توسعه دهندگان و همکاران
“پرداختهای پیپل ووکامرس” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کردهاند.
مشارکت کنندگان“پرداختهای پیپل ووکامرس” به 16 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمکهایشان.
ترجمه “پرداختهای پیپل ووکامرس” به زبان شما.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
4.2.0 – 2026-10-21
- Enhancement – PayPal JS SDK v6 is now the default for all stores, including existing ones; SDK v5 remains available as a fallback via
woocommerce.feature-flags.woocommerce_paypal_payments.sdk_v6_enabledfilter #4720 - Enhancement – Remove the leftover checks that let vaulting disable Pay Later, including the
woocommerce_paypal_payments_pay_later_with_vaultingfilter #4736 - Enhancement – Enable the Pay Later payment method after onboarding on every onboarding path, keeping the merchant’s previous choice on reconnect #4733
- Enhancement – Render PayPal buttons and Pay Later messaging in block theme templates and the Site Editor #4731
- Enhancement – Show PayPal buttons and Pay Later messaging in the block theme Single Product template, with messaging placed below the price by default #4759
- Enhancement – PayPal buttons in the WooCommerce Mini Cart block, on the frontend and in the Site Editor #4767
- Enhancement – Calculate Pay Later messaging installment amounts on the page with SDK v6 instead of through cart simulation, so amounts update instantly #4729
- Enhancement – Keep WooCommerce’s “Place order” button label instead of replacing it with “Proceed to PayPal”, and remove the PayPal redirect notice from Block Checkout #4704
- Enhancement – Debit & Credit Cards redirect gateway for Block Checkout with SDK v6 #4688
- Enhancement – Remove the deprecated cardholder name field and its settings toggle for advanced card payments with SDK v6 #4713
- Enhancement – Send the buyer’s email, name, phone and billing address when creating a card payment to reduce card risk declines #4650
- Enhancement – Rework the Abilities API module to use the existing dependency injection system #4698
- Enhancement – Show a “Place order” fallback that redirects to PayPal when the PayPal buttons fail to load on SDK v6 classic checkout #4777
- Enhancement – Enable the PayPal and Advanced Card Processing gateway logos by default for new setups #4794
- Enhancement – Add Apple Pay frontend logging and more detailed log prefixes to diagnose payments failing only on live sites #4680
- Fix – reCAPTCHA v3 token verified twice on SDK v6 classic checkout, causing a fallback to the v2 challenge #4761
- Fix – PayPal buttons, card fields and Pay Later messages stop working on SDK v6 when a page stays open longer than 15 minutes #4772
- Fix – PayPal buttons disappear after several page loads on SDK v6 due to a client token rate limit #4755
- Fix – Fatal error on WooCommerce versions below 10.9 #4753
- Fix – Venmo shown on SDK v6 even when disabled #4764
- Fix – Advanced Card Processing support for Mexico merchants with SDK v6 #4730
- Fix – Excessive PayPal API requests for orders that no longer exist on SDK v6, keeping customer sessions alive for days #4735
- Fix – “Order total has changed” error when paying for a free trial subscription from the product page #4762
- Fix – Pay Later messaging settings checkboxes not keeping their saved state on SDK v6 #4752
- Fix – Fastlane classic checkout on SDK v6 shows plain country dropdowns instead of the enhanced WooCommerce fields #4754
- Fix – Native “Proceed to PayPal” button intermittently shown next to the PayPal buttons on SDK v6 classic checkout #4766
- Fix – PayPal buttons on product and cart pages redirect to checkout instead of completing the order when Pay Now is enabled on SDK v6 #4699
- Fix – PayPal gateway missing on Block Checkout and PayPal button missing on classic checkout for free trial subscriptions #4725
- Fix – Advanced Card Processing payment fails when part of the order is paid with store credit #4689
- Fix – Cart emptied when adding a product while a cart simulation request is running #4708
- Fix – Shipping line item missing from the order after a failed Advanced Card Processing payment and successful retry #4694
- Fix – Payment method reverted to PayPal on order save after a failed PayPal attempt and switching gateways, sending BACS on-hold emails without bank details #4687
- Fix – Declined vaulted card renewal stores the capture ID and blocks all later payment attempts #4695
- Fix – Orders paid with WooPayments or BACS saved as PayPal orders when stale PayPal order data exists #4632
- Fix – PayPal order amount ignores cart total reductions applied outside the WooCommerce discount APIs #4714
- Fix – Negative fees ignored by Google Pay and other express payments on Block Checkout #4668
- Fix – Tracking added with WooCommerce Shipment Tracking not synced to PayPal Package Tracking #4747
- Fix – reCAPTCHA rejections not logged unless plugin logging is enabled #4619
- Fix – Pay Now ignored for PayPal Subscription products bought from the product page #4630
- Fix – Store Sync no longer replaces the guest session cookie, which emptied the cart on the next page load #4734
- Fix – Stop the “Subscription could not be loaded” log entry on order screens #4629
- Fix – Show saved PayPal accounts on Block Checkout as “Use existing PayPal account” instead of the internal gateway ID #4718
- Fix – PayPal express payments on block checkout do not complete the order directly when Pay Now is enabled on SDK v6 #4790
- Fix – Express PayPal payments that need a second approval return the customer to a full cart instead of completing #4785
- Fix – Express payments with Pay Now do not empty the cart after capture, so the same cart can be paid twice #4786
- Fix – Apple Pay and Google Pay leave the buyer stuck when PayPal asks for a payer action at capture #4806
- Fix – Apple Pay express payments fail when tax is calculated from the billing address #4817
- Fix – PayPal buttons on the cart page ignore the Cart button location, and Mini Cart buttons need a page reload after adding a product #4797
- Fix – PayPal buttons shown in the block theme Mini Cart for free products, causing a frontend error #4788
- Fix – PayPal buttons and Pay Later messaging fail to load on SDK v6 for WordPress locale variants such as Deutsch (Sie) #4784
- Fix – SDK v6 card payments can be attempted with empty or invalid card fields, with a generic error instead of a clear message #4805
- Fix – reCAPTCHA blocks PayPal checkout when a theme or page builder renders a different checkout type than the saved page content #4801
- Fix – Venmo payment fails when vaulting is enabled #4793
- Fix – Google Pay on the product page fails when a negative fee is applied #4812
- Fix – Google Pay error on the product page popup when Pay Now is enabled and shipping is disabled #4814
- Fix – Google Pay on the product page does not collect the shipping address when the cart is empty #4815
- Fix – PayPal button shown on the product page for free products when shipping costs are disabled #4813
- Fix – PayPal buttons missing on the product page and classic cart for free trial subscriptions #4775
- Fix – Fastlane shows the Advanced Card Processing title on the frontend instead of its own #4776
- Fix – Failed subscription approval on the cart page tells the shopper nothing #4771
- Fix – Settings app loaded on all WooCommerce settings pages, throwing a JavaScript error #4770
- Fix – Expiry date and CVV placeholders in SDK v6 card fields not translatable #4789
- Fix – Product page preview in the block theme Site Editor #4804
4.1.3 – 2026-09-09
- Enhancement – PayPal JS SDK v6 is now the default for new store setups, moving PayPal buttons, Apple Pay, Google Pay, Advanced Card Fields, Fastlane, Pay Later messaging and vaulting subscriptions onto the new integration; existing stores remain on SDK v5 with this version #4641
- Enhancement – Add filter hooks to customize the payment method title and allow payment method icons #4586
- Enhancement – Clearer, customer-friendly decline messages for 3D Secure rejections #4573
- Enhancement – First-party WooCommerce plugin detection for product customizations #4552
- Enhancement – Allow Pay Later to remain available when vaulting is enabled #4611
- Enhancement – Improve manual-renewal-only subscription scenarios #4621
- Enhancement – Exclude connection details from Blueprint exports by default #4647
- Fix – Apple Pay shown under the PayPal gateway when a vaulting subscription is in the cart #4546
- Fix – Prevent Vault API calls made with an empty customer ID #4567
- Fix – Keep recoverable PAYER_ACTION_REQUIRED orders from failing prematurely #4569
- Fix – Retain the shopper’s checkout data when returning from PayPal on mobile #4649
- Fix – PayPal gateway missing on Block Checkout when WooCommerce Subscriptions automatic renewals are enabled #4659
- Fix – Webhook registration hitting the wrong API host right after onboarding #4669
- Fix – Give the Pay upon Invoice phone field its own ID #4666
- Fix – Stop polling the merchant-integrations endpoint on every cron run #4640
- Fix – Skip WooCommerce Inbox note registration during AJAX requests #4607
- Fix – Remove the orphaned reCAPTCHA Inbox note and align its enabled checks #4634
- Fix – Prevent Advanced Card Fields submission when Blocks checkout fields are invalid (author @marcofucito) #4435
- Fix – Show the product button on variable products with no preselected attributes #4691
- Fix – Fix negative tax_total when a discount is not reported by WooCommerce #4690
4.1.2 – 2026-08-04
- Enhancement – Advanced onboarding options for onboarding wizard #4496
- Enhancement – Improved buyer-facing card decline reason display #4509
- Enhancement – Add filter to allow Pay Later button and messaging when Vaulting is enabled #4508
- Enhancement – Handle PayPal API address data returned as an array instead of an object #4516
- Enhancement – Remove/Rework Cart Simulation #4473
- Enhancement – Remove Pay with Crypto promotional pricing messaging #4540
- Enhancement – Add filters to allow limiting of ingested/valid products #4547
- Enhancement – Validators need extraction from CheckoutEndpoint #4370
- Fix – invoice_id missing for existing customers paying with saved PayPal payment tokens #4541
- Fix – Fractional WooCommerce quantities truncated to 0, causing invalid PayPal line items and checkout failures #4530
- Fix – fraudnet.js: Uncaught ReferenceError PAYPAL is not defined on classic checkout when hosted_fields_loaded fires before fb.js loads #4520
- Fix – Saved PayPal token in subscription change-payment flow moves active subscription to pending #4536
- Fix – PHP warning in PayPal order tracking when WooCommerce Shipment Tracking sync reads non-array tracking metadata #4505
- Fix – OXXO description is missing by default #4479
- Fix – CHECKOUT.ORDER.APPROVED webhook fails with uncaught PayPalOrderMissingException causing HTTP 500 loop, pending orders and Apple Pay never captured #4534
- Fix – Block Checkout “Sign up now” button label not replaced with “Proceed to PayPal” #4440
- Fix – ppcp-local-alternative-payment-methods-css-gateway.css loads on every frontend page #4465
- Fix – ACDC edit order page shows Processor Response 0000:Approved on edit order page #4478
- Fix – Advanced Card Processing orders fail with “Order does not contain an id” error #4482
- Fix – Mexico Enable Installments not visible on Overview tab in Features section #4461
- Fix – Pay Later messaging tab merchant_identifier error showing until page reload when connecting manually #4459
- Fix – Duplicated WooCommerce orders #4387
- Fix – Google Pay / Apple Pay (Safari) button visible on PayPal gateway when Classic checkout removed from smart button location #4491
- Fix – Manual renewal subscription from frontend block express checkout renders empty Apple Pay and Google Pay div #4497
- Fix – Store Sync toggle missing when feature flag is active #4535
- Fix – Inconsistent PayPal button behavior for subscriptions on cart #4542
- Fix – Scope reCAPTCHA assets and markup to active PayPal payment locations #4548
4.1.1 – 2026-07-07
- Fix – Fix Pay upon Invoice gateway enqueued outside of checkout context with Block Mini Cart #4483
- Fix – Too many requests to merchant-integrations API endpoint #4490
4.1.0 – 2026-06-23
- Enhancement – New Vault Management Component for buyers with saved PayPal accounts to update funding instrument #4421
- Enhancement – Pay upon Invoice support for Block Checkout #4405
- Enhancement – OXXO support for Block Checkout #4381
- Enhancement – Show PayPal account or last card digits in payment method on order confirmation page & emails #4427
- Enhancement – Disable legacy “PayPal Standard” gateway when merchant account is connected to PayPal Payments #4463
- Fix – Third-party plugin gift cards not calculated on PayPal payment modal #4422
- Fix – Fix PayPal amount mismatch from inclusive-tax rounding #4425
- Fix – Negative fee calculation may result in a mismatch PayPal between the WooCommerce order total and the total amount paid via PayPal #4409
- Fix – Unsuccessful payment for vaulting subscription with ACDC from Block Checkout #4437
- Fix – Unsuccessful payment for vaulting subscriptions with 100% discount coupons (CANNOT_BE_ZERO_OR_NEGATIVE) #4452
- Fix – Unsuccessful payment for free trial vaulting subscription with acdc and PayPal #4439
- Fix – Vaulted ACDC saved-card checkout stuck in “payment pending” #4431
- Fix – PartnersEndpoint::seller_status() floods PayPal merchant-integrations endpoint with 403s #4430
- Fix – Avoid spamming OAuth requests when auth fails #4414
- Fix – Google Pay not rendered on variable product page #4433
- Fix – Simplify manual client ID validation to accommodate new Client ID format #4397
- Fix – Mismatch line item not delivered to PayPal overview transaction page #4426
- Fix – APM transaction links open paypal.com instead of sandbox.paypal.com in Sandbox mode #4418
- Fix – Coerce stored values in typed-bool getters and vault_enabled migration #4393
- Fix – Fix type casting for customer unique ID in session MD5 hash #4333
- Fix – Apple Pay fails on single product page when no shipping option is available #4375
- Fix – Settings notifications do not display on the PayPal Payments settings pages #4034
- Fix – Add missing “Show logos of supported cards” setting in the ACDC options #4380
- Fix – Phone number verification may fail #4448
- Fix – Saved payment methods display in continuation mode #4457
- Fix – Card payments with saved cards may fail in certain cases #4450
4.0.4 – 2026-05-19
- Enhancement – WooCommerce Blueprints integration to import & export the PayPal Payments configuration #4363
- Enhancement – PayPal redirect gateway now appears on Block checkout for Subscription-type products #4338
- Enhancement – updated render hooks for Apple Pay & Google Pay buttons on Classic Checkout to be consistent with PayPal #4350
- Enhancement – Improved error message for reCAPTCHA v2 challenge failures #4342
- Enhancement – Added ACDC card decline responses to WooCommerce order notes & checkout #4314
- Fix – Intermittent “Please choose product options…” error when adding variable product to the cart #4315
- Fix – Placeholder for Pay Later messaging in Block checkout editor when messaging failed to load #4302
- Fix – Error “Debit & Credit Cards is not available for this order” on Block checkout when buying PayPal Subscription #4351
- Fix – Unsuccessful payment for PayPal Subscriptions from Block cart & checkout #4343
- Fix – Branded-only mode persisted after uninstalling the plugin #4337
- Fix – Wrong payment method displayed on order edit page in some cases #4349
- Fix – Incorrect asset path for PayPalInsightsLoader.js caused console error #4293
- Fix – Auto-capture on status change did not work for non-express payments #4352
- Fix – Things to do next showed “Register Domain for Apple Pay” action item in branded-only mode #4296
4.0.3 – 2026-04-27
- Enhancement – consolidate disabled funding sources card decision #4216
- Enhancement – Hide Apple Pay Register Domain TODO when domain is already validated #4263
- Enhancement – Remove vault v2 code #4254
- Fix – Cart simulation causes checkout instability and cannot be disabled #4277
- Fix – Fix bool (false) in transients #4281
- Fix – Return HTTP 400 on nonce validation failures instead of 500 #4280
- Fix – AddressFactory::from_wc_order billing address #4279
- Fix – Duplicate WooCommerce orders created when buyer switches payment method at checkout #4276
- Fix – BCDC – Mexico – BCDC not visible on block checkout #4289
- Fix – Guest Cart appears empty when product is added from product page #4288
- Fix – APMS – Order with apms stay in pending status (iDeal, …) #4294
- Fix – Failing ACDC payment for Free Trial subscription on classic checkout #4299
- Fix – Drop shipping when city is missing to prevent CITY_REQUIRED #4292
4.0.2 – 2026-04-02
- Fix – API rate limiting #4244
4.0.1 – 2026-03-31
- Enhancement – Removed legacy UI #4031
- Enhancement – Added migration banner guiding BCDC merchants through upgrade to Advanced Card Processing #4192
- Enhancement – Apple Pay and Google Pay can now be enabled independently, without requiring Advanced Card Processing (ACDC) to be active #4186
- Enhancement – Fastlane is now available in all ACDC-supported countries #4149
- Enhancement – Added Fastlane to reCAPTCHA-protected payment methods for improved fraud protection #4161
- Enhancement – Pay with Crypto is now enabled by default for eligible merchants #4171
- Enhancement – Added Pay Upon Invoice support to the new settings UI #4117, #4144
- Enhancement – Vaulting via Orders API now supported for redirect gateway in Block Checkout #4131
- Enhancement – Billing agreements can now be imported and converted to Vault tokens #4134
- Fix – PUI and OXXO settings were not preserved after upgrading from 2.9.6 to 4.0.0 #4194
- Fix – Merchant onboarding state was lost when upgrading from a previous version #4150
- Fix – BCDC was not enabled after migration for merchants who had it active but were not ACDC-eligible #4160
- Fix – BCDC button was not active after migration when BCDC was part of the PayPal gateway #4155, #4180
- Fix – Pay Later messaging tab was missing after migration when BCDC was part of the PayPal gateway #4159
- Fix – Capture virtual orders on status change setting was not preserved during migration #4157
- Fix – Cardholder name was always shown on the frontend after legacy migration #4167
- Fix – L2/L3 data was incorrectly sent when Stay Updated was disabled during migration #4168
- Fix – APM settings were not correctly migrated when APMs were part of the PayPal gateway #4182
- Fix – BCDC override flag was not functioning correctly #4177
- Fix – Capture on status change was not working as expected in the new UI #4169
- Fix – ACDC setting was not preserved after saving and reloading the settings page #4108
- Fix – ACDC was not enabled by default after onboarding for eligible countries #4128
- Fix – Standard card button gateway was incorrectly visible on the WooCommerce Payments tab and classic checkout #4118
- Fix – Google Pay and Apple Pay were visible on classic checkout for non-eligible countries #4137
- Fix – Save payment method checkbox was incorrectly shown for ACDC in unsupported countries #4176
- Fix – Pay with Crypto gateway was visible on checkout for ineligible merchants #4175
- Fix – Pay with Crypto cancel and return URL query parameters were not parsed correctly #4183
- Fix – Various Pay with Crypto fixes including icon update and miscellaneous issues #4187, #4172
- Fix – Fastlane watermark was not hidden when the “Display Fastlane Watermark” setting was disabled #4140
- Fix – Fastlane “Learn More” link was missing for GB and AU locales #4112
- Fix – PayPal buttons were not visible on the block cart page #4125
- Fix – Incorrect button style was shown on the Pay for Order page #4184, #4141
- Fix – Failed orders could not be paid via PayPal #4154
- Fix – Deposits remainder payments were not completed for pending-deposit orders #4100
- Fix – Infinite loop when changing payment method for a subscription #4085
- Fix – Fatal error on plugin upgrade due to ArgumentCountError in AuthenticationRestEndpoint #4090
- Fix – Fatal error on simulate cart calls #3769
- Fix – AVS code mismatch causing payment failures #4132
- Fix – BCDC-only merchants incorrectly had ACDC, Apple Pay, and Google Pay disabled #4088
- Fix – Removed Order Status requirement for PayPal payment processing #4185
- Fix – Refactored GermanizedShipmentIntegration to support Shiptastic #4061, #4193
- Fix – Do not increment step directly #4086
3.4.1 – 2026-03-05
- Fix – Performance issue in /v2/vault/payment-tokens/id #4098
- Fix – China Merchants ACDC and Vaulting Missing #4139
3.4.0 – 2026-02-10
- New – Level 2 and Level 3 card processing support for Advanced Credit and Debit Cards #3970, #3999
- Enhancement – PayPal Working Capital promotional messaging now available for eligible merchants #4048
- Enhancement – Improved reCAPTCHA logging to help troubleshoot blocked requests #3835
- Enhancement – Added direct link to plugin logs in settings for easier debugging #3743
- Enhancement – Restored woocommerce_gateway_description filter for gateway customization #3742
- Enhancement – Updated Pay Later messaging descriptions and settings #4012
- Enhancement – Improved onboarding step 4 title for ACDC regions #3998
- Enhancement – Add pattern validation and improve error messages for client credentials #4073
- Enhancement – Improve authentication error handling #4073
- Enhancement – Ensure webhook verification on production #4074
- Fix – Google Pay now correctly updates WooCommerce shipping address #3798
- Fix – Google Pay no longer shows shipping selection for virtual products #3797
- Fix – Google Pay shipping method now visible on product pages with empty cart #4030
- Fix – Google Pay edge-case that prevented it from working on all pages when Pay Now is disabled #3860
- Fix – Google Pay and Apple Pay buttons no longer disappear when changing the address in block checkout #3851
- Fix – Apple Pay now shows applied coupons correctly in payment popup #3838
- Fix – PayPal button in Mini Cart now works correctly on product pages #3745
- Fix – Fastlane email lookup now works when email is pre-populated from session #3637
- Fix – Fastlane no longer shown in settings for ineligible merchants #3872
- Fix – Duplicate PayPal captures and double stock reductions should no longer occur #3885
- Fix – Missing PayPal order ID meta data now saved for vaulted card transactions #4035
- Fix – “Instant payments only” toggle now uses correct setting value #3767
- Fix – Settings Overview tab now loads correctly for BCDC-only countries #3775
- Fix – Alternative Payment Methods now show correctly based on merchant eligibility #3864
- Fix – Payment method descriptions now display in block checkout for all gateways #3891
- Fix – Payment gateway icon sizing in Classic Checkout #3894
- Fix – “Disable Specific Credit Cards” option now hidden for BCDC countries #3653
- Fix – PHP warning when adding variable products via PayPal button #3849
- Fix – PHP 8.4 implicit nullable parameter deprecation warning #3996 (author @mondalaci)
- Fix – Translation loading timing issue with currency checks #3978 (author @mondalaci)
- Fix – Potential error when cart is accessed before initialization #3973
- Fix – Improved error handling for token validation failures #3986
3.3.2 – 2026-01-12
- بهبود – پیکربندی بهبودیافته reCAPTCHA برای کمک به حفاظت از فروشگاه شما و حفظ انطباق #3980, #3984
- رفع اشکال – پردازش کارت پیشرفته ممکن است پس از بهروزرسانی افزونه بهطور موقت غیرقابل دسترس شود #3983
3.3.1 – 2025-12-09
- بهبود – بهبودهای تجربه کاربری ادغام reCAPTCHA #3907
- بهبود – غیرفعالسازی نقطه پایانی رویداد شبیهسازی برای تأیید وبهوک #3908
3.3.0 – 2025-11-04
- بهبود – پیامرسانی و دکمه پرداخت در آینده بهطور خودکار برای پذیرندگان واجد شرایط کانادایی در ۱۲ نوامبر فعال شد، بر اساس ترجیح بهروز بمانید. #3819
- بهبود – پیادهسازی قابل شخصیسازی reCAPTCHA برای نقاط پایانی پیپل #3829
- رفع اشکال – خطای مهلک در ویرایشگر فرانتاند ویژوال کامپوزر به دلیل نوع دقیق $hook_suffix #3815
- رفع اشکال – زبانه تنظیمات پیامرسانی پرداخت در آینده در برخی موارد هنگام بهروزرسانی به نسخه قبلی افزونه قابل مشاهده نیست #3812
3.2.1 – 2025-10-20
- بهبود – ایمنتر کردن هوکهای ارتقای افزونه #3789
- بهبود – قفل گذرا وبهوک #3790
3.2.0 – 2025-10-15
- بهبود – فعالسازی پرچمهای ویژگی AppSwitch و SSSC بهصورت پیشفرض #3724
- بهبود – حذف منطق فعالسازی خودکار موقت پیامرسانی پرداخت در آینده #3680
- بهبود – هماهنگسازی پشتیبانی ارز فستلین با ماتریس ACDC #3697
- بهبود – افزودن هوکها در شروع درخواستهای ایجاد/تأیید سفارش #3717
- بهبود – عدم فیلتر کردن توکنها هنگام تغییر روش پرداخت یک اشتراک (نویسنده @gedex) #3617
- بهبود – سازماندهی مجدد مودالهای تنظیمات درگاه ACDC و فستلین #3652
- بهبود – بهروزرسانی لیست حملکنندگان رهگیری بسته پیپل #3630
- بهبود – نمایش بخش مرکز راهنمایی #3587
- بهبود – بهروزرسانی طراحی جایگزین کارت فستلین #3625
- بهبود – افزودن بازگردانی نشست فستلین پس از شکست پرداخت #3598
- رفع اشکال – بررسی تنظیمات قابلیت مشاهده پیامها قبل از رندر کردن #3686
- رفع اشکال – خطای مهلک در جایی که یک بازخوانی انتظار WC_Payment_Gateway\ را دارد اما RequestHandler دریافت کرده است (نویسنده @gedex) #3660
- رفع اشکال – ادامه با اشتراکهای پیپل #3656
- رفع اشکال – افزودن جایگزین برای دریافت آدرس سفارش اشتراک در زمینههای کلاسیک #3657
- رفع اشکال – فستلین – بریتانیا و استرالیا – افزودن فستلین به صفحه آمادهسازی و چهار مرحله #3635
- رفع اشکال – بررسی موجودی متغیر برای تمام محصولات متغیر #3605
- رفع اشکال – وضعیت فعال دکمه گوگل پی در صفحات محصول متغیر #3602
- رفع اشکال – خطا در پرداخت با لینک پیپل در فرانتاند زمانی که آدرس حملونقل وجود ندارد #3627
- رفع اشکال – همگامسازی فیلدها و سرآیندهای پرداخت نهایی در جریان فستلین #3628
- رفع اشکال – پرداخت نهایی کلاسیک – کاربر مهمان – اعتبارسنجی اشتراک ذخیره امن آزمایشی کار نمیکند #3663
- رفع اشکال – جلوگیری از تغییر مسیر در شکست پرداخت نهایی برای اشتراکهای ذخیره امن آزمایشی #3644
- رفع اشکال – شرایط رقابت مخاطبین در بلوک #3518
- رفع اشکال – افزودن فیلترهای مرتبط با حملونقل برای جلوگیری از خطاهای MISSING_%field_name% #3586
- رفع اشکال – حالت ادامه در پرداخت نهایی المنتور #3612
3.1.2 – 2025-09-30
- تغییر – در دسترس قرار دادن مجدد مهاجرت #3710
- رفع اشکال – لغو پرچم برای حفظ BCDC برای پذیرندگان ACDC در حین مهاجرت #3712
- رفع اشکال – جلوگیری از خطای مهلک نادر زمانی که آدرس حملونقل وجود ندارد #3655
- در حالت فقط برندینگ، هر پذیرنده BCDC دارد #3713
3.1.1 – 2025-09-27
- رفع اشکال – رفع اشکال BCDC در حالت فقط برندینگ #3699
- رفع اشکال – بازگردانی دکمه BCDC برای پذیرندگان ACDC در رابط کاربری میراث #3703
- تغییر – حذف تمام تجربه کاربری/اعلانهای مهاجرت #3705
3.1.0 – 2025-09-02
- بهبود – فستلین اکنون برای پذیرندگان بریتانیایی و استرالیایی در دسترس است #3589
- بهبود – پیامرسانی پرداخت در آینده اکنون بهطور خودکار برای پذیرندگان واجد شرایط بر اساس ترجیح بهروز بمانید فعال شده است. تنظیمات پرداخت در آینده را برای شخصیسازی یا غیرفعالسازی بررسی کنید. #3600
- بهبود – افزودن دکمهها برای کپی کردن اعتبارنامههای پذیرنده در زبانه تنظیمات #3561
- بهبود – رد شدن از مرحله «روشهای پرداخت» برای فقط برندینگ + BCDC و فروشندگان عادی #3547
- بهبود – افزودن آیتم «کارهای بعدی برای انجام» پس از مهاجرت تنظیمات #3536
- بهبود – فاز ۲: مهاجرت تنظیمات – افزودن آیتم صندوق ورودی وو #3599
- بهبود – ایجاد یک تابع API برای افزودن اطلاعات رهگیری #3588
- بهبود – افزودن مکانیسم نظرسنجی برای پوششدهنده رندر جهت جلوگیری از شرایط رقابت برای پیامرسانی پرداخت در آینده #3577
- بهبود – ورودی گزارش وضعیت برای «رابط کاربری جدید فعال» و «فقط برندینگ» #3539
- رفع اشکال – اپل پی روش حملونقل یا تغییرات آدرس را در پرداخت نهایی کلاسیک بهروزرسانی نمیکند #3524
- رفع اشکال – جلوگیری از بررسی زودهنگام ()is_enabled برای دکمه گوگل پی در رابط کاربری جدید #3566
- رفع اشکال – اشتراکهای مهاجرتکرده از افزونه PPEC به پرداختهای پیپل در تمدید شکست میخورند #3549
- رفع اشکال – تراکنش گوگل پی از صفحات بلوک #3542
- رفع اشکال – حذف فراخوانی احراز اجازه اضافی در کنترلکننده تمدید اشتراک #3543
- رفع اشکال – مدیریت توضیحات خالی و نمایش لوگو برای درگاه پیپل آنطور که انتظار میرود کار نمیکند #3527
- رفع اشکال – وقتی اپل پی فعال است، فضای خالی برای دکمه اپل پی در تمام صفحات نمایش داده میشود اگر خریدار واجد شرایط نباشد #3550
- رفع اشکال – خطای ویژگیهای تعریفنشده در بلوک پرداخت نهایی #3551
- رفع اشکال – اختیاری کردن دادههای آدرس استان برای رفع ناسازگاری غیر US-CA برای فستلین #3535
- رفع اشکال – غیرفعالسازی دکمه کارت اگر BCDC غیرفعال است #3532
- رفع اشکال – حذف فیلد data-sdk-client-token زمانی که مورد نیاز نیست #3540
- رفع اشکال – ثبت «No PayPal order ID found in order meta» پس از استفاده از «ادامه به پیپل» در پرداخت نهایی بلوک #3189
- رفع اشکال – استفاده از ()is_acdc_enabled برای جلوگیری از تداخل ACDC با BCDC در کشورهای غیر ACDC #3594
- رفع اشکال – حذف درگاه مشخصشده زمانی که دکمه غیرفعال است #3556
3.0.9 – 2025-07-31
- رفع اشکال – پرداخت از طریق «ادامه به پیپل» ممکن است منجر به یک حلقه تغییر مسیر شود #3570
3.0.8 – 2025-07-28
- بهبود – مهاجرت از تنظیمات میراث به تنظیمات جدید بهصورت اختیاری از طریق بنر و دکمه #3491
- بهبود – جایگزینی فراخوانی به
billing-agreements/agreement-tokensبا بررسی قابلیتها برای تراکنشهای مرجع #3495 - بهبود – افزودن پشتیبانی امنیت ۳ بعدی فستلین #3493
- بهبود – بهبود سازگاری با PHP 8.4 #3534
- رفع اشکال – خطای
INVALID_REQUESTبه دلیل مقدار اشتباهlanding_pageپس از ارتقا به ۳.۰.۷ #3521 - رفع اشکال – مبلغ نادرست از طریق پرداخت سریع برای بستههای محصول ووکامرس #3516
- رفع اشکال – آمادهسازی از طریق «اتصال به پیپل» در رابط کاربری جدید به دلیل شرایط رقابت ناموفق بود #3385
- رفع اشکال – خطای مهلک زمانی که پرداختهای پیپل بدون ووکامرس فعال است #3502
- رفع اشکال – تراکنش اشتراک پیپل در سناریوهای مختلف ناموفق بود #3515
- رفع اشکال – تفاوتهای گرد کردن احتمالاً منجر به شکست سفارش میشود (نویسنده @luzat) #3373
- رفع اشکال – پرداخت گوگل پی در پرداخت نهایی بلوک ممکن است با شکست مواجه شود زمانی که ACDC انتخاب پرداخت پیشفرض است #3506
- رفع اشکال – ناپدید شدن قیمت محصولات در برخی موارد زمانی که اشتراکهای ووکامرس فعال است #3519
3.0.7 – 2025-07-01
- Enhancement – Remove
application_contextin favor ofexperience_contextobject #3431
NOTE: If you were modifying theapplication_contextobject programmatically, you may need to update your code to utilizeexperience_contextfor your …
