WooCommerce Plugin

Accept payments on your WordPress/WooCommerce store in under 30 minutes using the Payments Central redirect-based payment flow.

How it works The WooCommerce plugin uses the POST /api/v1/transactions/redirect endpoint to create a hosted payment session. Customers are redirected to the Payments Central checkout page and returned to your store after payment.

Requirements

Installation

Option A — WordPress plugin directory (recommended)

  1. In your WordPress admin go to Plugins → Add New
  2. Search for Payments Central
  3. Click Install Now then Activate

Option B — Manual installation

  1. Download the plugin ZIP from core.payments-central.com/plugins/woocommerce
  2. In WordPress admin go to Plugins → Add New → Upload Plugin
  3. Upload the ZIP and activate

Configuration

  1. Go to WooCommerce → Settings → Payments
  2. Find Payments Central and click Manage
  3. Enable the gateway by checking Enable Payments Central
  4. Set the Title shown to customers (e.g. Pay securely)
  5. Paste your API key:
    • Use a pc_test_ key while testing
    • Switch to a pc_live_ key when ready for real payments
  6. Click Save changes

Webhook configuration

The plugin needs webhooks to update order status after payment. Set up a webhook endpoint:

  1. Copy your store's webhook URL: https://yourstore.com/?wc-api=payments_central
  2. In your Payments Central dashboard go to Settings → Webhooks → Add endpoint
  3. Paste the webhook URL
  4. Subscribe to: transaction.captured, transaction.failed, transaction.refunded
  5. Copy the signing secret back into the plugin settings: Webhook Secret

Testing the integration

  1. Ensure your API key is a test key (pc_test_)
  2. Place a test order on your store
  3. You should be redirected to the Payments Central sandbox checkout
  4. Use test card number 4242 4242 4242 4242, any future expiry, any CVC
  5. After payment, you should be returned to your store's order confirmation page
  6. Check WooCommerce → Orders — the order status should change to Processing
Test card numbers In sandbox mode, use 4242 4242 4242 4242 to simulate a successful payment. Use 4000 0000 0000 0002 to simulate a decline.

How the payment flow works

1

Customer places order

Customer clicks "Place order" on WooCommerce checkout.

2

Plugin creates redirect session

The plugin calls POST /api/v1/transactions/redirect with the order amount and return URLs.

3

Customer completes payment

Customer is redirected to the Payments Central hosted checkout page and enters card details.

4

Webhook confirms payment

Payments Central sends a transaction.captured webhook to your store. The plugin updates the WooCommerce order status to Processing.

5

Customer lands on confirmation page

Customer is redirected to your store's order-received page. The order is complete.

Refunds

You can issue refunds directly from WooCommerce:

  1. Go to WooCommerce → Orders and open the order
  2. Click Refund
  3. Enter the refund amount and reason
  4. Click Refund via Payments Central

The plugin calls the Payments Central API and the refund is processed against the original gateway.

Troubleshooting

IssueSolution
Orders stuck in "Pending payment" Check that your webhook URL is reachable and the signing secret matches
Gateway not appearing at checkout Verify the gateway is enabled in WooCommerce → Settings → Payments
API key error in settings Ensure the key is for the correct environment (test vs live)
Redirect loop after payment Check that your return_url is an HTTPS URL on your store