Add SellerStatus filtering layer with extension point for custom overrides (6276)

[danieldudzic]

Description

Adds two WordPress filter hooks to PartnersEndpoint::seller_status() so external plugins can override or replace the PayPal merchant-integrations API response.

What this PR adds:

• woocommerce_paypal_payments_seller_status — filters the SellerStatus object on every return (cache hit or API response)
• woocommerce_paypal_payments_seller_status_fallback — provides a fallback SellerStatus when the API fails, instead of throwing
• Extracted fetch_seller_status_from_api() private method for clarity
• Documentation at docs/seller-status-filter.md

[github-actions]

Test using WordPress Playground

The changes in this pull request can be previewed and tested using a WordPress Playground instance.
WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser.

🔗 Test this pull request with WordPress Playground

What's included:

• ✅ WordPress (latest)
• ✅ WooCommerce (latest)
• ✅ PayPal Payments plugin v4.0.2-pr4307-25046048997-gb389362 (built from this PR)

Login credentials:

• Username: admin
• Password: password

Plugin Details:

• Version: 4.0.2-pr4307-25046048997-gb389362
• Commit: e75f974
• Artifact: woocommerce-paypal-payments-4.0.2-pr4307-25046048997-gb389362

💡 The demo environment resets each time you refresh. Perfect for testing!

🔄 This link updates automatically with each new commit to the PR.

⚠️ This URL is valid for 30 days from when this comment was last updated.

---

_{🤖 Auto-generated for commit e75f974 • Last updated: 2026-04-28T09:54:00.923Z}