Configuration

php artisan ecommerce-paypal:install publishes the config to config/artisanpack/ecommerce-paypal.php. You can also publish it with php artisan vendor:publish --tag=ecommerce-paypal-config. It loads under the runtime key artisanpack.ecommerce-paypal:

config( 'artisanpack.ecommerce-paypal.methods.card.enabled' ); // false

Every key has a default, so you only need the keys you change. Most keys are also store settings the admin can change without touching config; a value saved there overrides the config value.

Core

Payment methods

Each method is its own checkout choice and its own gateway. See Payment Methods.

Pay Later messaging

Where PayPal's Pay Later messages may render. They also need the paypal method and its pay_later option on. See Pay Later Messaging.

Vault

HTTP

Logging

Intent: capture or authorize

The engine's fraud check runs on the approved session before capturePayment() is called, in both intents, so a blocked payment is never captured; an approved Order that is never captured expires at PayPal on its own. In this release, authorize still captures in the same finalize step once the authorization succeeds. An authorization stays open only when its capture doesn't complete then: PayPal returned it as PENDING, or the capture failed with a retryable error and the order was left pending for a retry.

Honor period. PayPal guarantees an authorization's funds for 3 days and keeps it valid for 29. For authorizations left open, ecommerce-paypal:authorizations:reauthorize runs daily (scheduled by the package, withoutOverlapping()):

• once the 3-day honor period is over, it reauthorizes the authorization once (PayPal allows one reauthorization) while it is still valid, and adds an order note;
• 2 days before the authorization expires, it fires ap.ecommerce.paypal.authorizationExpiring (Order $order, CarbonImmutable $expiresAt) once, so you can capture it or contact the shopper.

Progress is kept on orders.meta.paypal.authorization (reauthorized_at, expiry_notified_at), so running the command twice on the same day changes nothing. It exits non-zero when a reauthorization fails, and does nothing while PayPal is disabled. Make sure the Laravel scheduler runs.

Store settings

The package adds a PayPal group to the engine's settings registry (shown on the admin-livewire settings screen). Each setting overlays its config key, so a saved value wins over the config file and the environment.

Config-only keys (no setting): webhook_verification, webhook_tolerance_seconds, methods.paypal.button, methods.card.three_d_secure, methods.card.require_liability_shift, methods.apple_pay.serve_domain_association, vault.prune_after_days, http.*, and logging.*.

Secrets. client_secret (PAYPAL_CLIENT_SECRET) and webhook_id (PAYPAL_WEBHOOK_ID) are registered as setting secrets: the screen shows whether each is configured, and never shows, returns, or stores the value. Set them in the environment.

Validation. A paypal constraint runs on the combined settings before every save and refuses:

Per-method enablement

Every gateway in the family is registered while PayPal is enabled, even a method that is switched off, so orders already paid with it can still be refunded and reconciled. Switched-off methods are hidden from checkout by the availability filter. A method is offered for a cart only when:

• its methods.*.enabled is on;
• PayPal accepts the cart's currency for that method;
• the cart total is above zero in PayPal's units;
• the cart total is a whole amount in PayPal's units (see HUF and TWD).

Device and buyer eligibility (Apple Pay on Apple devices, Google Pay readiness, Venmo and Pay Later by buyer country) is decided by PayPal's SDK in the browser; an ineligible method hides itself. See Availability.

Supported currencies

HUF, JPY, and TWD are sent to PayPal without decimals. Change any list with the ap.ecommerce.paypal.supportedCurrencies filter.

HUF and TWD

The engine stores HUF and TWD in hundredths, but PayPal only takes whole forints and New Taiwan dollars. A cart whose total has a fraction (for example 1234.50 HUF, which 27% VAT easily produces) isn't offered any PayPal method, because PayPal would charge a rounded amount the checkout could never finalize against. Refunds of a HUF or TWD amount with a fraction fail with amount_not_representable. Round your HUF and TWD prices, taxes, and shipping so totals come out whole if you sell in them. JPY is stored in whole yen, so it is unaffected.