fluentcart-developer 2.3.3 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cards/fluentcart/tools.d.ts.map +1 -1
- package/dist/cards/fluentcart/tools.js +2368 -2323
- package/dist/cards/fluentcart/tools.js.map +1 -1
- package/dist/paths.d.ts +1 -1
- package/dist/paths.d.ts.map +1 -1
- package/dist/paths.js +1 -1
- package/dist/paths.js.map +1 -1
- package/dist/reference-reader.d.ts +32 -1
- package/dist/reference-reader.d.ts.map +1 -1
- package/dist/reference-reader.js +111 -22
- package/dist/reference-reader.js.map +1 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +8 -1
- package/dist/server.js.map +1 -1
- package/dist/skills/fluentcart-developer/SKILL.md +66 -538
- package/dist/skills/fluentcart-developer/references/api/authentication.md +452 -0
- package/dist/skills/fluentcart-developer/references/api/coupons.md +786 -0
- package/dist/skills/fluentcart-developer/references/api/customers.md +889 -0
- package/dist/skills/fluentcart-developer/references/api/files.md +609 -0
- package/dist/skills/fluentcart-developer/references/api/index.md +432 -0
- package/dist/skills/fluentcart-developer/references/api/licensing.md +633 -0
- package/dist/skills/fluentcart-developer/references/api/order-bump.md +384 -0
- package/dist/skills/fluentcart-developer/references/api/orders.md +814 -0
- package/dist/skills/fluentcart-developer/references/api/products.md +866 -0
- package/dist/skills/fluentcart-developer/references/api/roles-permissions.md +536 -0
- package/dist/skills/fluentcart-developer/references/api/subscriptions.md +827 -0
- package/dist/skills/fluentcart-developer/references/database/index.md +44 -0
- package/dist/skills/fluentcart-developer/references/database/models/activity.md +178 -0
- package/dist/skills/fluentcart-developer/references/database/models/applied-coupon.md +291 -0
- package/dist/skills/fluentcart-developer/references/database/models/attribute-group.md +239 -0
- package/dist/skills/fluentcart-developer/references/database/models/attribute-relation.md +181 -0
- package/dist/skills/fluentcart-developer/references/database/models/attribute-term.md +219 -0
- package/dist/skills/fluentcart-developer/references/database/models/cart.md +645 -0
- package/dist/skills/fluentcart-developer/references/database/models/coupon.md +427 -0
- package/dist/skills/fluentcart-developer/references/database/models/customer-addresses.md +348 -0
- package/dist/skills/fluentcart-developer/references/database/models/customer-meta.md +156 -0
- package/dist/skills/fluentcart-developer/references/database/models/customer.md +584 -0
- package/dist/skills/fluentcart-developer/references/database/models/dynamic-model.md +163 -0
- package/dist/skills/fluentcart-developer/references/database/models/label-relationship.md +155 -0
- package/dist/skills/fluentcart-developer/references/database/models/label.md +153 -0
- package/dist/skills/fluentcart-developer/references/database/models/license-activation.md +182 -0
- package/dist/skills/fluentcart-developer/references/database/models/license-meta.md +163 -0
- package/dist/skills/fluentcart-developer/references/database/models/license-site.md +208 -0
- package/dist/skills/fluentcart-developer/references/database/models/license.md +640 -0
- package/dist/skills/fluentcart-developer/references/database/models/meta.md +233 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-address.md +391 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-download-permission.md +144 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-item.md +383 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-meta.md +303 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-operation.md +158 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-promotion-stat.md +175 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-promotion.md +250 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-tax-rate.md +172 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-transaction.md +440 -0
- package/dist/skills/fluentcart-developer/references/database/models/order.md +727 -0
- package/dist/skills/fluentcart-developer/references/database/models/product-detail.md +397 -0
- package/dist/skills/fluentcart-developer/references/database/models/product-download.md +258 -0
- package/dist/skills/fluentcart-developer/references/database/models/product-meta.md +153 -0
- package/dist/skills/fluentcart-developer/references/database/models/product-variation.md +556 -0
- package/dist/skills/fluentcart-developer/references/database/models/product.md +580 -0
- package/dist/skills/fluentcart-developer/references/database/models/relationships.md +427 -0
- package/dist/skills/fluentcart-developer/references/database/models/scheduled-action.md +175 -0
- package/dist/skills/fluentcart-developer/references/database/models/shipping-class.md +148 -0
- package/dist/skills/fluentcart-developer/references/database/models/shipping-method.md +280 -0
- package/dist/skills/fluentcart-developer/references/database/models/shipping-zone.md +205 -0
- package/dist/skills/fluentcart-developer/references/database/models/subscription-meta.md +173 -0
- package/dist/skills/fluentcart-developer/references/database/models/subscription.md +528 -0
- package/dist/skills/fluentcart-developer/references/database/models/tax-class.md +195 -0
- package/dist/skills/fluentcart-developer/references/database/models/tax-rate.md +225 -0
- package/dist/skills/fluentcart-developer/references/database/models/user-meta.md +166 -0
- package/dist/skills/fluentcart-developer/references/database/models/user.md +220 -0
- package/dist/skills/fluentcart-developer/references/database/models.md +404 -0
- package/dist/skills/fluentcart-developer/references/database/query-builder.md +860 -0
- package/dist/skills/fluentcart-developer/references/database/readme.md +276 -0
- package/dist/skills/fluentcart-developer/references/database/schema.md +1002 -0
- package/dist/skills/fluentcart-developer/references/engineering/adding-custom-pages-to-the-customer-dashboard.md +395 -0
- package/dist/skills/fluentcart-developer/references/engineering/index.md +4 -0
- package/dist/skills/fluentcart-developer/references/engineering.md +4 -0
- package/dist/skills/fluentcart-developer/references/getting-started.md +249 -0
- package/dist/skills/fluentcart-developer/references/guides/frontend.md +519 -0
- package/dist/skills/fluentcart-developer/references/guides/index.md +107 -0
- package/dist/skills/fluentcart-developer/references/guides/integrations.md +600 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/index.md +237 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/labels-and-tracking.md +481 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/live-rates.md +269 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/reference.md +223 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/settings.md +370 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier.md +237 -0
- package/dist/skills/fluentcart-developer/references/{subscription-customization.md → guides/subscriptions.md} +57 -37
- package/dist/skills/fluentcart-developer/references/hooks/actions/admin-and-templates.md +1079 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/cart-and-checkout.md +1795 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/customers-and-users.md +327 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/licenses.md +829 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/modules.md +81 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/orders.md +757 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/payments-and-integrations.md +1163 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/pro-modules.md +219 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/products-and-coupons.md +1019 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/subscriptions.md +1290 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions.md +16 -0
- package/dist/skills/fluentcart-developer/references/hooks/deprecated.md +60 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/cart-and-checkout.md +2032 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/customers-and-subscriptions.md +1746 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/integrations-and-advanced.md +2439 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/modules.md +464 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/orders-and-payments.md +2658 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/pro-modules.md +502 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/products-and-pricing.md +1785 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/settings-and-configuration.md +2966 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters.md +14 -0
- package/dist/skills/fluentcart-developer/references/hooks/index.md +35 -0
- package/dist/skills/fluentcart-developer/references/index.md +625 -0
- package/dist/skills/fluentcart-developer/references/{fee-system-guide.md → modules/fee-system.md} +38 -60
- package/dist/skills/fluentcart-developer/references/{ghost-product-selling.md → modules/ghost-product-selling.md} +71 -89
- package/dist/skills/fluentcart-developer/references/modules/index.md +484 -0
- package/dist/skills/fluentcart-developer/references/modules/licensing.md +342 -0
- package/dist/skills/fluentcart-developer/references/modules/order-bump.md +433 -0
- package/dist/skills/fluentcart-developer/references/modules/payment-methods.md +129 -0
- package/dist/skills/fluentcart-developer/references/modules/refunds.md +170 -0
- package/dist/skills/fluentcart-developer/references/modules/shipping.md +846 -0
- package/dist/skills/fluentcart-developer/references/modules/storage.md +986 -0
- package/dist/skills/fluentcart-developer/references/modules/subscription-vendor-ids.md +186 -0
- package/dist/skills/fluentcart-developer/references/modules/subscriptions.md +678 -0
- package/dist/skills/fluentcart-developer/references/payment-methods-integration/index.md +164 -0
- package/dist/skills/fluentcart-developer/references/payment-methods-integration/paddle-example.md +1648 -0
- package/dist/skills/fluentcart-developer/references/payment-methods-integration/payment/setting/fields.md +353 -0
- package/dist/skills/fluentcart-developer/references/payment-methods-integration/quick-implementation.md +1079 -0
- package/dist/skills/fluentcart-developer/references/payment-methods-integration.md +164 -0
- package/dist/skills/fluentcart-developer/references/restapi/checkout.md +573 -0
- package/dist/skills/fluentcart-developer/references/restapi/coupons.md +958 -0
- package/dist/skills/fluentcart-developer/references/restapi/customer-profile.md +1423 -0
- package/dist/skills/fluentcart-developer/references/{rest-api-customers.md → restapi/customers.md} +406 -424
- package/dist/skills/fluentcart-developer/references/restapi/dashboard.md +1083 -0
- package/dist/skills/fluentcart-developer/references/restapi/data-export.md +132 -0
- package/dist/skills/fluentcart-developer/references/restapi/email-notifications.md +846 -0
- package/dist/skills/fluentcart-developer/references/restapi/files.md +313 -0
- package/dist/skills/fluentcart-developer/references/restapi/index.md +127 -0
- package/dist/skills/fluentcart-developer/references/restapi/integrations.md +1000 -0
- package/dist/skills/fluentcart-developer/references/restapi/inventory.md +192 -0
- package/dist/skills/fluentcart-developer/references/restapi/labels-and-attributes.md +797 -0
- package/dist/skills/fluentcart-developer/references/restapi/licensing.md +1733 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-available-shipping-methods.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-checkout-summary.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-country-info.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-order-info.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-shipping-methods-list-view.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/login.md +66 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/place-order.md +179 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/apply-coupon.md +83 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/cancel-coupon.md +87 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/check-product-eligibility.md +59 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/create-coupon.md +230 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/delete-coupon.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon-settings.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupon-codes.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupons.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/re-apply-coupons.md +75 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/store-coupon-settings.md +40 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/update-coupon.md +133 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-address-checkout.md +138 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-profile-address.md +119 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/dashboard-overview.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/delete-profile-address.md +46 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-order-details.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-portal-sections.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-profile-details.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-transaction-billing-address.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-upgrade-paths.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-downloads.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-orders.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/make-profile-address-primary.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/pause-subscription.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/resume-subscription.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/save-transaction-billing-address.md +92 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/select-address-for-checkout.md +32 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-address.md +115 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-details.md +69 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/attach-user.md +50 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/bulk-actions.md +65 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-address.md +135 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-customer.md +108 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/delete-address.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/detach-user.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/find-customer-order.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-attachable-users.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-addresses.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-orders.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-stats.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer.md +32 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/list-customers.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/recalculate-ltv.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/set-primary-address.md +72 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-additional-info.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-address.md +144 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-customer.md +123 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/attach-note-to-order.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-all-pages.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-single-page.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/delete-activity.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-country-info.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-dashboard-stats.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-filter-options.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-data.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-settings.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-print-templates.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-search-options.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-widgets.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/initialize-app.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-activities.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-attachments.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-countries.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/mark-activity-read.md +53 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/run-data-backfills.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-settings.md +54 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-tax-settings.md +73 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-print-templates.md +64 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/upload-attachment.md +42 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-customers-batch.md +129 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-licenses-batch.md +133 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-orders-batch.md +129 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-subscriptions-batch.md +129 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-customers-export-schema.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-licenses-export-schema.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-orders-export-schema.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-subscriptions-export-schema.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/enable-notification.md +57 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-digest-settings.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-notification.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-reminders.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-settings.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-shortcodes.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/list-notifications.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-default-template.md +66 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-notification.md +50 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-digest-settings.md +101 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-reminders.md +162 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-settings.md +99 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-digest-test.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-manual-reminder.md +51 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/update-notification.md +93 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/files/delete-file.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/files/get-bucket-list.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/files/list-files.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-editor-file.md +32 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-file.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/chained-data-request.md +46 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/change-feed-status.md +51 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/delete-feed.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-dynamic-options.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-lists.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-settings.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-feeds.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-settings.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/install-addon-plugin.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/list-addons.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/save-feed-settings.md +52 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/set-global-settings.md +50 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/bulk-update-stock.md +94 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/export-inventory.md +81 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-adjustment-history.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-inventory-stats.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/list-inventory.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/update-stock.md +75 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-attribute-group.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-label.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-terms.md +90 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-group.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-term.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-group.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-library.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-groups.md +32 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-terms.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-labels.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-groups.md +51 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-terms.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-group.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-term.md +39 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-label-selections.md +32 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-plugin-license.md +41 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-site-admin.md +60 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-plugin-license.md +18 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-admin.md +67 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-customer.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/delete-license.md +24 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/extend-license-validity.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-license-details.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-licenses-admin.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-activations.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-details.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-site.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-plugin-license-status.md +18 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-product-license-settings.md +24 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-customer-licenses.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-license-sites.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-licenses.md +38 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-activate-license.md +54 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-check-license.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-deactivate-license.md +46 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-download-license-package.md +23 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-get-license-version.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/regenerate-license-key.md +24 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/save-product-license-settings.md +193 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-activation-limit.md +53 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-status.md +52 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/create-order-bump.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/delete-order-bump.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/get-order-bump.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/list-order-bumps.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/update-order-bump.md +141 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/accept-dispute.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/bulk-actions.md +72 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-shipping.md +67 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-tax.md +98 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/change-customer.md +50 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/charge-now.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-and-change-customer.md +92 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-custom-order-item.md +68 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-order.md +351 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-renewal-now.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/delete-order.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/generate-missing-licenses.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order-transactions.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-renewal.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-shipping-methods.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-single-transaction.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-order-currencies.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-orders.md +42 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-renewals.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/mark-as-paid.md +61 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/price-order.md +135 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/refund-order.md +72 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/resend-renewal-invoice.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/skip-renewal.md +48 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-order-statuses.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-pending-transaction.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address-id.md +60 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address.md +98 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order.md +172 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-statuses.md +77 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-subscription-details.md +84 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-transaction-status.md +51 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/void-renewal.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/create-pdf-template.md +42 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/delete-pdf-template.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/download-pdf-preview.md +44 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-factory-default-templates.md +19 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-status.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-template.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-saved-templates.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-seller-details.md +19 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/list-pdf-templates.md +19 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-pdf-template.md +53 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-seller-details.md +97 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/add-product-terms.md +64 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-edit-fetch.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-insert-products.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-products.md +59 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-variants.md +83 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/change-integration-status.md +64 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-dummy-products.md +45 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-product.md +81 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-variation.md +181 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-downloadable-file.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product-integration.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-taxonomy-term.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-upgrade-path.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-variation.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/do-bulk-action.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/duplicate-product.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-products-by-ids.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-taxonomy-terms.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-terms-by-parent.md +60 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-variations-by-ids.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/find-subscription-variants.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-bundle-info.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-downloadable-url.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-max-excerpt-word-count.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-pricing-widgets.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-feeds.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-settings.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-pricing.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-related-products.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-upgrade-settings.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-variation-upgrade-paths.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/group-bulk-update-variants.md +103 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-all-variants.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-product-variations.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-products.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-shipping-class.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-tax-class.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-bundle-info.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-product-integration.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-upgrade-path.md +78 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-product-variant-options.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-products-by-name.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-variants-by-name.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/set-variation-media.md +74 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/suggest-sku.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-downloadable-files.md +134 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-taxonomy-terms.md +61 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/toggle-product-tax-exemption.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-downloadable-file.md +98 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-inventory.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-long-desc-editor-mode.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-manage-stock.md +53 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-detail.md +58 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-pricing.md +225 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-shipping-class.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-tax-class.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-upgrade-path.md +78 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-option.md +79 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-tax-exemption.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation-pricing-table.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation.md +105 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/get-product-views.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/list-products.md +42 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/search-products.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/channel-rules.md +24 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/country-heat-map.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupon-overview.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupons.md +36 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-insights.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-overview.md +36 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-repeat.md +35 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segment-customers.md +36 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segments.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-value.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/dashboard-stats.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/failed-orders.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-new-vs-returning-customer.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-by-day-and-hour.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-meta.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-top-sold-products.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/future-renewals.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/generate-retention-snapshots.md +24 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-overview.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-activities.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-orders.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-revenue.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-at-risk.md +35 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-variations.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/item-count-distribution.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-chart.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-pie-chart.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-summary.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/locations.md +43 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-chart.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-completion-time.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-mix.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-value-distribution.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-disputes.md +38 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-methods.md +36 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison-launch.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison.md +40 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-detail.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-sales.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/refunds-overview.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/retention-snapshots-step.md +45 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sales-growth-chart.md +35 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/save-channel-rules.md +73 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/source-channels.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sources.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-cohorts.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-health.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-rebuys.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-retention.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-variations.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscriptions-overview.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/weeks-between-refund.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/assign-role.md +48 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/delete-role-assignment.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/get-role.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-managers.md +18 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-roles.md +18 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/search-users.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/update-role.md +43 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/create-saved-view.md +106 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/delete-saved-view.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/list-saved-views.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/update-saved-view.md +83 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-payment-addon.md +44 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-plugin-addon.md +44 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/change-storage-driver-status.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/check-paypal-webhook.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/create-storage-bucket.md +63 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/disconnect-payment-method.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/exchange-paypal-seller-auth-token.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-active-storage-drivers.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-checkout-fields.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-email-shortcodes.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-config-snippets.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-status.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-module-settings.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-connection-info.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-settings.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-permissions.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-plugin-addons.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-storage-driver-settings.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-store-settings.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-mcp-adapter.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-payment-addon.md +60 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-plugin-addon.md +64 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-payment-methods.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-storage-drivers.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-storage-buckets.md +67 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reorder-payment-methods.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reset-storage-driver-settings.md +45 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-checkout-fields.md +133 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-confirmation-settings.md +68 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-module-settings.md +68 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-design.md +67 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-settings.md +58 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-permissions.md +68 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-storage-driver-settings.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-store-settings.md +239 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/setup-paypal-webhook.md +48 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/toggle-mcp.md +40 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-storage-driver-connection.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-turnstile-keys.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-class.md +73 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-method.md +110 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-zone.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-class.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-method.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-zone.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class-profile.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-packages.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-zone.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-countries.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-states.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-classes.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-zones.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/save-shipping-packages.md +112 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-class.md +79 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-method.md +113 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-zone.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-zone-order.md +52 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-auto-renew.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-subscription.md +52 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/confirm-subscription-switch.md +70 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/fetch-subscription-remote.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/generate-early-payment-link.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-customer-subscription.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-or-create-plan.md +69 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-setup-intent-attempts.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-subscription.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/initiate-early-payment.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-customer-subscriptions.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-subscriptions.md +39 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/pause-subscription.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/reactivate-subscription.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/resume-subscription.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/switch-payment-method.md +70 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-payment-method.md +69 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-vendor-ids.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/verify-vendor-ids.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-class.md +51 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-rate.md +117 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-product-override.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-shipping-tax-override.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-class.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-rate.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-id.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-rates.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-eu-vat-product-overrides.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-oss-country-rates.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-preconfigured-tax-rates.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-product-overrides.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-tax-settings.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-all-tax-rates.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-classes.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-records.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/mark-taxes-as-filed.md +58 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/reset-eu-vat-rates.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-configured-countries.md +57 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-country-tax-id.md +50 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-eu-vat-cross-border-settings.md +127 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-oss-country-rates.md +100 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-product-override.md +110 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-shipping-tax-override.md +52 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-tax-settings.md +166 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-country-status.md +54 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-tax-rate.md +116 -0
- package/dist/skills/fluentcart-developer/references/restapi/order-bumps.md +433 -0
- package/dist/skills/fluentcart-developer/references/{rest-api-orders.md → restapi/orders.md} +146 -396
- package/dist/skills/fluentcart-developer/references/restapi/pdf-templates.md +212 -0
- package/dist/skills/fluentcart-developer/references/{rest-api-products.md → restapi/products.md} +354 -566
- package/dist/skills/fluentcart-developer/references/restapi/public-shop.md +191 -0
- package/dist/skills/fluentcart-developer/references/restapi/reports.md +3773 -0
- package/dist/skills/fluentcart-developer/references/restapi/roles.md +403 -0
- package/dist/skills/fluentcart-developer/references/restapi/saved-views.md +136 -0
- package/dist/skills/fluentcart-developer/references/restapi/settings.md +1423 -0
- package/dist/skills/fluentcart-developer/references/{rest-api-shipping.md → restapi/shipping.md} +243 -138
- package/dist/skills/fluentcart-developer/references/restapi/subscriptions.md +1169 -0
- package/dist/skills/fluentcart-developer/references/restapi/tax.md +1551 -0
- package/dist/skills/fluentcart-developer/references/restapi.md +127 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
- package/dist/skills/fluentcart-developer/.claude-plugin/plugin.json +0 -12
- package/dist/skills/fluentcart-developer/.mcp.json +0 -11
- package/dist/skills/fluentcart-developer/references/action-hooks-admin-templates.md +0 -787
- package/dist/skills/fluentcart-developer/references/action-hooks-cart-checkout.md +0 -1355
- package/dist/skills/fluentcart-developer/references/action-hooks-customers-users.md +0 -266
- package/dist/skills/fluentcart-developer/references/action-hooks-licenses.md +0 -855
- package/dist/skills/fluentcart-developer/references/action-hooks-orders.md +0 -631
- package/dist/skills/fluentcart-developer/references/action-hooks-payments-integrations.md +0 -963
- package/dist/skills/fluentcart-developer/references/action-hooks-products-coupons.md +0 -585
- package/dist/skills/fluentcart-developer/references/action-hooks-subscriptions.md +0 -661
- package/dist/skills/fluentcart-developer/references/customer-dashboard-endpoints.md +0 -169
- package/dist/skills/fluentcart-developer/references/database-models-query-builder.md +0 -194
- package/dist/skills/fluentcart-developer/references/database-models-reference.md +0 -604
- package/dist/skills/fluentcart-developer/references/database-schema-reference.md +0 -947
- package/dist/skills/fluentcart-developer/references/engineering-notes.md +0 -154
- package/dist/skills/fluentcart-developer/references/filter-hooks-cart-checkout.md +0 -1202
- package/dist/skills/fluentcart-developer/references/filter-hooks-customers-subscriptions.md +0 -902
- package/dist/skills/fluentcart-developer/references/filter-hooks-integrations-advanced.md +0 -1598
- package/dist/skills/fluentcart-developer/references/filter-hooks-orders-payments.md +0 -1319
- package/dist/skills/fluentcart-developer/references/filter-hooks-products-pricing.md +0 -628
- package/dist/skills/fluentcart-developer/references/filter-hooks-settings-configuration.md +0 -1177
- package/dist/skills/fluentcart-developer/references/fluentcart-developer-guide.md +0 -154
- package/dist/skills/fluentcart-developer/references/hooks-complete-index.md +0 -834
- package/dist/skills/fluentcart-developer/references/models-complete-index.md +0 -912
- package/dist/skills/fluentcart-developer/references/modules-and-extensions-reference.md +0 -224
- package/dist/skills/fluentcart-developer/references/order-bump-module.md +0 -163
- package/dist/skills/fluentcart-developer/references/paddle-gateway-case-study.md +0 -1931
- package/dist/skills/fluentcart-developer/references/payment-gateway-integration.md +0 -761
- package/dist/skills/fluentcart-developer/references/rest-api-checkout.md +0 -288
- package/dist/skills/fluentcart-developer/references/rest-api-coupons.md +0 -801
- package/dist/skills/fluentcart-developer/references/rest-api-customer-profile.md +0 -190
- package/dist/skills/fluentcart-developer/references/rest-api-dashboard-utilities.md +0 -219
- package/dist/skills/fluentcart-developer/references/rest-api-email-notifications.md +0 -619
- package/dist/skills/fluentcart-developer/references/rest-api-files.md +0 -290
- package/dist/skills/fluentcart-developer/references/rest-api-integrations.md +0 -324
- package/dist/skills/fluentcart-developer/references/rest-api-labels-attributes.md +0 -321
- package/dist/skills/fluentcart-developer/references/rest-api-licensing.md +0 -174
- package/dist/skills/fluentcart-developer/references/rest-api-order-bumps.md +0 -200
- package/dist/skills/fluentcart-developer/references/rest-api-overview.md +0 -131
- package/dist/skills/fluentcart-developer/references/rest-api-public-shop.md +0 -172
- package/dist/skills/fluentcart-developer/references/rest-api-reference.md +0 -552
- package/dist/skills/fluentcart-developer/references/rest-api-reports.md +0 -377
- package/dist/skills/fluentcart-developer/references/rest-api-roles-permissions.md +0 -147
- package/dist/skills/fluentcart-developer/references/rest-api-settings.md +0 -528
- package/dist/skills/fluentcart-developer/references/rest-api-subscriptions.md +0 -938
- package/dist/skills/fluentcart-developer/references/rest-api-tax.md +0 -356
- package/dist/skills/fluentcart-developer/references/shipping-module-guide.md +0 -126
- package/dist/skills/fluentcart-developer/references/software-licensing-sdk.md +0 -228
- package/dist/skills/fluentcart-developer/references/storage-drivers-module.md +0 -140
package/dist/skills/fluentcart-developer/references/hooks/actions/payments-and-integrations.md
ADDED
|
@@ -0,0 +1,1163 @@
|
|
|
1
|
+
# Payments & Integrations
|
|
2
|
+
|
|
3
|
+
All hooks related to payment processing, payment gateway webhooks, third-party integrations, file storage drivers, and development logging. Many of these hooks provide [Order](/database/models/order.md), [Customer](/database/models/customer.md), and [OrderTransaction](/database/models/order-transaction.md) model instances.
|
|
4
|
+
|
|
5
|
+
## Payment Events
|
|
6
|
+
|
|
7
|
+
### ` payment_{$paymentStatus} `
|
|
8
|
+
|
|
9
|
+
`fluent_cart/payment_{$paymentStatus}` — Fires after order creation when a transaction succeeds
|
|
10
|
+
|
|
11
|
+
**When it runs:** This dynamic action fires during [Order](/database/models/order.md) finalization, after the transaction has been recorded and the payment status is determined. It only fires when the transaction status is one of the recognized success statuses (e.g. `paid`, `pending`). The `{$paymentStatus}` portion is replaced with the order's actual payment status.
|
|
12
|
+
|
|
13
|
+
**Parameters:**
|
|
14
|
+
|
|
15
|
+
- `$data` (array): [Order](/database/models/order.md), [Customer](/database/models/customer.md), and [OrderTransaction](/database/models/order-transaction.md) data
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
$data = [
|
|
19
|
+
'order' => $order, // Order model instance
|
|
20
|
+
'customer' => $customer, // Customer model (via $order->customer)
|
|
21
|
+
'transaction' => $transaction, // Transaction model (via $order->latest_transaction)
|
|
22
|
+
];
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
**Source:** `api/Resource/OrderResource.php`
|
|
26
|
+
|
|
27
|
+
**Dynamic variants:**
|
|
28
|
+
|
|
29
|
+
- `fluent_cart/payment_paid` -- payment completed successfully
|
|
30
|
+
- `fluent_cart/payment_pending` -- payment is pending confirmation
|
|
31
|
+
|
|
32
|
+
**Usage:**
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
add_action('fluent_cart/payment_paid', function ($data) {
|
|
36
|
+
$order = $data['order'];
|
|
37
|
+
$customer = $data['customer'];
|
|
38
|
+
|
|
39
|
+
// Grant access after successful payment
|
|
40
|
+
update_user_meta($customer->user_id, 'has_premium_access', true);
|
|
41
|
+
|
|
42
|
+
fluent_cart_add_log(
|
|
43
|
+
'Payment Received',
|
|
44
|
+
'Order #' . $order->id . ' paid successfully.',
|
|
45
|
+
'success'
|
|
46
|
+
);
|
|
47
|
+
}, 10, 1);
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### ` payment_{$transactionType}_{$paymentStatus} `
|
|
51
|
+
|
|
52
|
+
`fluent_cart/payment_{$transactionType}_{$paymentStatus}` — Fires after order creation with both transaction type and payment status
|
|
53
|
+
|
|
54
|
+
**When it runs:** This dynamic action fires immediately after `fluent_cart/payment_{$paymentStatus}` during [Order](/database/models/order.md) finalization. It provides more granular filtering by combining the transaction type (e.g. `one_time`, `subscription`) with the payment status (e.g. `paid`, `pending`).
|
|
55
|
+
|
|
56
|
+
**Parameters:**
|
|
57
|
+
|
|
58
|
+
- `$data` (array): Order, customer, and transaction data
|
|
59
|
+
|
|
60
|
+
```
|
|
61
|
+
$data = [
|
|
62
|
+
'order' => $order, // Order model instance
|
|
63
|
+
'customer' => $customer, // Customer model (via $order->customer)
|
|
64
|
+
'transaction' => $transaction, // Transaction model (via $order->latest_transaction)
|
|
65
|
+
];
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
**Source:** `api/Resource/OrderResource.php`
|
|
69
|
+
|
|
70
|
+
**Dynamic variants:**
|
|
71
|
+
|
|
72
|
+
- `fluent_cart/payment_one_time_paid` -- one-time purchase paid
|
|
73
|
+
- `fluent_cart/payment_subscription_paid` -- subscription payment paid
|
|
74
|
+
- `fluent_cart/payment_one_time_pending` -- one-time purchase pending
|
|
75
|
+
- `fluent_cart/payment_subscription_pending` -- subscription payment pending
|
|
76
|
+
|
|
77
|
+
**Usage:**
|
|
78
|
+
|
|
79
|
+
```
|
|
80
|
+
add_action('fluent_cart/payment_subscription_paid', function ($data) {
|
|
81
|
+
$order = $data['order'];
|
|
82
|
+
$transaction = $data['transaction'];
|
|
83
|
+
|
|
84
|
+
// Handle subscription-specific logic after payment
|
|
85
|
+
fluent_cart_add_log(
|
|
86
|
+
'Subscription Payment',
|
|
87
|
+
'Subscription payment received for Order #' . $order->id,
|
|
88
|
+
'success'
|
|
89
|
+
);
|
|
90
|
+
}, 10, 1);
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### ` after_payment_{$paymentStatus} `
|
|
94
|
+
|
|
95
|
+
`fluent_cart/payments/after_payment_{$paymentStatus}` — Fires in abstract gateway after payment processing completes
|
|
96
|
+
|
|
97
|
+
**When it runs:** This dynamic action fires inside the abstract payment gateway base class after a payment has been processed, the [OrderTransaction](/database/models/order-transaction.md) recorded, and the [Order](/database/models/order.md) status updated. It runs after `changeOrderStatus()` and any automatic digital-product completion logic. The `{$paymentStatus}` is the resulting payment status (e.g. `paid`, `failed`).
|
|
98
|
+
|
|
99
|
+
**Parameters:**
|
|
100
|
+
|
|
101
|
+
- `$data` (array): The order that was just processed
|
|
102
|
+
|
|
103
|
+
```
|
|
104
|
+
$data = [
|
|
105
|
+
'order' => $order, // Order model instance with updated status
|
|
106
|
+
];
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
**Source:** `app/Modules/PaymentMethods/Core/AbstractPaymentGateway.php`
|
|
110
|
+
|
|
111
|
+
**Usage:**
|
|
112
|
+
|
|
113
|
+
```
|
|
114
|
+
add_action('fluent_cart/payments/after_payment_paid', function ($data) {
|
|
115
|
+
$order = $data['order'];
|
|
116
|
+
|
|
117
|
+
// Trigger external fulfillment after any gateway marks payment as paid
|
|
118
|
+
wp_remote_post('https://fulfillment.example.com/api/orders', [
|
|
119
|
+
'body' => wp_json_encode([
|
|
120
|
+
'order_id' => $order->id,
|
|
121
|
+
'total' => $order->total_amount,
|
|
122
|
+
]),
|
|
123
|
+
]);
|
|
124
|
+
}, 10, 1);
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
### ` payment_success `
|
|
128
|
+
|
|
129
|
+
`fluent_cart/payment_success` — Fires when an Airwallex or Square payment succeeds
|
|
130
|
+
|
|
131
|
+
**When it runs:** This action fires inside the Airwallex and Square gateway handlers when a payment intent or payment object is confirmed as successful. The order status is updated to `processing` and payment status to `paid` before this hook runs.
|
|
132
|
+
|
|
133
|
+
**Parameters:**
|
|
134
|
+
|
|
135
|
+
- `$data` (array): The order and payment intent/payment data
|
|
136
|
+
|
|
137
|
+
```
|
|
138
|
+
$data = [
|
|
139
|
+
'order' => $order, // Order model with updated status
|
|
140
|
+
'payment_intent' => $paymentIntent, // Gateway-specific payment intent or payment object (array)
|
|
141
|
+
];
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
**Source:** `app/Modules/PaymentMethods/AirwallexGateway/Airwallex.php`, `app/Modules/PaymentMethods/SquareGateway/Square.php`
|
|
145
|
+
|
|
146
|
+
**Usage:**
|
|
147
|
+
|
|
148
|
+
```
|
|
149
|
+
add_action('fluent_cart/payment_success', function ($data) {
|
|
150
|
+
$order = $data['order'];
|
|
151
|
+
$paymentIntent = $data['payment_intent'];
|
|
152
|
+
|
|
153
|
+
// Log the gateway-specific payment reference
|
|
154
|
+
fluent_cart_add_log(
|
|
155
|
+
'Gateway Payment Success',
|
|
156
|
+
'Payment intent ' . $paymentIntent['id'] . ' for Order #' . $order->id,
|
|
157
|
+
'success'
|
|
158
|
+
);
|
|
159
|
+
}, 10, 1);
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
### ` payment_failed `
|
|
163
|
+
|
|
164
|
+
`fluent_cart/payment_failed` — Fires when an Airwallex payment fails
|
|
165
|
+
|
|
166
|
+
**When it runs:** This action fires inside the Airwallex gateway handler when a payment intent is determined to have failed. The order status and payment status are both set to `failed` before this hook runs.
|
|
167
|
+
|
|
168
|
+
**Parameters:**
|
|
169
|
+
|
|
170
|
+
- `$data` (array): The order and failed payment intent data
|
|
171
|
+
|
|
172
|
+
```
|
|
173
|
+
$data = [
|
|
174
|
+
'order' => $order, // Order model with failed status
|
|
175
|
+
'payment_intent' => $paymentIntent, // Airwallex payment intent object (array)
|
|
176
|
+
];
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
**Source:** `app/Modules/PaymentMethods/AirwallexGateway/Airwallex.php`
|
|
180
|
+
|
|
181
|
+
**Usage:**
|
|
182
|
+
|
|
183
|
+
```
|
|
184
|
+
add_action('fluent_cart/payment_failed', function ($data) {
|
|
185
|
+
$order = $data['order'];
|
|
186
|
+
$paymentIntent = $data['payment_intent'];
|
|
187
|
+
|
|
188
|
+
// Notify admin about failed payment
|
|
189
|
+
wp_mail(
|
|
190
|
+
get_option('admin_email'),
|
|
191
|
+
'Payment Failed - Order #' . $order->id,
|
|
192
|
+
'Airwallex payment intent ' . $paymentIntent['id'] . ' failed.'
|
|
193
|
+
);
|
|
194
|
+
}, 10, 1);
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
199
|
+
## Payment Gateway Registration
|
|
200
|
+
|
|
201
|
+
### ` register_payment_methods `
|
|
202
|
+
|
|
203
|
+
`fluent_cart/register_payment_methods` — Register custom payment gateways
|
|
204
|
+
|
|
205
|
+
**When it runs:** This action fires during initialization after all built-in payment gateways (Stripe, PayPal, Razorpay, Paystack, COD, Square, Airwallex) have been registered. Use this hook to register your own custom payment gateway with the gateway manager.
|
|
206
|
+
|
|
207
|
+
**Parameters:**
|
|
208
|
+
|
|
209
|
+
- `$data` (array): Contains the gateway manager instance
|
|
210
|
+
|
|
211
|
+
```
|
|
212
|
+
$data = [
|
|
213
|
+
'gatewayManager' => $gateway, // GatewayManager instance for registering gateways
|
|
214
|
+
];
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
**Source:** `app/Hooks/Handlers/GlobalPaymentHandler.php`
|
|
218
|
+
|
|
219
|
+
**Usage:**
|
|
220
|
+
|
|
221
|
+
```
|
|
222
|
+
add_action('fluent_cart/register_payment_methods', function ($data) {
|
|
223
|
+
$gatewayManager = $data['gatewayManager'];
|
|
224
|
+
|
|
225
|
+
// Register a custom payment gateway
|
|
226
|
+
$gatewayManager->register('my_gateway', new MyCustomPaymentGateway());
|
|
227
|
+
}, 10, 1);
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
### ` after_render_payment_method_{$route} `
|
|
231
|
+
|
|
232
|
+
`fluent_cart/after_render_payment_method_{$route}` — Fires after a payment method UI renders on the checkout
|
|
233
|
+
|
|
234
|
+
**When it runs:** Fires from `AbstractPaymentGateway::prepare()` immediately after a payment method's UI has been rendered on the checkout. `{$route}` is the gateway route slug (e.g. `stripe`, `paypal`).
|
|
235
|
+
|
|
236
|
+
**Parameters:**
|
|
237
|
+
|
|
238
|
+
None.
|
|
239
|
+
|
|
240
|
+
**Source:** `app/Modules/PaymentMethods/Core/AbstractPaymentGateway.php:551`
|
|
241
|
+
|
|
242
|
+
**Dynamic variants:** same route slugs as above — `stripe`, `paypal`, `square`, `airwallex`, `offline_payment`, `razorpay`, `paystack`.
|
|
243
|
+
|
|
244
|
+
**Usage:**
|
|
245
|
+
|
|
246
|
+
```
|
|
247
|
+
add_action('fluent_cart/after_render_payment_method_paypal', function () {
|
|
248
|
+
echo '<p class="payment-note">You will be redirected to PayPal to complete payment.</p>';
|
|
249
|
+
}, 10, 0);
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
---
|
|
253
|
+
|
|
254
|
+
## Stripe Webhooks
|
|
255
|
+
|
|
256
|
+
### ` stripe/webhook_{$eventType} `
|
|
257
|
+
|
|
258
|
+
`fluent_cart/payments/stripe/webhook_{$eventType}` — Fires for each Stripe webhook event
|
|
259
|
+
|
|
260
|
+
**When it runs:** This dynamic action fires during Stripe webhook (IPN) processing after the event has been verified and the associated [Order](/database/models/order.md) has been found. The `{$eventType}` is the Stripe event type with dots replaced by underscores (e.g. `invoice.payment_succeeded` becomes `invoice_payment_succeeded`). The webhook handler checks if any listener is registered via `has_action()` before dispatching.
|
|
261
|
+
|
|
262
|
+
**Parameters:**
|
|
263
|
+
|
|
264
|
+
- `$data` (array): The Stripe event object and associated order
|
|
265
|
+
|
|
266
|
+
```
|
|
267
|
+
$data = [
|
|
268
|
+
'event' => $event, // Stripe Event object (contains type, data, etc.)
|
|
269
|
+
'order' => $order, // Order model instance (may be WP_Error if not found)
|
|
270
|
+
];
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
**Source:** `app/Modules/PaymentMethods/StripeGateway/Webhook/IPN.php`
|
|
274
|
+
|
|
275
|
+
**Dynamic variants (common Stripe events):**
|
|
276
|
+
|
|
277
|
+
- `fluent_cart/payments/stripe/webhook_invoice_payment_succeeded`
|
|
278
|
+
- `fluent_cart/payments/stripe/webhook_invoice_payment_failed`
|
|
279
|
+
- `fluent_cart/payments/stripe/webhook_charge_refunded`
|
|
280
|
+
- `fluent_cart/payments/stripe/webhook_customer_subscription_deleted`
|
|
281
|
+
- `fluent_cart/payments/stripe/webhook_customer_subscription_updated`
|
|
282
|
+
- `fluent_cart/payments/stripe/webhook_payment_intent_succeeded`
|
|
283
|
+
- `fluent_cart/payments/stripe/webhook_payment_intent_payment_failed`
|
|
284
|
+
|
|
285
|
+
**Usage:**
|
|
286
|
+
|
|
287
|
+
```
|
|
288
|
+
add_action('fluent_cart/payments/stripe/webhook_charge_refunded', function ($data) {
|
|
289
|
+
$event = $data['event'];
|
|
290
|
+
$order = $data['order'];
|
|
291
|
+
|
|
292
|
+
if (is_wp_error($order)) {
|
|
293
|
+
return;
|
|
294
|
+
}
|
|
295
|
+
|
|
296
|
+
$charge = $event->data->object;
|
|
297
|
+
|
|
298
|
+
// Custom refund handling
|
|
299
|
+
fluent_cart_add_log(
|
|
300
|
+
'Stripe Refund Webhook',
|
|
301
|
+
'Charge ' . $charge->id . ' refunded for Order #' . $order->id,
|
|
302
|
+
'info'
|
|
303
|
+
);
|
|
304
|
+
}, 10, 1);
|
|
305
|
+
```
|
|
306
|
+
|
|
307
|
+
---
|
|
308
|
+
|
|
309
|
+
## PayPal Webhooks
|
|
310
|
+
|
|
311
|
+
### ` paypal_webhook_received `
|
|
312
|
+
|
|
313
|
+
`fluent_cart/paypal_webhook_received` — Fires when raw PayPal webhook data is received before processing
|
|
314
|
+
|
|
315
|
+
**When it runs:** This action fires early in PayPal webhook processing, after the webhook type has been validated against the list of supported events but before any event-specific handling occurs. Use this to log or inspect all incoming PayPal webhook payloads.
|
|
316
|
+
|
|
317
|
+
**Parameters:**
|
|
318
|
+
|
|
319
|
+
- `$data` (array): The parsed and raw webhook data
|
|
320
|
+
|
|
321
|
+
```
|
|
322
|
+
$data = [
|
|
323
|
+
'data' => $data, // Parsed webhook payload (array)
|
|
324
|
+
'raw' => $post_data, // Raw POST body string
|
|
325
|
+
];
|
|
326
|
+
```
|
|
327
|
+
|
|
328
|
+
**Source:** `app/Modules/PaymentMethods/PayPalGateway/IPN.php`
|
|
329
|
+
|
|
330
|
+
**Usage:**
|
|
331
|
+
|
|
332
|
+
```
|
|
333
|
+
add_action('fluent_cart/paypal_webhook_received', function ($data) {
|
|
334
|
+
// Log all incoming PayPal webhooks for debugging
|
|
335
|
+
error_log('PayPal webhook received: ' . wp_json_encode($data['data']));
|
|
336
|
+
}, 10, 1);
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
### ` paypal/webhook_subscription_payment_received `
|
|
340
|
+
|
|
341
|
+
`fluent_cart/payments/paypal/webhook_subscription_payment_received` — Fires when a PayPal recurring subscription payment is received
|
|
342
|
+
|
|
343
|
+
**When it runs:** This action fires when a PayPal `PAYMENT.SALE.COMPLETED` webhook is received and the resource contains a `billing_agreement_id`, indicating it is a recurring subscription payment rather than a one-time purchase.
|
|
344
|
+
|
|
345
|
+
**Parameters:**
|
|
346
|
+
|
|
347
|
+
- `$data` (array): The charge resource and billing agreement ID
|
|
348
|
+
|
|
349
|
+
```
|
|
350
|
+
$data = [
|
|
351
|
+
'charge' => $resource, // PayPal sale resource object (array)
|
|
352
|
+
'vendor_subscription_id' => $billingAgreementId, // PayPal billing agreement ID (string)
|
|
353
|
+
];
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+
**Source:** `app/Modules/PaymentMethods/PayPalGateway/IPN.php`
|
|
357
|
+
|
|
358
|
+
**Usage:**
|
|
359
|
+
|
|
360
|
+
```
|
|
361
|
+
add_action('fluent_cart/payments/paypal/webhook_subscription_payment_received', function ($data) {
|
|
362
|
+
$charge = $data['charge'];
|
|
363
|
+
$billingAgreementId = $data['vendor_subscription_id'];
|
|
364
|
+
|
|
365
|
+
// Track recurring payment
|
|
366
|
+
fluent_cart_add_log(
|
|
367
|
+
'PayPal Recurring Payment',
|
|
368
|
+
'Billing agreement ' . $billingAgreementId . ' payment received.',
|
|
369
|
+
'success'
|
|
370
|
+
);
|
|
371
|
+
}, 10, 1);
|
|
372
|
+
```
|
|
373
|
+
|
|
374
|
+
### ` paypal/webhook_payment_capture_completed `
|
|
375
|
+
|
|
376
|
+
`fluent_cart/payments/paypal/webhook_payment_capture_completed` — Fires when a PayPal one-time payment capture completes
|
|
377
|
+
|
|
378
|
+
**When it runs:** This action fires when a PayPal `PAYMENT.SALE.COMPLETED` webhook arrives without a billing agreement ID (one-time payment), or when a `PAYMENT.CAPTURE.COMPLETED` event is received. Both indicate a successful one-time payment capture.
|
|
379
|
+
|
|
380
|
+
**Parameters:**
|
|
381
|
+
|
|
382
|
+
- `$data` (array): The charge resource from PayPal
|
|
383
|
+
|
|
384
|
+
```
|
|
385
|
+
$data = [
|
|
386
|
+
'charge' => $resource, // PayPal capture/sale resource object (array)
|
|
387
|
+
];
|
|
388
|
+
```
|
|
389
|
+
|
|
390
|
+
**Source:** `app/Modules/PaymentMethods/PayPalGateway/IPN.php`
|
|
391
|
+
|
|
392
|
+
**Usage:**
|
|
393
|
+
|
|
394
|
+
```
|
|
395
|
+
add_action('fluent_cart/payments/paypal/webhook_payment_capture_completed', function ($data) {
|
|
396
|
+
$charge = $data['charge'];
|
|
397
|
+
|
|
398
|
+
// Handle one-time payment capture confirmation
|
|
399
|
+
fluent_cart_add_log(
|
|
400
|
+
'PayPal Capture Completed',
|
|
401
|
+
'Capture completed for resource: ' . wp_json_encode($charge),
|
|
402
|
+
'success'
|
|
403
|
+
);
|
|
404
|
+
}, 10, 1);
|
|
405
|
+
```
|
|
406
|
+
|
|
407
|
+
### ` paypal/webhook_payment_sale_refunded `
|
|
408
|
+
|
|
409
|
+
`fluent_cart/payments/paypal/webhook_payment_sale_refunded` — Fires when a PayPal recurring sale is refunded
|
|
410
|
+
|
|
411
|
+
**When it runs:** This action fires when a PayPal `PAYMENT.SALE.REFUNDED` webhook is received, indicating that a refund has been issued for a recurring/subscription payment sale.
|
|
412
|
+
|
|
413
|
+
**Parameters:**
|
|
414
|
+
|
|
415
|
+
- `$data` (array): The refund resource from PayPal
|
|
416
|
+
|
|
417
|
+
```
|
|
418
|
+
$data = [
|
|
419
|
+
'refund' => $resource, // PayPal refund resource object (array)
|
|
420
|
+
];
|
|
421
|
+
```
|
|
422
|
+
|
|
423
|
+
**Source:** `app/Modules/PaymentMethods/PayPalGateway/IPN.php`
|
|
424
|
+
|
|
425
|
+
**Usage:**
|
|
426
|
+
|
|
427
|
+
```
|
|
428
|
+
add_action('fluent_cart/payments/paypal/webhook_payment_sale_refunded', function ($data) {
|
|
429
|
+
$refund = $data['refund'];
|
|
430
|
+
|
|
431
|
+
// Handle recurring payment refund
|
|
432
|
+
fluent_cart_add_log(
|
|
433
|
+
'PayPal Sale Refund',
|
|
434
|
+
'Recurring payment sale refunded: ' . wp_json_encode($refund),
|
|
435
|
+
'info'
|
|
436
|
+
);
|
|
437
|
+
}, 10, 1);
|
|
438
|
+
```
|
|
439
|
+
|
|
440
|
+
### ` paypal/webhook_payment_capture_refunded `
|
|
441
|
+
|
|
442
|
+
`fluent_cart/payments/paypal/webhook_payment_capture_refunded` — Fires when a PayPal one-time payment capture is refunded
|
|
443
|
+
|
|
444
|
+
**When it runs:** This action fires when a PayPal `PAYMENT.CAPTURE.REFUNDED` webhook is received, indicating that a refund has been issued for a one-time payment capture.
|
|
445
|
+
|
|
446
|
+
**Parameters:**
|
|
447
|
+
|
|
448
|
+
- `$data` (array): The refund resource from PayPal
|
|
449
|
+
|
|
450
|
+
```
|
|
451
|
+
$data = [
|
|
452
|
+
'refund' => $resource, // PayPal refund resource object (array)
|
|
453
|
+
];
|
|
454
|
+
```
|
|
455
|
+
|
|
456
|
+
**Source:** `app/Modules/PaymentMethods/PayPalGateway/IPN.php`
|
|
457
|
+
|
|
458
|
+
**Usage:**
|
|
459
|
+
|
|
460
|
+
```
|
|
461
|
+
add_action('fluent_cart/payments/paypal/webhook_payment_capture_refunded', function ($data) {
|
|
462
|
+
$refund = $data['refund'];
|
|
463
|
+
|
|
464
|
+
// Handle one-time payment refund
|
|
465
|
+
fluent_cart_add_log(
|
|
466
|
+
'PayPal Capture Refund',
|
|
467
|
+
'One-time payment capture refunded: ' . wp_json_encode($refund),
|
|
468
|
+
'info'
|
|
469
|
+
);
|
|
470
|
+
}, 10, 1);
|
|
471
|
+
```
|
|
472
|
+
|
|
473
|
+
### ` paypal/webhook_{$eventType} (disputes) `
|
|
474
|
+
|
|
475
|
+
`fluent_cart/payments/paypal/webhook_{$eventType}` — Fires for PayPal customer dispute events
|
|
476
|
+
|
|
477
|
+
**When it runs:** This dynamic action fires when a PayPal dispute-related webhook is received. The `{$eventType}` is the PayPal event type converted to lowercase with dots replaced by underscores.
|
|
478
|
+
|
|
479
|
+
**Parameters:**
|
|
480
|
+
|
|
481
|
+
- `$data` (array): The dispute resource from PayPal
|
|
482
|
+
|
|
483
|
+
```
|
|
484
|
+
$data = [
|
|
485
|
+
'dispute' => $resource, // PayPal dispute resource object (array)
|
|
486
|
+
];
|
|
487
|
+
```
|
|
488
|
+
|
|
489
|
+
**Source:** `app/Modules/PaymentMethods/PayPalGateway/IPN.php`
|
|
490
|
+
|
|
491
|
+
**Dynamic variants:**
|
|
492
|
+
|
|
493
|
+
- `fluent_cart/payments/paypal/webhook_customer_dispute_created`
|
|
494
|
+
- `fluent_cart/payments/paypal/webhook_customer_dispute_updated`
|
|
495
|
+
- `fluent_cart/payments/paypal/webhook_customer_dispute_resolved`
|
|
496
|
+
|
|
497
|
+
**Usage:**
|
|
498
|
+
|
|
499
|
+
```
|
|
500
|
+
add_action('fluent_cart/payments/paypal/webhook_customer_dispute_created', function ($data) {
|
|
501
|
+
$dispute = $data['dispute'];
|
|
502
|
+
|
|
503
|
+
// Alert admin about a new PayPal dispute
|
|
504
|
+
wp_mail(
|
|
505
|
+
get_option('admin_email'),
|
|
506
|
+
'PayPal Dispute Created',
|
|
507
|
+
'A customer has opened a dispute. Details: ' . wp_json_encode($dispute)
|
|
508
|
+
);
|
|
509
|
+
}, 10, 1);
|
|
510
|
+
```
|
|
511
|
+
|
|
512
|
+
### ` paypal/webhook_{$eventType} (subscriptions) `
|
|
513
|
+
|
|
514
|
+
`fluent_cart/payments/paypal/webhook_{$eventType}` — Fires for PayPal billing subscription lifecycle events
|
|
515
|
+
|
|
516
|
+
**When it runs:** This dynamic action fires as a catch-all for PayPal webhook events that are not payments, refunds, or disputes. These are primarily billing subscription lifecycle events. The `{$eventType}` is the PayPal event type converted to lowercase with dots replaced by underscores.
|
|
517
|
+
|
|
518
|
+
**Parameters:**
|
|
519
|
+
|
|
520
|
+
- `$data` (array): The PayPal subscription resource
|
|
521
|
+
|
|
522
|
+
```
|
|
523
|
+
$data = [
|
|
524
|
+
'paypal_subscription' => $resource, // PayPal subscription resource object (array)
|
|
525
|
+
];
|
|
526
|
+
```
|
|
527
|
+
|
|
528
|
+
**Source:** `app/Modules/PaymentMethods/PayPalGateway/IPN.php`
|
|
529
|
+
|
|
530
|
+
**Dynamic variants:**
|
|
531
|
+
|
|
532
|
+
- `fluent_cart/payments/paypal/webhook_billing_subscription_activated`
|
|
533
|
+
- `fluent_cart/payments/paypal/webhook_billing_subscription_created`
|
|
534
|
+
- `fluent_cart/payments/paypal/webhook_billing_subscription_cancelled`
|
|
535
|
+
- `fluent_cart/payments/paypal/webhook_billing_subscription_expired`
|
|
536
|
+
- `fluent_cart/payments/paypal/webhook_billing_subscription_suspended`
|
|
537
|
+
- `fluent_cart/payments/paypal/webhook_billing_subscription_re-activated`
|
|
538
|
+
|
|
539
|
+
**Usage:**
|
|
540
|
+
|
|
541
|
+
```
|
|
542
|
+
add_action('fluent_cart/payments/paypal/webhook_billing_subscription_cancelled', function ($data) {
|
|
543
|
+
$subscription = $data['paypal_subscription'];
|
|
544
|
+
|
|
545
|
+
// Handle PayPal subscription cancellation
|
|
546
|
+
fluent_cart_add_log(
|
|
547
|
+
'PayPal Subscription Cancelled',
|
|
548
|
+
'PayPal subscription cancelled: ' . wp_json_encode($subscription),
|
|
549
|
+
'warning'
|
|
550
|
+
);
|
|
551
|
+
}, 10, 1);
|
|
552
|
+
```
|
|
553
|
+
|
|
554
|
+
### ` payments/paypal_vault_rejected `
|
|
555
|
+
|
|
556
|
+
`fluent_cart/payments/paypal_vault_rejected` — Fires when PayPal rejects saving a payment method for future use
|
|
557
|
+
|
|
558
|
+
**When it runs:** This action fires inside the PayPal gateway's order-creation flow when the buyer opted to save their payment method (vaulting), but PayPal's response indicates the payment source cannot be vaulted (e.g. `PAYMENT_SOURCE_NOT_VAULTABLE`, `VAULTING_NOT_ENABLED`). After this fires, FluentCart strips the vaulting attributes and retries the order creation without vaulting, so a temporary vaulting outage doesn't fail the whole checkout.
|
|
559
|
+
|
|
560
|
+
**Parameters:**
|
|
561
|
+
|
|
562
|
+
- `$data` (array): Vault rejection context
|
|
563
|
+
|
|
564
|
+
```
|
|
565
|
+
$data = [
|
|
566
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
567
|
+
'transaction' => $transaction, // \FluentCart\App\Models\OrderTransaction
|
|
568
|
+
'error' => $paypalOrder, // WP_Error — the PayPal API error response
|
|
569
|
+
];
|
|
570
|
+
```
|
|
571
|
+
|
|
572
|
+
**Source:** `app/Modules/PaymentMethods/PayPalGateway/Processor.php:262`
|
|
573
|
+
|
|
574
|
+
**Usage:**
|
|
575
|
+
|
|
576
|
+
```
|
|
577
|
+
add_action('fluent_cart/payments/paypal_vault_rejected', function ($data) {
|
|
578
|
+
$order = $data['order'];
|
|
579
|
+
fluent_cart_add_log(
|
|
580
|
+
'PayPal Vaulting Rejected',
|
|
581
|
+
sprintf('Order #%d: PayPal declined to save the payment method.', $order->id),
|
|
582
|
+
'warning'
|
|
583
|
+
);
|
|
584
|
+
}, 10, 1);
|
|
585
|
+
```
|
|
586
|
+
|
|
587
|
+
---
|
|
588
|
+
|
|
589
|
+
## Mollie Webhooks Pro
|
|
590
|
+
|
|
591
|
+
### ` mollie/webhook_subscription_payment_{$status} `
|
|
592
|
+
|
|
593
|
+
`fluent_cart/payments/mollie/webhook_subscription_payment_{$status}` Pro — Fires for each Mollie subscription payment status change
|
|
594
|
+
|
|
595
|
+
**When it runs:** This dynamic action fires during Mollie webhook (IPN) processing when a subscription payment status is determined. The `{$status}` is replaced with the Mollie payment status (e.g. `paid`, `failed`, `expired`, `canceled`). Use this hook to react to specific subscription payment outcomes from Mollie.
|
|
596
|
+
|
|
597
|
+
**Parameters:**
|
|
598
|
+
|
|
599
|
+
- `$molliePayment` (object): The Mollie Payment object from the API
|
|
600
|
+
- `$order` ([Order](/database/models/order.md)): The Order model instance associated with this payment
|
|
601
|
+
|
|
602
|
+
**Source:** `fluent-cart-pro/app/Modules/PaymentMethods/MollieGateway/Webhook/MollieIPN.php`
|
|
603
|
+
|
|
604
|
+
**Dynamic variants:**
|
|
605
|
+
|
|
606
|
+
- `fluent_cart/payments/mollie/webhook_subscription_payment_paid` -- subscription payment succeeded
|
|
607
|
+
- `fluent_cart/payments/mollie/webhook_subscription_payment_failed` -- subscription payment failed
|
|
608
|
+
- `fluent_cart/payments/mollie/webhook_subscription_payment_expired` -- subscription payment expired
|
|
609
|
+
- `fluent_cart/payments/mollie/webhook_subscription_payment_canceled` -- subscription payment canceled
|
|
610
|
+
|
|
611
|
+
**Usage:**
|
|
612
|
+
|
|
613
|
+
```
|
|
614
|
+
add_action('fluent_cart/payments/mollie/webhook_subscription_payment_paid', function ($molliePayment, $order) {
|
|
615
|
+
// Handle successful Mollie subscription payment
|
|
616
|
+
fluent_cart_add_log(
|
|
617
|
+
'Mollie Subscription Payment',
|
|
618
|
+
'Subscription payment received for Order #' . $order->id . ' (Mollie ID: ' . $molliePayment->id . ')',
|
|
619
|
+
'success'
|
|
620
|
+
);
|
|
621
|
+
}, 10, 2);
|
|
622
|
+
```
|
|
623
|
+
|
|
624
|
+
### ` mollie/webhook_payment_{$status} `
|
|
625
|
+
|
|
626
|
+
`fluent_cart/payments/mollie/webhook_payment_{$status}` Pro — Fires for each Mollie one-time payment status change
|
|
627
|
+
|
|
628
|
+
**When it runs:** This dynamic action fires during Mollie webhook processing when a one-time (non-subscription) payment status is determined. The `{$status}` is replaced with the Mollie payment status. Use this hook to react to specific one-time payment outcomes from Mollie.
|
|
629
|
+
|
|
630
|
+
**Parameters:**
|
|
631
|
+
|
|
632
|
+
- `$molliePayment` (object): The Mollie Payment object from the API
|
|
633
|
+
- `$order` ([Order](/database/models/order.md)): The Order model instance associated with this payment
|
|
634
|
+
|
|
635
|
+
**Source:** `fluent-cart-pro/app/Modules/PaymentMethods/MollieGateway/Webhook/MollieIPN.php`
|
|
636
|
+
|
|
637
|
+
**Dynamic variants:**
|
|
638
|
+
|
|
639
|
+
- `fluent_cart/payments/mollie/webhook_payment_paid` -- one-time payment succeeded
|
|
640
|
+
- `fluent_cart/payments/mollie/webhook_payment_failed` -- one-time payment failed
|
|
641
|
+
- `fluent_cart/payments/mollie/webhook_payment_expired` -- one-time payment expired
|
|
642
|
+
- `fluent_cart/payments/mollie/webhook_payment_canceled` -- one-time payment canceled
|
|
643
|
+
|
|
644
|
+
**Usage:**
|
|
645
|
+
|
|
646
|
+
```
|
|
647
|
+
add_action('fluent_cart/payments/mollie/webhook_payment_paid', function ($molliePayment, $order) {
|
|
648
|
+
// Handle successful Mollie one-time payment
|
|
649
|
+
wp_remote_post('https://fulfillment.example.com/api/orders', [
|
|
650
|
+
'body' => wp_json_encode([
|
|
651
|
+
'order_id' => $order->id,
|
|
652
|
+
'mollie_id' => $molliePayment->id,
|
|
653
|
+
'amount' => $molliePayment->amount->value,
|
|
654
|
+
'currency' => $molliePayment->amount->currency,
|
|
655
|
+
]),
|
|
656
|
+
]);
|
|
657
|
+
}, 10, 2);
|
|
658
|
+
```
|
|
659
|
+
|
|
660
|
+
### ` payment_failed (Mollie) `
|
|
661
|
+
|
|
662
|
+
`fluent_cart/payment_failed` Pro — Fires when a Mollie payment fails, is canceled, or expires
|
|
663
|
+
|
|
664
|
+
**When it runs:** This action fires inside the Mollie IPN handler when a payment is determined to have failed, been canceled, or expired. The order status and payment status are updated before this hook runs. Note that this is the same `fluent_cart/payment_failed` hook used by the base plugin for Airwallex; the Pro plugin adds Mollie as an additional source that fires it.
|
|
665
|
+
|
|
666
|
+
**Parameters:**
|
|
667
|
+
|
|
668
|
+
- `$data` (array): Payment failure data
|
|
669
|
+
|
|
670
|
+
```
|
|
671
|
+
$data = [
|
|
672
|
+
'order' => $order, // \FluentCart\App\Models\Order — with updated failed status
|
|
673
|
+
'transaction' => $transactionModel, // \FluentCart\App\Models\OrderTransaction
|
|
674
|
+
'old_payment_status' => $oldStatus, // string — previous payment status
|
|
675
|
+
'new_payment_status' => Status::PAYMENT_FAILED, // string — new payment status
|
|
676
|
+
'reason' => $reason, // string — 'failed', 'canceled', or 'expired'
|
|
677
|
+
];
|
|
678
|
+
```
|
|
679
|
+
|
|
680
|
+
**Source:** `fluent-cart-pro/app/Modules/PaymentMethods/MollieGateway/Webhook/MollieIPN.php`
|
|
681
|
+
|
|
682
|
+
**Usage:**
|
|
683
|
+
|
|
684
|
+
```
|
|
685
|
+
add_action('fluent_cart/payment_failed', function ($data) {
|
|
686
|
+
$order = $data['order'];
|
|
687
|
+
$transaction = $data['transaction'];
|
|
688
|
+
$oldStatus = $data['old_payment_status'];
|
|
689
|
+
$newStatus = $data['new_payment_status'];
|
|
690
|
+
$reason = $data['reason'];
|
|
691
|
+
|
|
692
|
+
// Notify admin about failed Mollie payment
|
|
693
|
+
if ($order->payment_method !== 'mollie') {
|
|
694
|
+
return; // Only handle Mollie failures in this callback
|
|
695
|
+
}
|
|
696
|
+
|
|
697
|
+
wp_mail(
|
|
698
|
+
get_option('admin_email'),
|
|
699
|
+
'Mollie Payment Failed - Order #' . $order->id,
|
|
700
|
+
sprintf(
|
|
701
|
+
"Payment for Order #%d has %s.\nPrevious status: %s\nNew status: %s\nTransaction ID: %s",
|
|
702
|
+
$order->id,
|
|
703
|
+
$reason,
|
|
704
|
+
$oldStatus,
|
|
705
|
+
$newStatus,
|
|
706
|
+
$transaction->id
|
|
707
|
+
)
|
|
708
|
+
);
|
|
709
|
+
}, 10, 1);
|
|
710
|
+
```
|
|
711
|
+
|
|
712
|
+
---
|
|
713
|
+
|
|
714
|
+
## Paddle Webhooks Pro
|
|
715
|
+
|
|
716
|
+
### ` paddle_webhook_received `
|
|
717
|
+
|
|
718
|
+
`fluent_cart/paddle_webhook_received` Pro — Fires when raw Paddle webhook data is received before processing
|
|
719
|
+
|
|
720
|
+
**When it runs:** This action fires early in Paddle webhook processing, after the event type has been extracted from the payload but before any event-specific handling occurs. Use this to log or inspect all incoming Paddle webhook payloads for debugging purposes.
|
|
721
|
+
|
|
722
|
+
**Parameters:**
|
|
723
|
+
|
|
724
|
+
- `$eventType` (string): The Paddle event type (e.g. `transaction.paid`, `subscription.created`)
|
|
725
|
+
- `$data` (array): The parsed webhook payload
|
|
726
|
+
- `$raw` (string): The raw POST body string
|
|
727
|
+
- `$order` ([Order](/database/models/order.md)|null): The associated Order model instance, or null if not yet resolved
|
|
728
|
+
|
|
729
|
+
**Source:** `fluent-cart-pro/app/Modules/PaymentMethods/PaddleGateway/Webhook/IPN.php`
|
|
730
|
+
|
|
731
|
+
**Usage:**
|
|
732
|
+
|
|
733
|
+
```
|
|
734
|
+
add_action('fluent_cart/paddle_webhook_received', function ($eventType, $data, $raw, $order) {
|
|
735
|
+
// Log all incoming Paddle webhooks for debugging
|
|
736
|
+
fluent_cart_add_log(
|
|
737
|
+
'Paddle Webhook Received',
|
|
738
|
+
sprintf(
|
|
739
|
+
'Event: %s | Order: %s | Payload size: %d bytes',
|
|
740
|
+
$eventType,
|
|
741
|
+
$order ? '#' . $order->id : 'N/A',
|
|
742
|
+
strlen($raw)
|
|
743
|
+
),
|
|
744
|
+
'info'
|
|
745
|
+
);
|
|
746
|
+
}, 10, 4);
|
|
747
|
+
```
|
|
748
|
+
|
|
749
|
+
### ` paddle/webhook_{$eventType} `
|
|
750
|
+
|
|
751
|
+
`fluent_cart/payments/paddle/webhook_{$eventType}` Pro — Fires for each Paddle webhook event
|
|
752
|
+
|
|
753
|
+
**When it runs:** This dynamic action fires during Paddle webhook (IPN) processing after the event has been received and the associated order has been resolved (if applicable). The `{$eventType}` is the Paddle event type with dots replaced by underscores (e.g. `transaction.paid` becomes `transaction_paid`). The webhook handler validates incoming events against a list of accepted event types before dispatching.
|
|
754
|
+
|
|
755
|
+
**Parameters:**
|
|
756
|
+
|
|
757
|
+
- `$eventType` (string): The Paddle event type with dots replaced by underscores
|
|
758
|
+
- `$data` (array): The parsed webhook payload
|
|
759
|
+
- `$raw` (string): The raw POST body string
|
|
760
|
+
- `$order` ([Order](/database/models/order.md)|null): The associated Order model instance, or null if not resolved
|
|
761
|
+
|
|
762
|
+
**Source:** `fluent-cart-pro/app/Modules/PaymentMethods/PaddleGateway/Webhook/IPN.php`
|
|
763
|
+
|
|
764
|
+
**Accepted events (dynamic variants):**
|
|
765
|
+
|
|
766
|
+
- `fluent_cart/payments/paddle/webhook_transaction_paid` -- transaction payment succeeded
|
|
767
|
+
- `fluent_cart/payments/paddle/webhook_transaction_completed` -- transaction fully completed
|
|
768
|
+
- `fluent_cart/payments/paddle/webhook_transaction_payment_failed` -- transaction payment failed
|
|
769
|
+
- `fluent_cart/payments/paddle/webhook_transaction_refunded` -- transaction refunded
|
|
770
|
+
- `fluent_cart/payments/paddle/webhook_adjustment_created` -- adjustment (refund/credit) created
|
|
771
|
+
- `fluent_cart/payments/paddle/webhook_adjustment_updated` -- adjustment updated
|
|
772
|
+
- `fluent_cart/payments/paddle/webhook_subscription_created` -- subscription created
|
|
773
|
+
- `fluent_cart/payments/paddle/webhook_subscription_activated` -- subscription activated
|
|
774
|
+
- `fluent_cart/payments/paddle/webhook_subscription_updated` -- subscription updated
|
|
775
|
+
- `fluent_cart/payments/paddle/webhook_subscription_canceled` -- subscription canceled
|
|
776
|
+
- `fluent_cart/payments/paddle/webhook_subscription_paused` -- subscription paused
|
|
777
|
+
- `fluent_cart/payments/paddle/webhook_subscription_resumed` -- subscription resumed
|
|
778
|
+
- `fluent_cart/payments/paddle/webhook_subscription_past_due` -- subscription past due
|
|
779
|
+
|
|
780
|
+
**Usage:**
|
|
781
|
+
|
|
782
|
+
```
|
|
783
|
+
add_action('fluent_cart/payments/paddle/webhook_transaction_paid', function ($eventType, $data, $raw, $order) {
|
|
784
|
+
if (!$order) {
|
|
785
|
+
return;
|
|
786
|
+
}
|
|
787
|
+
|
|
788
|
+
// Handle successful Paddle transaction payment
|
|
789
|
+
fluent_cart_add_log(
|
|
790
|
+
'Paddle Transaction Paid',
|
|
791
|
+
'Paddle payment completed for Order #' . $order->id,
|
|
792
|
+
'success'
|
|
793
|
+
);
|
|
794
|
+
}, 10, 4);
|
|
795
|
+
|
|
796
|
+
add_action('fluent_cart/payments/paddle/webhook_subscription_canceled', function ($eventType, $data, $raw, $order) {
|
|
797
|
+
if (!$order) {
|
|
798
|
+
return;
|
|
799
|
+
}
|
|
800
|
+
|
|
801
|
+
// Handle Paddle subscription cancellation
|
|
802
|
+
wp_mail(
|
|
803
|
+
get_option('admin_email'),
|
|
804
|
+
'Paddle Subscription Canceled - Order #' . $order->id,
|
|
805
|
+
'A Paddle subscription has been canceled. Event data: ' . wp_json_encode($data)
|
|
806
|
+
);
|
|
807
|
+
}, 10, 4);
|
|
808
|
+
|
|
809
|
+
add_action('fluent_cart/payments/paddle/webhook_transaction_refunded', function ($eventType, $data, $raw, $order) {
|
|
810
|
+
if (!$order) {
|
|
811
|
+
return;
|
|
812
|
+
}
|
|
813
|
+
|
|
814
|
+
// Track Paddle refund
|
|
815
|
+
fluent_cart_add_log(
|
|
816
|
+
'Paddle Refund',
|
|
817
|
+
'Paddle transaction refunded for Order #' . $order->id,
|
|
818
|
+
'warning'
|
|
819
|
+
);
|
|
820
|
+
}, 10, 4);
|
|
821
|
+
```
|
|
822
|
+
|
|
823
|
+
---
|
|
824
|
+
|
|
825
|
+
## Integrations
|
|
826
|
+
|
|
827
|
+
### ` register_integration_action `
|
|
828
|
+
|
|
829
|
+
`fluent_cart/register_integration_action` — Register custom integration actions during initialization
|
|
830
|
+
|
|
831
|
+
**When it runs:** This action fires during WordPress `init` to allow registration of custom integration actions. Use this hook to register your integration provider so it appears in the FluentCart integration action settings.
|
|
832
|
+
|
|
833
|
+
**Parameters:**
|
|
834
|
+
|
|
835
|
+
None.
|
|
836
|
+
|
|
837
|
+
**Source:** `app/Modules/IntegrationActions/GlobalIntegrationActionHandler.php`
|
|
838
|
+
|
|
839
|
+
**Usage:**
|
|
840
|
+
|
|
841
|
+
```
|
|
842
|
+
add_action('fluent_cart/register_integration_action', function () {
|
|
843
|
+
// Register a custom integration action provider
|
|
844
|
+
add_filter('fluent_cart/integration/get_global_integration_actions', function ($actions) {
|
|
845
|
+
$actions['my_crm'] = [
|
|
846
|
+
'title' => 'My CRM',
|
|
847
|
+
'logo' => plugin_dir_url(__FILE__) . 'logo.png',
|
|
848
|
+
'handler' => 'MyCrmIntegrationHandler',
|
|
849
|
+
];
|
|
850
|
+
return $actions;
|
|
851
|
+
});
|
|
852
|
+
}, 10, 0);
|
|
853
|
+
```
|
|
854
|
+
|
|
855
|
+
### ` authenticate_global_credentials_{$settingsKey} `
|
|
856
|
+
|
|
857
|
+
`fluent_cart/integration/authenticate_global_credentials_{$settingsKey}` — Verify integration credentials for a specific provider
|
|
858
|
+
|
|
859
|
+
**When it runs:** This dynamic action fires when a user clicks the "Verify" or "Authenticate" button for an integration's global credentials in the FluentCart admin settings. The `{$settingsKey}` is the integration provider's settings key (e.g. `mailchimp`, `activecampaign`). The handler is expected to validate the credentials and send a JSON response.
|
|
860
|
+
|
|
861
|
+
**Parameters:**
|
|
862
|
+
|
|
863
|
+
- `$data` (array): The settings key and integration configuration
|
|
864
|
+
|
|
865
|
+
```
|
|
866
|
+
$data = [
|
|
867
|
+
'settings_key' => $settingsKey, // Integration provider key (string)
|
|
868
|
+
'integration' => $integration, // Integration settings data (array, unslashed)
|
|
869
|
+
];
|
|
870
|
+
```
|
|
871
|
+
|
|
872
|
+
**Source:** `app/Modules/Integrations/GlobalIntegrationSettings.php`
|
|
873
|
+
|
|
874
|
+
**Usage:**
|
|
875
|
+
|
|
876
|
+
```
|
|
877
|
+
add_action('fluent_cart/integration/authenticate_global_credentials_my_crm', function ($data) {
|
|
878
|
+
$apiKey = $data['integration']['api_key'] ?? '';
|
|
879
|
+
|
|
880
|
+
// Verify the API key with the external service
|
|
881
|
+
$response = wp_remote_get('https://api.mycrm.com/verify', [
|
|
882
|
+
'headers' => ['Authorization' => 'Bearer ' . $apiKey],
|
|
883
|
+
]);
|
|
884
|
+
|
|
885
|
+
if (is_wp_error($response) || wp_remote_retrieve_response_code($response) !== 200) {
|
|
886
|
+
wp_send_json_error(['message' => 'Invalid API credentials.'], 400);
|
|
887
|
+
}
|
|
888
|
+
|
|
889
|
+
wp_send_json_success(['message' => 'Credentials verified successfully.']);
|
|
890
|
+
}, 10, 1);
|
|
891
|
+
```
|
|
892
|
+
|
|
893
|
+
### ` save_global_integration_settings_{$settingsKey} `
|
|
894
|
+
|
|
895
|
+
`fluent_cart/integration/save_global_integration_settings_{$settingsKey}` — Save integration settings for a specific provider
|
|
896
|
+
|
|
897
|
+
**When it runs:** This dynamic action fires when a user saves the global integration settings for a specific provider. The `{$settingsKey}` is the integration provider's settings key. The handler is expected to persist the settings and send a JSON response. If no handler catches this action, a fallback error message is returned.
|
|
898
|
+
|
|
899
|
+
**Parameters:**
|
|
900
|
+
|
|
901
|
+
- `$data` (array): The settings key and integration configuration
|
|
902
|
+
|
|
903
|
+
```
|
|
904
|
+
$data = [
|
|
905
|
+
'settings_key' => $settingsKey, // Integration provider key (string)
|
|
906
|
+
'integration' => $integration, // Integration settings data (array, unslashed)
|
|
907
|
+
];
|
|
908
|
+
```
|
|
909
|
+
|
|
910
|
+
**Source:** `app/Modules/Integrations/GlobalIntegrationSettings.php`
|
|
911
|
+
|
|
912
|
+
**Usage:**
|
|
913
|
+
|
|
914
|
+
```
|
|
915
|
+
add_action('fluent_cart/integration/save_global_integration_settings_my_crm', function ($data) {
|
|
916
|
+
$settings = $data['integration'];
|
|
917
|
+
|
|
918
|
+
// Persist integration settings
|
|
919
|
+
fluent_cart_update_option('my_crm_settings', $settings);
|
|
920
|
+
|
|
921
|
+
wp_send_json_success([
|
|
922
|
+
'message' => 'Settings saved successfully.',
|
|
923
|
+
]);
|
|
924
|
+
}, 10, 1);
|
|
925
|
+
```
|
|
926
|
+
|
|
927
|
+
### ` integration/chained_{$route} `
|
|
928
|
+
|
|
929
|
+
`fluent_cart/integration/chained_{$route}` — Fires for chained data requests in cascading dropdowns
|
|
930
|
+
|
|
931
|
+
**When it runs:** This dynamic action fires when the integration settings UI requests chained/dependent data for cascading dropdown fields. For example, after selecting a mailing list, this hook loads the available tags or groups for that list. The `{$route}` is the integration's route identifier.
|
|
932
|
+
|
|
933
|
+
**Parameters:**
|
|
934
|
+
|
|
935
|
+
- `$data` (array): The request data for the chained lookup
|
|
936
|
+
|
|
937
|
+
```
|
|
938
|
+
$data = [
|
|
939
|
+
'data' => $requestData, // Request data array (contains route, selected values, etc.)
|
|
940
|
+
];
|
|
941
|
+
```
|
|
942
|
+
|
|
943
|
+
**Source:** `app/Modules/Integrations/GlobalIntegrationSettings.php`
|
|
944
|
+
|
|
945
|
+
**Usage:**
|
|
946
|
+
|
|
947
|
+
```
|
|
948
|
+
add_action('fluent_cart/integration/chained_my_crm', function ($data) {
|
|
949
|
+
$requestData = $data['data'];
|
|
950
|
+
$listId = $requestData['list_id'] ?? '';
|
|
951
|
+
|
|
952
|
+
// Fetch tags for the selected list
|
|
953
|
+
$tags = my_crm_get_tags($listId);
|
|
954
|
+
|
|
955
|
+
wp_send_json_success([
|
|
956
|
+
'tags' => $tags,
|
|
957
|
+
]);
|
|
958
|
+
}, 10, 1);
|
|
959
|
+
```
|
|
960
|
+
|
|
961
|
+
### ` integration/run/{$provider} `
|
|
962
|
+
|
|
963
|
+
`fluent_cart/integration/run/{$provider}` — Execute a specific integration feed for a provider
|
|
964
|
+
|
|
965
|
+
**When it runs:** This dynamic action fires when an integration feed needs to be executed for a specific provider, both in real-time (synchronous) and async (via scheduled actions) processing. The `{$provider}` is the integration provider's slug (e.g. `mailchimp`, `activecampaign`). It runs within a try/catch block, and errors are logged to the [Order](/database/models/order.md)'s activity log.
|
|
966
|
+
|
|
967
|
+
**Parameters:**
|
|
968
|
+
|
|
969
|
+
- `$integrationArray` (array): The full integration feed configuration and context
|
|
970
|
+
|
|
971
|
+
```
|
|
972
|
+
$integrationArray = [
|
|
973
|
+
'provider' => 'mailchimp', // Integration provider slug
|
|
974
|
+
'order' => $order, // Order model instance
|
|
975
|
+
'event_data' => $data, // Event trigger data (may include subscription)
|
|
976
|
+
'feed' => [], // Feed configuration array
|
|
977
|
+
// ... additional feed configuration fields
|
|
978
|
+
];
|
|
979
|
+
```
|
|
980
|
+
|
|
981
|
+
**Source:** `app/Listeners/IntegrationEventListener.php`
|
|
982
|
+
|
|
983
|
+
**Usage:**
|
|
984
|
+
|
|
985
|
+
```
|
|
986
|
+
add_action('fluent_cart/integration/run/my_crm', function ($integrationArray) {
|
|
987
|
+
$order = $integrationArray['order'];
|
|
988
|
+
$feed = $integrationArray['feed'] ?? [];
|
|
989
|
+
$customer = $order->customer;
|
|
990
|
+
|
|
991
|
+
// Push customer data to your CRM
|
|
992
|
+
wp_remote_post('https://api.mycrm.com/contacts', [
|
|
993
|
+
'headers' => [
|
|
994
|
+
'Authorization' => 'Bearer ' . fluent_cart_get_option('my_crm_api_key'),
|
|
995
|
+
'Content-Type' => 'application/json',
|
|
996
|
+
],
|
|
997
|
+
'body' => wp_json_encode([
|
|
998
|
+
'email' => $customer->email,
|
|
999
|
+
'name' => $customer->full_name,
|
|
1000
|
+
'tags' => $feed['tags'] ?? [],
|
|
1001
|
+
]),
|
|
1002
|
+
]);
|
|
1003
|
+
}, 10, 1);
|
|
1004
|
+
```
|
|
1005
|
+
|
|
1006
|
+
### ` integration/integration_notify_{$feedKey} `
|
|
1007
|
+
|
|
1008
|
+
`fluent_cart/integration/integration_notify_{$feedKey}` — Synchronous notify-style integration feed execution
|
|
1009
|
+
|
|
1010
|
+
**When it runs:** This dynamic action fires inside `GlobalNotificationHandler` when a notify-style integration feed is run synchronously (as opposed to being scheduled asynchronously via `fluent_cart/integration/schedule_feed`). The `{$feedKey}` is the integration feed's unique key.
|
|
1011
|
+
|
|
1012
|
+
**Parameters:**
|
|
1013
|
+
|
|
1014
|
+
- `$feed` (array): The feed configuration
|
|
1015
|
+
- `$order` ([Order](/database/models/order.md)): The Order model instance
|
|
1016
|
+
- `$customer` ([Customer](/database/models/customer.md)): The Customer model instance
|
|
1017
|
+
|
|
1018
|
+
**Source:** `app/Modules/Integrations/GlobalNotificationHandler.php:109`
|
|
1019
|
+
|
|
1020
|
+
**Usage:**
|
|
1021
|
+
|
|
1022
|
+
```
|
|
1023
|
+
add_action('fluent_cart/integration/integration_notify_my_webhook', function ($feed, $order, $customer) {
|
|
1024
|
+
wp_remote_post($feed['webhook_url'], [
|
|
1025
|
+
'body' => wp_json_encode([
|
|
1026
|
+
'order_id' => $order->id,
|
|
1027
|
+
'email' => $customer->email,
|
|
1028
|
+
]),
|
|
1029
|
+
]);
|
|
1030
|
+
}, 10, 3);
|
|
1031
|
+
```
|
|
1032
|
+
|
|
1033
|
+
### ` global_notify_completed `
|
|
1034
|
+
|
|
1035
|
+
`fluent_cart/integrations/global_notify_completed` — Fires after all synchronous global notification feeds have completed
|
|
1036
|
+
|
|
1037
|
+
**When it runs:** This action fires after all sync (non-async) global notification integration feeds have been processed for an order. It does not fire if there are async feeds still pending.
|
|
1038
|
+
|
|
1039
|
+
**Parameters:**
|
|
1040
|
+
|
|
1041
|
+
- `$order` ([Order](/database/models/order.md)): The Order model instance
|
|
1042
|
+
- `$feeds` (array): Array of feed configurations that were processed
|
|
1043
|
+
|
|
1044
|
+
**Source:** `app/Modules/Integrations/GlobalNotificationHandler.php`
|
|
1045
|
+
|
|
1046
|
+
**Usage:**
|
|
1047
|
+
|
|
1048
|
+
```
|
|
1049
|
+
add_action('fluent_cart/integrations/global_notify_completed', function ($order, $feeds) {
|
|
1050
|
+
// All sync integrations are done for this order
|
|
1051
|
+
fluent_cart_add_log(
|
|
1052
|
+
'Integrations Complete',
|
|
1053
|
+
count($feeds) . ' integration feeds processed for Order #' . $order->id,
|
|
1054
|
+
'info'
|
|
1055
|
+
);
|
|
1056
|
+
}, 10, 2);
|
|
1057
|
+
```
|
|
1058
|
+
|
|
1059
|
+
### ` reindex_integration_feeds `
|
|
1060
|
+
|
|
1061
|
+
`fluent_cart/reindex_integration_feeds` — Fires when integration feeds need to be re-indexed
|
|
1062
|
+
|
|
1063
|
+
**When it runs:** This action fires after integration feed configurations are saved or updated, both at the global level (via `IntegrationController`) and at the product level (via `ProductIntegrationsController`). It signals that the cached integration feed index should be rebuilt.
|
|
1064
|
+
|
|
1065
|
+
**Parameters:**
|
|
1066
|
+
|
|
1067
|
+
- `$data` (array): Empty array
|
|
1068
|
+
|
|
1069
|
+
```
|
|
1070
|
+
$data = []; // No data passed
|
|
1071
|
+
```
|
|
1072
|
+
|
|
1073
|
+
**Source:** `app/Http/Controllers/IntegrationController.php`, `app/Http/Controllers/ProductIntegrationsController.php`
|
|
1074
|
+
|
|
1075
|
+
**Usage:**
|
|
1076
|
+
|
|
1077
|
+
```
|
|
1078
|
+
add_action('fluent_cart/reindex_integration_feeds', function ($data) {
|
|
1079
|
+
// Clear any cached integration feed data
|
|
1080
|
+
delete_transient('my_plugin_integration_cache');
|
|
1081
|
+
}, 10, 1);
|
|
1082
|
+
```
|
|
1083
|
+
|
|
1084
|
+
---
|
|
1085
|
+
|
|
1086
|
+
## Storage Drivers
|
|
1087
|
+
|
|
1088
|
+
### ` register_storage_drivers `
|
|
1089
|
+
|
|
1090
|
+
`fluent_cart/register_storage_drivers` — Register custom file storage drivers
|
|
1091
|
+
|
|
1092
|
+
**When it runs:** This action fires during WordPress `init` at priority 9, after the built-in Local and S3 storage drivers have been initialized. Use this hook to register a custom file storage driver (e.g. Google Cloud Storage, Azure Blob Storage) for digital product file delivery.
|
|
1093
|
+
|
|
1094
|
+
**Parameters:**
|
|
1095
|
+
|
|
1096
|
+
None.
|
|
1097
|
+
|
|
1098
|
+
**Source:** `app/Hooks/Handlers/GlobalStorageHandler.php`
|
|
1099
|
+
|
|
1100
|
+
**Usage:**
|
|
1101
|
+
|
|
1102
|
+
```
|
|
1103
|
+
add_action('fluent_cart/register_storage_drivers', function () {
|
|
1104
|
+
// Register a custom storage driver
|
|
1105
|
+
add_filter('fluent_cart/storage_drivers', function ($drivers) {
|
|
1106
|
+
$drivers['gcs'] = [
|
|
1107
|
+
'title' => 'Google Cloud Storage',
|
|
1108
|
+
'handler' => new MyGcsStorageDriver(),
|
|
1109
|
+
];
|
|
1110
|
+
return $drivers;
|
|
1111
|
+
});
|
|
1112
|
+
}, 10, 0);
|
|
1113
|
+
```
|
|
1114
|
+
|
|
1115
|
+
---
|
|
1116
|
+
|
|
1117
|
+
## Development Logging
|
|
1118
|
+
|
|
1119
|
+
### ` dev_log `
|
|
1120
|
+
|
|
1121
|
+
`fluent_cart/dev_log` — Fires for development and debug logging (requires FLUENT_CART_DEV_MODE)
|
|
1122
|
+
|
|
1123
|
+
**When it runs:** This action fires at various points during payment gateway webhook processing (primarily in the PayPal IPN handler) when the `FLUENT_CART_DEV_MODE` constant is defined. It provides detailed diagnostic data for debugging webhook failures, signature verification issues, and missing transaction references. There are 8+ call sites in the PayPal IPN handler alone.
|
|
1124
|
+
|
|
1125
|
+
**Parameters:**
|
|
1126
|
+
|
|
1127
|
+
- `$data` (array): Logging context with raw data and metadata
|
|
1128
|
+
|
|
1129
|
+
```
|
|
1130
|
+
$data = [
|
|
1131
|
+
'raw_data' => $rawData, // Raw webhook payload or resource data (mixed)
|
|
1132
|
+
'status' => 'failed', // Log status: 'failed', 'received', etc.
|
|
1133
|
+
'title' => 'Log title', // Human-readable log title (string)
|
|
1134
|
+
'log_type' => 'webhook', // Type of log entry (string)
|
|
1135
|
+
'module_type' => 'paypal_ipn', // Module identifier (string)
|
|
1136
|
+
'module_name' => 'PayPal', // Display name of the module (string)
|
|
1137
|
+
];
|
|
1138
|
+
```
|
|
1139
|
+
|
|
1140
|
+
**Source:** `app/Modules/PaymentMethods/PayPalGateway/IPN.php` (multiple call sites)
|
|
1141
|
+
|
|
1142
|
+
**Usage:**
|
|
1143
|
+
|
|
1144
|
+
```
|
|
1145
|
+
// First, define the constant in wp-config.php:
|
|
1146
|
+
// define('FLUENT_CART_DEV_MODE', true);
|
|
1147
|
+
|
|
1148
|
+
add_action('fluent_cart/dev_log', function ($data) {
|
|
1149
|
+
// Write detailed logs to a custom file
|
|
1150
|
+
$logEntry = sprintf(
|
|
1151
|
+
"[%s] [%s] %s - %s\n%s\n\n",
|
|
1152
|
+
gmdate('Y-m-d H:i:s'),
|
|
1153
|
+
$data['status'] ?? 'unknown',
|
|
1154
|
+
$data['module_name'] ?? 'General',
|
|
1155
|
+
$data['title'] ?? 'No title',
|
|
1156
|
+
wp_json_encode($data['raw_data'] ?? [], JSON_PRETTY_PRINT)
|
|
1157
|
+
);
|
|
1158
|
+
|
|
1159
|
+
error_log($logEntry, 3, WP_CONTENT_DIR . '/fluent-cart-debug.log');
|
|
1160
|
+
}, 10, 1);
|
|
1161
|
+
```
|
|
1162
|
+
|
|
1163
|
+
---
|