CartThrob Payment Plugins Edit Cartthrob Paypal Advanced

This page configures payment gateways and their settings for processing checkout payments.

Fields

Enabled

Checkout uses this plugin only when Yes.

Sandbox Client Id

Stores the PayPal sandbox client ID used while testing checkout.

Sandbox Secret

Stores the PayPal sandbox secret used to authenticate test API requests.

Client Id

Stores the live PayPal client ID used for production checkout.

Secret

Stores the live PayPal secret used to authenticate production API requests.

Mode

Selects whether this gateway uses test/sandbox credentials or live production credentials.

Available options are Sandbox, Live.

Gateway Fields Template

EE template used by {gateway_fields} and {selected_gateway_fields}.

When configured, this template replaces CartThrob’s complete default gateway output. It must include every required customer field and PayPal integration element. Do not render the custom output together with duplicate inputs using the same names or IDs. See Gateway-generated fields and inline errors.

Checkout Form Markup

Settings summary

Read-only view of saved plugin values. Edit in the form above.

Checkout behavior

PayPal Advanced creates the PayPal order in CartThrob’s configured store currency. CartThrob keeps the PayPal order ID as transaction_id and stores the completed capture ID separately as payment_capture_id when available. These identify different stages of the payment; retain both for investigation.

For ordinary, non-subscription checkout, the built-in integration supports CartThrob’s finalized checkout quote. If address data, a coupon, or a supported checkout_form amount parameter changes the amount, CartThrob creates the PayPal order from the recalculated total. Optional purchaser review is controlled by price_change_handling; omitting it uses the silent none default. Do not assume this contract applies to custom PayPal JavaScript or subscription checkout. See Checkout Amounts and Payment Review.

Payments requiring reconciliation

In CartThrob 10, supported ordinary checkouts can be held as Processing when collection is confirmed but the order needs review, or the capture outcome is uncertain.

The ordinary charge path records a capture attempt before sending it to PayPal, including both quoted and legacy checkout. It verifies the completed capture and retains the order/capture references when available.

Verify the original capture, amount, and currency in PayPal before another payment attempt. For an eligible saved order, Complete paid order — no charge finishes supported local checkout work and creates missing configured Purchased Item entries. A refund, cancellation, or unpaid finding uses a record-only resolution. Perform refunds in PayPal first; the resolution buttons do not refund or charge money. Recurring-payment and missing-recovery-data cases require separate manual handling. See gateway coverage.

Refunds

CartThrob does not issue PayPal Advanced refunds through Order Manager. Complete the refund in PayPal. If an Order Manager refund is attempted, CartThrob returns an actionable message instead of calling the removed legacy refund path.