Curated resource guide
WooCommerce Payments Development
Develop WooCommerce payment integrations that handle real transaction states, retries, and asynchronous events safely. This guide covers gateway and Blocks APIs, tokenization, authorization and capture, refunds, subscriptions, webhooks, 3DS and SCA, PCI scope, idempotency, order status, testing, logging, reconciliation, and failure recovery.
Scope
What this guide covers
- Payment-gateway architecture
- checkout integration
- Payment Gateway API
- Blocks payment-method integration
- authorization and capture
- tokenization
- saved cards
- refunds
- voids
- subscriptions/recurring-payment compatibility
- webhooks
- asynchronous payments
- redirects
- 3DS/SCA
- PCI scope
- idempotency
- order-status transitions
- failed payments
- retries
- currency
- fees
- sandbox/test modes
- logging
- reconciliation
- security
- fraud considerations
- testing
- and gateway-specific reliability patterns
Selected references
Curated resources
Links open the original publisher so you can use the complete, current material in context.
- 01Recommended starting point
WooCommerce Payment Gateway API
The core integration contract for gateway settings, checkout processing, order state, refunds, and receipts.
developer.woocommerce.com - 02
WooCommerce Payment Token API
Store and manage reusable payment-token references through WooCommerce APIs instead of custom customer metadata.
developer.woocommerce.com - 03
Checkout Block Payment Method Integration
Register a payment method for Cart and Checkout Blocks with correct frontend state and server processing.
developer.woocommerce.com - 04
WooCommerce Payment Data Store
Understand the Blocks payment state, registered methods, processing status, and selectors used during checkout.
developer.woocommerce.com - 05
Checkout Flow and Events
Follow the event-driven checkout lifecycle before attaching validation or asynchronous payment behavior.
developer.woocommerce.com - 06
Subscriptions Payment Gateway Integration
Handle recurring capabilities, saved methods, scheduled charges, renewals, and subscription-specific gateway behavior.
woocommerce.com - 07
PCI Security Standards
Consult the source standards when making architectural decisions that affect card-data handling and PCI scope.
pcisecuritystandards.org - 08
WooCommerce Order Statuses
Map authorization, capture, failure, cancellation, and refund outcomes onto correct order-state transitions.
woocommerce.com - 09
Testing WooCommerce Payment Integrations
Exercise payment registration, checkout states, failure paths, and compatibility before release.
developer.woocommerce.com - 10
Stripe Idempotent Requests
Prevent retries from creating duplicate payment-side effects when requests time out or responses are lost.
docs.stripe.com - 11
Stripe Webhooks
Verify, acknowledge, retry, and process asynchronous payment events without trusting browser completion.
docs.stripe.com - 12
Stripe Testing
Use deterministic test methods to cover authorization, decline, authentication, and dispute scenarios.
docs.stripe.com