WooCommerce Integration Guide – Paystand Help Center

Overview

The PayStand WooCommerce Payment Gateway Plugin allows merchants to accept payments directly on their WordPress/WooCommerce storefront. Customers can pay via credit/debit card, ACH bank transfer, or eCheck (bank session) — all through the PayStand checkout widget embedded in your WooCommerce checkout page.

Prerequisites

WordPress 5.0+ with WooCommerce 3.x or higher installed and active
A PayStand merchant account
Your PayStand Publishable Key (found in the PayStand Dashboard under Settings > API Keys)
PHP 7.2+

2. Installing the Plugin

Once you receive the plugin package:

Log into your WordPress Admin dashboard
Go to Plugins > Add New > Upload Plugin
Upload the PayStand WooCommerce plugin .zip file
Click Install Now, then Activate

3. Configuring the Plugin

Navigate to WooCommerce > Settings > Payments and click PayStand to configure.

3.1 Enable/Disable

Setting	Description
Enable PayStand	Check to enable PayStand as a payment method at checkout

3.2 Environment

Setting	Values	Description
Environment	`Sandbox` / `Live`	Use Sandbox for testing, Live for production. Sandbox points to `checkout.paystand.co` and `api.paystand.co`; Live points to `checkout.paystand.com` and `api.paystand.com`

3.3 Types of Funds to Show (Payment Methods)

This is one of the most important settings. It controls which payment methods your customers see at checkout.

Setting	Description
View Funds	Comma-separated list of payment methods to display

Available Values

Value	Payment Method	Description
`card`	Credit/Debit Card	Visa, Mastercard, Amex, Discover
`ach`	Manual ACH	Customer enters bank routing and account number manually
`echeck` or `bank`	eCheck / Bank Session	Customer connects their bank via secure OAuth session (Plaid) — no manual entry required
`wire`	Wire Transfer	Wire transfer instructions
`achPush`	ACH Push	ACH push payment

Configuration Examples

Configuration	What the Customer Sees
`card,ach,echeck`	All three payment tabs: Card, ACH, and Bank
`card`	Card payments only
`card,ach`	Card and manual ACH only (no bank session)
`echeck,card`	Bank session first, then Card (order matters — first value is the default tab)
(empty / default)	Shows all payment methods enabled on the merchant's plan

The order you list the values determines the tab display order in the checkout. The first value becomes the default selected tab.

3.4 Checkout Display Mode

Setting	Values	Description
Mode	`modal` / `embed`	Modal: Checkout opens as a popup overlay when the customer clicks "Pay". Embed: Checkout is rendered inline on the checkout page

3.5 Fees and Incentives (Optional)

If your PayStand plan includes fee split or payment incentive configurations:

Setting	Description
Preset URL Key	The Fees and Incentives URL key from your PayStand Dashboard. Found under Settings > Checkout Settings > Checkout Presets

This allows you to pass merchant-specific fee configurations (e.g., surcharging for card, discounting for ACH) to the checkout widget.

3.6 Branding (Optional)

Setting	Description
Logo URL	URL to your custom logo image displayed in the checkout
Preset Name	Custom preset name if configured in PayStand
External CSS URL	URL to a custom CSS file for checkout styling

4. Payment Flow

Customer adds items to cart
Proceeds to WooCommerce checkout
Selects "PayStand" as payment method
PayStand checkout widget loads (card/ACH/bank tabs based on viewFunds config)
Customer enters payment details and submits
PayStand processes the payment via the configured processor
Payment result returned to WooCommerce
WooCommerce order status updated (Completed / Failed)
PayStand sends webhook notification for payment lifecycle events

5. Webhook Configuration

Webhooks allow PayStand to notify your WooCommerce store when payment events occur (e.g., payment posted, payment failed).

Setting Up Webhooks

In the PayStand Dashboard, go to Settings > Webhooks
Add a new webhook URL pointing to your WooCommerce store:

https://your-store-domain.com/wc-api/paystand_webhook

Webhook Retry Policy

PayStand retries failed webhook deliveries up to 7 times with exponential backoff
If your endpoint returns a 404, retries are limited to 3 attempts

6. Testing in Sandbox

Before going live, test the integration using Sandbox mode:

Set Environment to Sandbox in the WooCommerce PayStand settings
Use your Sandbox publishable key (different from your Live key)
Place test orders on your WooCommerce store
Verify payments appear in the PayStand Dashboard (Sandbox environment)

Sandbox Test Data

Payment Method	Test Details
Card	Use Visa `4242 0000 0000 0077`, any future expiry, any CVV
ACH	Use routing `110000000`, account `000123456789`
eCheck/Bank	Use sandbox credentials (user: `paystand_test`, pass: `paystand_good`)

7. Going Live

When you are ready for production:

Change Environment from Sandbox to Live
Replace the Sandbox publishable key with your Live publishable key
Update your webhook URL if using a different endpoint for production
Place a small real transaction to confirm everything works end to end
Verify the payment appears in the PayStand Dashboard (Live environment)

8. Full Checkout Attribute Reference

The WooCommerce plugin configures the PayStand checkout widget using these attributes. Most are set automatically by the plugin, but understanding them helps with troubleshooting.

Core Attributes

Attribute	Required	Description	Example
`ps-publishableKey`	Yes	Your PayStand publishable API key	`abc123...`
`ps-env`	Yes	Environment: `sandbox` or `live`	`live`
`ps-mode`	No	Display mode: `modal` or `embed`	`embed`
`ps-paymentSource`	No	Integration source identifier	`woocommerce`

Payment Attributes

Attribute	Description	Example
`ps-paymentAmount`	Order total amount	`149.99`
`ps-paymentCurrency`	Currency code	`USD`
`ps-fixedAmount`	Lock the amount (non-editable)	`true`
`ps-paymentDescription`	Payment description	`Order #1234`
`ps-paymentExtId`	External ID (WooCommerce order ID)	`wc_order_abc123`

Fund / Payment Method Attributes

Attribute	Description	Values
`ps-viewFunds`	Which payment methods to show	`card,ach,echeck`

Payer Pre-fill Attributes

These are populated automatically from the WooCommerce billing details:

Attribute	Description
`ps-payerName`	Billing name
`ps-payerEmail`	Billing email
`ps-payerAddress-street`	Billing street
`ps-payerAddress-city`	Billing city
`ps-payerAddress-postal`	Billing zip/postal
`ps-payerAddress-state`	Billing state
`ps-payerAddress-country`	Billing country

Fee / Incentive Attributes

Attribute	Description
`ps-feesIncentivesUrlKey`	Preset key for fees and incentives

9. Troubleshooting

Issue	Solution

Issue	Solution
Checkout widget not loading	Verify `publishableKey` is correct and matches the selected environment (Sandbox vs Live)
No payment methods showing	Check the `viewFunds` configuration — leave empty for defaults, or specify valid values (`card`, `ach`, `echeck`)
Payment succeeds but WooCommerce order not updated	Verify webhook URL is correctly configured in the PayStand Dashboard and is reachable from the internet
Webhook not received	Check that your server is not blocking incoming POST requests from PayStand IPs. Review webhook delivery logs in the PayStand Dashboard
CSS/styling conflicts	Use the `External CSS URL` setting to provide custom styles, or add the PayStand checkout container to your theme CSS scope

PrevNext

WooCommerce Integration Guide