WooCommerce crypto payment integration checklist
This is an integration checklist for stores that connect WooCommerce order flow to SwapSS Pay through API calls, hosted checkout redirects, webhooks, status polling, and finance reconciliation.
Implementation flow
- Create the WooCommerce order first and keep its ID as
order_id. - Create a SwapSS Pay invoice from your server. See invoices.
- Redirect the buyer to the returned
payment_url. - Verify webhook signatures before changing the WooCommerce order. See webhooks.
- Reload invoice state and use payment statuses before fulfillment.
- Store invoice, webhook, status, and ledger evidence for reconciliation.
WooCommerce order mapping
| WooCommerce value | SwapSS Pay value | Purpose |
|---|---|---|
| Order ID | order_id | Connects checkout, support, and finance records. |
| Payment page redirect | payment_url | Sends the buyer to the hosted crypto checkout. |
| Order note | Invoice public ID | Gives support a stable reference. |
| Payment status | Invoice status | Prevents fulfillment before the payment is safe. |
Fulfillment guard
Do not mark the WooCommerce order paid from a raw redirect alone. Verify the webhook, reload the invoice status, and fulfill only when the status page classifies the payment as safe for delivery.
Related docs: quickstart, webhook verification, statuses, and reconciliation.