Invoice statuses
See Invoice lifecycle for full descriptions.Payment row statuses
Separate from invoice status. Tracks the blockchain payment record:| Status | Description |
|---|---|
pending | Payment detected, awaiting confirmation |
completed | Payment fully confirmed |
underpaid | Received less than expected |
overpaid | Received more than expected |
failed | Payment failed |
completed, underpaid, overpaid) must not be overwritten by later failure detection.
Webhook event mapping (standard merchant events)
| Invoice status | Webhook event | Default subscription |
|---|---|---|
| (on create) | invoice.created | Yes |
paid | invoice.paid | Yes |
underpaid | invoice.underpaid | Yes (Woo managed) |
failed | invoice.failed | Yes |
expired | invoice.expired | Yes |
cancelled | invoice.cancelled | Yes (Woo managed) |
Platform-only webhook mapping
| Invoice status | Webhook event | Default subscription |
|---|---|---|
refunded | invoice.refunded | No — emitted when platform status polling detects a refund; not merchant-initiated |