WooCommerce Plugin - Accept Payments on WordPress

Prerequisites

• WordPress 6.0+
• WooCommerce 8.0+
• PHP 8.2+
• An Pycer instance with a valid API key
• Pycer Gateway Plugin for WooCommerce - download from GitHub Releases

How it works

Customer Checkout
       |
       v
 WooCommerce Order Created
       |
       v
 Pycer Plugin -> POST /api/v1/payment-intents
       |
       v
 Customer Redirected -> Pycer Checkout Page
       |
       v
 Payment Completed / Failed
       |
       v
 Pycer Webhook -> WooCommerce Order Status Updated

Installation

Step 1: Install the plugin

1. Download the latest plugin ZIP from GitHub Releases
2. Go to WordPress Admin > Plugins > Add New > Upload Plugin
3. Upload the ZIP and click Install Now
4. Click Activate Plugin

wp plugin install pycer-woocommerce --activate

Step 2: Configure the gateway

1. Go to WooCommerce > Settings > Payments
2. Find Pycer and click Manage
3. Fill in:

4. Click Save Changes

Step 3: Configure webhooks in Pycer

1. Log in to your Pycer Admin panel
2. Go to Developer Hub > Webhooks
3. Add a new webhook endpoint:

https://yourstore.com/?wc-api=pycer_gateway

4. Select events: payment.transaction.completed, payment.transaction.failed, payment.transaction.cancelled
5. Copy the Webhook Secret and paste it into WooCommerce plugin settings

Order status mapping

Customization

Change redirect behavior

add_filter('pycer_redirect_url', function (string $url, \WC_Order $order): string {
    return add_query_arg('ref', $order->get_order_key(), $url);
}, 10, 2);

Customize payment intent payload

add_filter('pycer_payment_intent_payload', function (array $payload, \WC_Order $order): array {
    $payload['metadata']['wc_order_id'] = $order->get_id();
    $payload['metadata']['customer_note'] = $order->get_customer_note();
    return $payload;
}, 10, 2);

Customize order status on completion

add_filter('pycer_completed_order_status', function (string $status, \WC_Order $order): string {
    if ($order->has_downloadable_item()) {
        return 'completed';
    }
    return $status;
}, 10, 2);

Troubleshooting

Webhooks not received

• Ensure your Pycer instance can reach https://yourstore.com/?wc-api=pycer_gateway
• Check WooCommerce > Status > Logs and filter by pycer
• Verify the Webhook Secret matches in both systems

Orders stuck in “Pending Payment”

1. Open the order in WooCommerce Admin
2. Click Pycer > Sync Payment Status

wp pycer sync-order --order-id=1234

Related pages

• PHP SDK
• Node.js SDK
• Webhooks
• Testing payments