Anpassen des Zeitplans für überfällige Zahlungserinnerungsversuche

MitgliedMaus 3.0+

HINWEIS: With payment services that don’t support card-on-file functionality (i.e. PayPal, Authorize.net), MemberMouse has no control over the recurring billing process and nicht überfällige Zahlungen automatisch bearbeiten.

Standardmäßig verfügt MemberMouse über ein integriertes Mahnverfahren für die Einziehung überfälliger Zahlungen. Wenn ein Abonnement die Rechnung nicht zum geplanten Termin einreicht, unternimmt MemberMouse innerhalb einer Woche drei weitere Versuche, die Zahlung einzuziehen. MemberMouse sendet außerdem eine konfigurierbare Zahlungsrückstandsmeldung after each failed payment. If you’d like to review a detailed description of this process, go to our article Automatisierte Bearbeitung überfälliger Zahlungen.

Sie können die Zeiten zwischen den einzelnen Abrechnungsversuchen anpassen, aber die drei Versuche können nicht geändert werden. Dies ist eine fest eingestellte Zahl.

Obwohl dieses Erfassungsintervall als Standard gut funktioniert, möchten Sie vielleicht die Tage, die zwischen einem Erfassungsversuch vergehen, und die Dauer des gesamten Erfassungsprozesses anpassen. Dies ist möglich, indem Sie einen WordPress-Filter verwenden, mm_abrechnung_abonnement_mahnung_intervall.

Filter sind Funktionen, die WordPress an bestimmten Punkten der Ausführung durchläuft, bevor eine Aktion mit den Daten durchgeführt wird. MemberMouse definiert einen eigenen Satz von Filtern, die Sie verwenden können, um den Ablauf der Ausführung in MemberMouse zu steuern, bevor bestimmte Aktionen ausgeführt werden.

Here’s a basic example:

function customContentProtection($data)
{
     return true;
}
add_filter('mm_bypass_content_protection', 'customContentProtection');

In this example, we’re using the add_filter() Methode, um anzuzeigen, dass die  customContentProtection() Methode sollte aufgerufen werden, wenn MemberMouse die  mm_Umgehung_des_Inhalt_Schutzes Filter.

To learn more about working with WordPress’ Action API diesen Artikel lesen.

Anpassen der Mahnungsintervalle

MemberMouse übergibt zwei Argumente an Ihre Funktion. Das erste ist eine ganze Zahl $failureIntervall die die Standardanzahl von Tagen vor dem nächsten Versuch darstellt. Die zweite ist eine ganze Zahl $failureState der den jeweiligen Status der fehlgeschlagenen Rechnungsstellung angibt. Derzeit gibt es drei Fehlerzustände: 2, 3 und 4, die den zweiten, dritten bzw. letzten Versuch, die Zahlung einzuziehen, darstellen.

Your function should return an integer representing the number of days that should be allowed to elapse before the next attempt. Here’s an example that replicates the default dunning intervals:

function customDunningInterval($failureInterval, $failureState)
{
   switch ($failureState)
   {
      Fall 2:
         return 2; // Erster Wiederholungsversuch, zwei Tage nach der ersten fehlgeschlagenen Rückbuchung
      
      case 3:
         return 3; // Zweiter Wiederholungsversuch, drei Tage nach dem ersten Wiederholungsversuch
      
      Fall 4:
         return 2; // Dritter Wiederholungsversuch, zwei Tage nach dem zweiten Wiederholungsversuch
      
      Standard:
         return $failureInterval;
   }
}
add_filter("mm_billing_subscription_dunning_interval", "customDunningInterval", 10, 2);

Um die Mahnungsintervalle anzupassen, können Sie einfach die in den drei Case-Anweisungen zurückgegebenen Werte auf die gewünschte Länge in Tagen ändern.

Wenn Sie also die Zahlung 3 Tage, 5 Tage und dann 7 Tage nach jedem Versuch wiederholen möchten, würden Sie die Funktion wie folgt ändern:

function customDunningInterval($failureInterval, $failureState)
{
   switch ($failureState)
   {
      Fall 2:
         return 2; // Erster Wiederholungsversuch, drei Tage nach der ersten fehlgeschlagenen Rückbuchung
      
      case 3:
         return 3; // Zweiter Wiederholungsversuch, fünf Tage nach dem ersten Wiederholungsversuch
      
      Fall 4:
         return 2; // Dritter Wiederholungsversuch, sieben Tage nach dem zweiten Wiederholungsversuch
      
      Standard:
         return $failureInterval;
   }
}
add_filter("mm_billing_subscription_dunning_interval", "customDunningInterval", 10, 2);