wc-payment-gateway

WooCommerce orders get stuck in pending when gateway code uses update_status instead of payment_complete. Calling payment_complete with the transaction ID ensures the order transitions correctly and triggers the proper lifecycle events to clear the cart.

Register a custom WooCommerce payment gateway by extending the WC_Payment_Gateway class and adding it via the woocommerce_payment_gateways filter. This ensures proper integration into the checkout flow and order processing lifecycle.

The process_payment method in WooCommerce must return an array containing 'result' and 'redirect' keys. Returning the correct array shape ensures the checkout flow completes properly and redirects the customer after a successful charge.

Handle asynchronous WooCommerce payment confirmations by implementing signature-verifying webhook endpoints that call payment_complete with the transaction ID. This ensures paid orders transition correctly even when the initial checkout response is synchronous.

Implement the process_refund method in your WooCommerce gateway only when 'refunds' is declared in the supports array. This properly integrates the refund state machine without conflicting with payment_complete status transitions.

Custom WooCommerce payment gateways work with Checkout Blocks by handling Store API payment requirements appropriately. The gateway's availability depends on capability support declared in the $supports array for filtering.