Importer Note: This doc uses Order 16 to appear after the core DDLS subscription docs (Orders 3–14) in the Subscription Management category. See the importer note at the top of this part.

The Payment Retry History Metabox appears alongside the Subscription Pro Status Metabox on the WooCommerce order edit screen. It provides a full audit log of all payment retry attempts for that subscription.

📌 What This Extension Adds: This metabox is added entirely by Subscriptions Pro. It reads from the wp_dmsilm_sp_payment_retries table to display the complete retry history for each subscription.

Retry History Table #

The metabox displays a table with the following columns for each retry attempt:

Rows are displayed in reverse chronological order (newest first). Successful retries are highlighted green; failed retries are highlighted red.

Manual Retry Button #

A Retry Payment Now button appears at the bottom of the metabox when a subscription is in grace_period status and has not exceeded the maximum retry count (dmsilm_sp_max_retries, default: 4). Clicking this button:

1. Records a manual retry attempt in wp_dmsilm_sp_payment_retries
2. Fires the WooCommerce payment retry hook
3. Refreshes the metabox to show the new attempt result
4. Adds an entry to the order notes timeline

If the maximum retry count has been reached, the button is replaced with a notice explaining that automatic retries are exhausted and a subscription admin action (reactivate or cancel) is needed.

For retry schedule configuration, see Payment Retries Overview.

—

## Next Steps

• Payment Retries Overview — Understand how dunning and payment retries are scheduled.
• Grace Periods and Suspension — Configure what happens after payment failure.
• Customer Portal Overview — See the customer-facing subscription management interface.