Difference between revisions of "Payment Reversals"

From WHMCS Documentation
Line 2: Line 2:
  
 
===What are Payment Reversals?===
 
===What are Payment Reversals?===
−
A Payment Reversal is a method of applying a refund to an invoice that will reverse the original invoice actions when possible.  
+
A payment reversal is when a transaction paid to you is returned to the buyer, typically via a payment dispute or chargeback.
  
−
When a reversal occurs, WHMCS will automatically set the invoice to Collections and reverse automation actions for specific invoice items.
+
In this situation, it is common to want to reverse the actions that a transaction triggered when it was originally received. This is what the Payment Reversals feature in WHMCS can automate for you.
  
 +
==Enabling Automated Payment Reversals==
 +
 +
For supported gateways, WHMCS can automatically reverse a payment when a notification is received from a payment gateway about a reversal.
 +
 +
Supported reversal actions include:
 +
 +
* '''Change Invoice Status''' - Set Invoice to Collections Status.  The collections status for invoices in WHMCS is used to denote an invoice which is a bad debt and can be used to track invoices which have received payment disputes or chargebacks.
 +
* '''Change Due Dates''' - Reverts Next Due Date Increments for the products and services contained within an invoice. This has the effect of making the item be considered due again, and in cases where the date is in the past, overdue, which will trigger an automated suspension until repayment is made.
 +
 +
To enable either of these options, navigate to Setup > Automation Settings and look for the settings under the '''Billing''' heading.
 +
 +
==Email Notifications==
 +
 +
When a payment reversal notification is received, WHMCS will send an email notification to all admin users with a role group that is set to receive "Account Emails".  See [[Administrators_and_Permissions#Managing_Administrator_Roles|Managing Administrator Roles]] for more information.
 +
 +
==Making a Manual Payment Reversal==
  
−
===How do I make a Payment Reversal?===
 
 
[[File:payment_reversal.png|300px|thumb]]
 
[[File:payment_reversal.png|300px|thumb]]
−
When applying a refund, the box "Reverse Payment" can be checked and as the refund is added, automatic actions will be reversed.
 
  
−
===Can Payment Reversals Occur Automatically?===
+
A manual payment reversal can be performed when adding a refund to an invoice.
−
Yes. Payment Reversals occur in WHMCS when a chargeback is initiated by a client for a supported gateway.
 
  
−
WHMCS will also notify all admin users that will receive "Account Emails" as part of the [[Administrators_and_Permissions#Managing_Administrator_Roles|Administrator Role]].
+
Simply check the '''Reverse Payment''' when making the refund and the invoice status and next due dates will be reversed as appropriate.
  
−
===What will happen to the items on the invoice?===
+
==Reversal Actions for Given Items==
  
−
What happens depends on the type of invoice item.
+
The reversal actions performed can vary depending upon the products/services contained with an invoice as follows.
  
 
;Hosting & Hosting Addons Invoice
 
;Hosting & Hosting Addons Invoice
Line 25: Line 38:
 
:If the payment reversal occurs as part of the cron, automatic suspend, if enabled, will occur next.
 
:If the payment reversal occurs as part of the cron, automatic suspend, if enabled, will occur next.
 
:If the reversal is standalone, any potential suspend will run when the automatic suspension tasks is next scheduled.
 
:If the reversal is standalone, any potential suspend will run when the automatic suspension tasks is next scheduled.
 +
 +
;Domain Items
 +
:Domain items will need to be manually managed. There is no automatic action taken with domains when a Payment Reversal occurs.
  
 
;Upgrade Invoice
 
;Upgrade Invoice
Line 42: Line 58:
 
:If the payment reversal occurs as part of the cron, automatic suspend, if enabled, may occur next.
 
:If the payment reversal occurs as part of the cron, automatic suspend, if enabled, may occur next.
 
:If the reversal is standalone, any potential suspend will run when the automatic suspension tasks is next scheduled.
 
:If the reversal is standalone, any potential suspend will run when the automatic suspension tasks is next scheduled.
−
 
−
;Domain Items
 
−
:Domain items will need to be manually managed. There is no automatic action taken with domains when a Payment Reversal occurs.
 
  
 
;Custom Items
 
;Custom Items
  
 
:Nothing can occur with custom invoice items. There is no relationship in WHMCS that can be utilised.
 
:Nothing can occur with custom invoice items. There is no relationship in WHMCS that can be utilised.
−
 
−
===Gateway Logs===
 
−
There are no new gateway log items. Existing refund functionality is used before the Payment Reversal functionality occurs.
 

Revision as of 10:10, 16 May 2017

This page describes a feature available in version 7.2 and above

What are Payment Reversals?

A payment reversal is when a transaction paid to you is returned to the buyer, typically via a payment dispute or chargeback.

In this situation, it is common to want to reverse the actions that a transaction triggered when it was originally received. This is what the Payment Reversals feature in WHMCS can automate for you.

Enabling Automated Payment Reversals

For supported gateways, WHMCS can automatically reverse a payment when a notification is received from a payment gateway about a reversal.

Supported reversal actions include:

  • Change Invoice Status - Set Invoice to Collections Status. The collections status for invoices in WHMCS is used to denote an invoice which is a bad debt and can be used to track invoices which have received payment disputes or chargebacks.
  • Change Due Dates - Reverts Next Due Date Increments for the products and services contained within an invoice. This has the effect of making the item be considered due again, and in cases where the date is in the past, overdue, which will trigger an automated suspension until repayment is made.

To enable either of these options, navigate to Setup > Automation Settings and look for the settings under the Billing heading.

Email Notifications

When a payment reversal notification is received, WHMCS will send an email notification to all admin users with a role group that is set to receive "Account Emails". See Managing Administrator Roles for more information.

Making a Manual Payment Reversal

Payment reversal.png

A manual payment reversal can be performed when adding a refund to an invoice.

Simply check the Reverse Payment when making the refund and the invoice status and next due dates will be reversed as appropriate.

Reversal Actions for Given Items

The reversal actions performed can vary depending upon the products/services contained with an invoice as follows.

Hosting & Hosting Addons Invoice
Any hosting and hosting addons that are part of the invoice for the reversed transaction will have their next due dates automatically reverted.
If the payment reversal occurs as part of the cron, automatic suspend, if enabled, will occur next.
If the reversal is standalone, any potential suspend will run when the automatic suspension tasks is next scheduled.
Domain Items
Domain items will need to be manually managed. There is no automatic action taken with domains when a Payment Reversal occurs.
Upgrade Invoice
The service associated with the upgrade will be immediately suspended.
Add Funds Invoice
The credit applied to the client account will be immediately removed. This could leave a client with a negative credit balance.
Mass Payment Invoice
Each invoice that has been paid will have a reversed transaction applied to it and the invoice will be set to Collections.
ProRated Hosting & Hosting Addons
The next due date of the items on the invoice will be set to the previous due date.
If the payment reversal occurs as part of the cron, automatic suspend, if enabled, may occur next.
If the reversal is standalone, any potential suspend will run when the automatic suspension tasks is next scheduled.
Custom Items
Nothing can occur with custom invoice items. There is no relationship in WHMCS that can be utilised.
Retrieved from "http://3.17.75.209/index.php?title=Payment_Reversals&oldid=22862"