Skip to main content
Version: Divi 5

Payment settings

Overview​

Payment settings are global plugin-level settings for payment behavior. Use them to choose enabled gateways, define currency formatting, manage test/live credentials for Stripe and PayPal, and validate gateway setup before launch.

Where to find these settings​

  1. In WordPress admin, go to Divi Engine -> Form Builder Settings.
  2. Open Settings.
  3. Select Payment.
  4. Use tabs:
    • General
    • PayPal
    • Stripe

General tab settings​

Currency Selection​

  • Sets the default transaction currency for form payments.

Amount Separator​

  • Defines the separator symbol used for payment amount formatting.

Amount Decimal Point​

  • Defines the decimal symbol for payment amount display.

Statement Descriptor​

  • Sets text shown on bank/card statements where supported by the gateway.

Gateway enable toggles​

Enable PayPal​

  • Turns PayPal on as an available payment option for forms.
  • You still need valid credentials and per-form payment setup in the module.

Enable Stripe​

  • Turns Stripe on as an available payment option for forms.
  • You still need valid credentials and per-form payment setup in the module.

PayPal tab settings​

Test Mode​

  • On: Uses PayPal sandbox credentials.
    • PayPal Test Client ID
    • PayPal Test Secret
  • Off: Uses live credentials.
    • PayPal Live Client ID
    • PayPal Live Secret

Validate Payment Gateway API Keys button​

  • Button states:
    • Validating...
    • Success! ...
    • Failed! ...
  • Expected behavior: validates currently selected PayPal mode credentials.
  • Important: save settings before running validation.

Stripe tab settings​

Test Mode​

  • On: Uses Stripe test credentials.
    • Stripe Publishable Test Key
    • Stripe Secret Test Key
  • Off: Uses live credentials.
    • Stripe Publishable Live Key
    • Stripe Secret Live Key

Validate Payment Gateway API Keys button​

  • Button states:
    • Validating...
    • Success! ...
    • Failed! ...
  • Expected behavior: validates currently selected Stripe mode credentials.
  • Important: save settings before running validation.

Stripe payment error message settings​

You can customize customer-facing messages for common Stripe failures:

  • Declined Card (card_declined)
  • Expired Card (expired_card)
  • Incorrect CVC (incorrect_cvc)
  • Processing Error (processing_error)
  • Incorrect Number (incorrect_number)
  • Invalid Expiry Month (invalid_expiry_month)
  • Invalid Expiry Year (invalid_expiry_year)

Use clear, non-technical language so customers know what action to take.

Test/live mode behavior checklist​

  1. For setup and QA, enable Test Mode and use sandbox/test credentials.
  2. Save settings, then validate credentials with the button.
  3. Complete at least one successful test transaction.
  4. Before launch, switch to live credentials and disable Test Mode.
  5. Save, revalidate, and run a low-value live transaction check.

Verify your configuration​

  1. Confirm both enabled gateways show success on validation.
  2. Confirm your form can process a payment in the chosen gateway mode.
  3. Confirm the correct statement descriptor and amount formatting are shown.
  4. Confirm custom Stripe error text appears when forcing a known test failure.

Common issues​

  • Validation fails in test mode: Test mode is on, but live credentials were entered (or vice versa).
  • Gateway does not appear in form: Gateway is enabled globally, but not configured at form level.
  • Unexpected failure text: Verify your Stripe custom error messages are saved and not empty.
  • Live payments fail after launch: Recheck that test mode is off and live credentials are active.

What's Next​