Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Retry Terms is reset any time balance goes to zero and a payment is successfully processed (for any amount) or the following items occur:

  1. Adding

...

  1. Credit or 2.

...

  1. Reversing a Charge.

Requirements:

In order to set the retry date on the user so the payment method is not continually processed by a bill run, you must make use of the NextTry script. This looks for the profile question ‘DaysBeforeNextRetry’ and will set the next try date in the database as Today + DaysBeforeNextRetry. When the billing process reaches or exceeds that next try date, it will attempt to process the card again. If that date is in the future, it will not attempt to retry the payment processing.

Code Block
//Set Retries
User user = (User)context["user"];
var profileQuestionName = "DaysBeforeNextRetry";
//Set the next retry date based on the profile question answer
var userPaymentDecline = user.GetUserAttributePaymentDecline();
var daysBeforeNextRetry = Convert.ToInt32(context[profileQuestionName]);
if(userPaymentDecline != null){
	var nextTryDay = SystemDateTime.Now.AddDays(daysBeforeNextRetry);
	userPaymentDecline.NextTry = nextTryDay;
	userPaymentDecline.Update();
	return true;
}
return false;

Adding Payment Retry Terms

  1. Navigate to Setup / Accounts / Credit Ratings

  2. Select the appropriate Credit Rating from the list which you would like to add Payment Retry Terms to

  3. Click the Add button on the right below the Payment Retry Terms section

  4. Enter your desired configuration (red fields are required):

    Image Modified
    • Days Since First Decline - enter a numerical value in this field. This will represent the number of days since payment was declined. This value should be 1 or greater (e.g. payment should be overdue for at least one day). Setting up additional retry terms permits you to execute multiple actions all at once or over a period of time (at 5 days perform X action, at 10 days perform Y action, etc.)

    • Action - available options are populated from your Actions table. Select the appropriate option for the drop down list (e.g. 'Charge Late Fee', 'Send Email', etc.). If your script (Action) requires additional information to be entered (via a profile question) this information will be displayed under a component section of the individual retry term

    • Active - Active means the action is enabled, i.e. it will execute provided bill runs are configured with the 'Run Payment Retry Terms' setting enabled. You can disable individual actions as needed without the need to delete a configured payment retry term to prevent specific actions from firing

  5. Click Save to return to the Credit Ratings setup screen or Save/New to continue setting up additional retry terms for this credit rating

Note

REMEMBER: Once all payment retry terms have been configured and set to Active, make sure that you have the 'Run Payment Retry Terms' options enabled on your Bill Runs (shown below).

...

Checklist for Payment Retry Terms and Payment Terms

  1. Ensure that the correct payment method is associated with the account. In the case of Payment Retry Terms; Credit Card

  2. In the case that you need to send an email to a contact on the account (Billing, Administrative, etc.) ensure that the appropriate contact type has "Email Contact" checked

  3. The Profile Question associated to the Action of "Email" should have no spaces in the title

  4. Ensure that the Profile Question has the following fields checked/complete:

    • Name

    • Question

    • REQUIRED (checked)

    • ENTERED and DATA TYPE : Text

  5. Ensure the email message fields are properly populated:

    • Name

    • Subject

    • Body

    • FROM Name

    • FROM Address

    • CONTACT TYPE (the Customer contact that will receive the email)

  6. Ensure that when configuring a Bill Run, ensure the following conditions are met:

    1. The Payment Methods you are charging are checked off in the Bill Run configuration (i.e. Credit Card, E Check Token, Credit Card Token, ACH)

    2. If you have Payment Terms associated to an account: Run Payment Term is checked

    3. If you have Payment Retry Terms associated to an account : Run Payment Retry Terms is checked

    4. When configuring the order in which actions will take place in Payment Terms and Payment Retry Terms use a value greater than zero, e.g. 1 or greater 'days since first decline', zero days would not be 'overdue'

    5. When configuring a Card Processor under the Setup page ensure that TEST MODE is unchecked after you have finished testing Credit Card processing
      Alert: TEST MODE should only be modified on a Dev/Test environment so that live users/customers are not impacted