Filters the label for a payment's status (i.e. "Complete", "Pending", etc). This label is displayed in the payments table in the [subscription_details] shortcode, the invoice for the payment, and the admin payments table in Restrict > Payments.
Parameters:
- $label (string) - The label to be displayed, i.e. "Complete", "Pending", or "Refunded".
- $status (string) - The payment's status (i.e. "complete", "pending", or "refunded").
- $payment (object) - The payment object from the database.