Difference between revisions of "Pay Methods"

From WHMCS Documentation

 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
In WHMCS, a Pay Method is a method of payment that belongs to a client. A Pay Method can represent a credit card or a bank account.  
+
In WHMCS, a Pay Method is a payment method that belongs to a client. It can represent a credit card or a bank account. Clients can choose any of their available payment methods during checkout for new orders and for payment of invoices. Each individual payment method has an associated '''[[Payment Gateways|Payment Gateway]]''' and can also have a different associated billing address.
  
Clients can choose any of their available Pay Methods during checkout for new orders and for payment of invoices. Each Pay Method can also have a different associated billing address.
+
<div class="docs-alert-info">
 +
The following settings in the '''[[Security Tab|Security]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' affect payment method behavior:
 +
 
 +
* '''Allow Client Pay Method Removal'''
 +
* '''Delete Encrypted Credit Card Data'''
 +
* '''Delete Encrypted Bank Account Data'''
 +
</div>
  
 
==Default Pay Method==
 
==Default Pay Method==
  
Clients must always have a default Pay Method. This is the Pay Method that all automatic recurring payment attempts use by default.
+
Clients must always have a default payment method. This is the payment method that all new automatic recurring payment attempts use by default.
  
In certain conditions, the default Pay Method may not be usable for a given invoice (for example, when the default Pay Method is tokenized with a specific payment gateway and the invoice's payment method is a different gateway). If this occurs, the system uses the first applicable Pay Method for the user in the displayed order.
+
In some scenarios, the default payment method may not be valid for a specific invoice (for example, when the default payment method is tokenized with a specific payment gateway and the invoice's payment method uses a different payment gateway). If this occurs, the system uses the client's first applicable payment method.
  
<div class="docs-alert-info">
+
<div class="docs-alert-warning">
You cannot set a different default Pay Method on a per-service basis.
+
* You cannot set a different default payment method on a per-service basis.
 +
* Changing the default payment method will not change the payment method that existing unpaid invoices use.
 
</div>
 
</div>
  
Line 17: Line 24:
 
===Admin Area===
 
===Admin Area===
  
You can manage client pay methods from the '''[[Clients:Summary_Tab|Summary]]''' tab of the client profile.
+
You can manage client payment methods from the '''[[Clients:Summary_Tab|Summary]]''' tab of the client profile.
  
 
[[File:Paymethod-admin-area-v3.png]]
 
[[File:Paymethod-admin-area-v3.png]]
Line 23: Line 30:
 
===Client Area===
 
===Client Area===
  
Clients can view and manage Pay Methods at '''Billing > Payment Methods''' in the Client Area.
+
Clients can view and manage payment method at '''Billing > Payment Methods''' in the Client Area.
  
[[File:payment-methods.png]]
+
[[File:payment-methods.png|400px]]
  
Clients can view all of their saved Pay Methods, update their descriptions and expiry dates, delete them (if you enable this) and change the default Pay Method for automated recurring payment attempts.
+
Clients can view all of their saved payment methods, update their descriptions and expiry dates, delete them (if you enable this), and change the default payment method for automated recurring payment attempts.
  
 
<div class="docs-alert-warning">
 
<div class="docs-alert-warning">
If you use a mix of both tokenized and non-tokenized payment gateways, customers can choose the desired payment method when adding one via the Client Area. This determines whether to store the card locally encrypted in the WHMCS database or remotely with the tokenized payment gateway.
+
If you use tokenized and non-tokenized payment gateways, customers can choose the desired payment method when adding one via the Client Area. This determines whether to store the card locally, encrypted in the WHMCS database, or remotely with the tokenized payment gateway.
 
</div>
 
</div>
  
 
==Processing Payments==
 
==Processing Payments==
  
The system will attempt automated recurring charges for capture automatically using the default Pay Method for a given client.
+
The system attempts recurring charges for capture automatically using the client's default payment method. If no payment method exist for a client, the client will receive an email informing them that the system could not attempt an automated payment and that they must log in and pay the invoice manually.
 +
 
 +
=== Changing Payment Methods ===
  
If no Pay Methods exist for a client, the client will receive an email informing them that the system could not attempt an automated payment  and that they must log in and pay the invoice manually.
+
To use a different card, clients can log in to the Client Area and pay the unpaid invoice manually.
  
To use a different card, clients can log in and pay an unpaid invoice manually at any time via the Client Area.
+
=== Capturing Payment Using a Stored Payment Method ===
  
Admins can also attempt to capture payment at any time using any stored Pay Method. To do this:
+
Admins can also attempt to capture payment at any time using a stored payment method.  
 +
 
 +
To do this:
  
 
# Go to the desired invoice in the [[Admin Area]].
 
# Go to the desired invoice in the [[Admin Area]].
# Click '''Attempt Capture'''. If '''Attempt Capture''' does not appear or is disabled, check the invoice's assigned Payment Method in the '''Options''' tab.
+
# Click '''Attempt Capture'''. If '''Attempt Capture''' does not appear or is disabled, check the invoice's assigned payment method in the '''Options''' tab.
# Choose the desired Pay Method to use.  
+
# Choose the desired payment method to use.  
 
# Optionally, enter the CVV number for the card.
 
# Optionally, enter the CVV number for the card.
 
# Click '''Attempt Capture''' to attempt the payment.
 
# Click '''Attempt Capture''' to attempt the payment.
 
==Related Settings==
 
 
The '''Allow Client Pay Method Removal''', '''Delete Encrypted Credit Card Data''', and '''Delete Encrypted Bank Account Data''' settings affect the behaviour of Pay Method functionality.
 
 
You can configure these settings in the '''[[Security Tab|Security]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0,  '''Setup > General Settings'''.
 

Latest revision as of 12:55, 19 December 2023

In WHMCS, a Pay Method is a payment method that belongs to a client. It can represent a credit card or a bank account. Clients can choose any of their available payment methods during checkout for new orders and for payment of invoices. Each individual payment method has an associated Payment Gateway and can also have a different associated billing address.

The following settings in the Security tab at Configuration () > System Settings > General Settings affect payment method behavior:

  • Allow Client Pay Method Removal
  • Delete Encrypted Credit Card Data
  • Delete Encrypted Bank Account Data

Default Pay Method

Clients must always have a default payment method. This is the payment method that all new automatic recurring payment attempts use by default.

In some scenarios, the default payment method may not be valid for a specific invoice (for example, when the default payment method is tokenized with a specific payment gateway and the invoice's payment method uses a different payment gateway). If this occurs, the system uses the client's first applicable payment method.

  • You cannot set a different default payment method on a per-service basis.
  • Changing the default payment method will not change the payment method that existing unpaid invoices use.

Managing Pay Methods

Admin Area

You can manage client payment methods from the Summary tab of the client profile.

Paymethod-admin-area-v3.png

Client Area

Clients can view and manage payment method at Billing > Payment Methods in the Client Area.

Payment-methods.png

Clients can view all of their saved payment methods, update their descriptions and expiry dates, delete them (if you enable this), and change the default payment method for automated recurring payment attempts.

If you use tokenized and non-tokenized payment gateways, customers can choose the desired payment method when adding one via the Client Area. This determines whether to store the card locally, encrypted in the WHMCS database, or remotely with the tokenized payment gateway.

Processing Payments

The system attempts recurring charges for capture automatically using the client's default payment method. If no payment method exist for a client, the client will receive an email informing them that the system could not attempt an automated payment and that they must log in and pay the invoice manually.

Changing Payment Methods

To use a different card, clients can log in to the Client Area and pay the unpaid invoice manually.

Capturing Payment Using a Stored Payment Method

Admins can also attempt to capture payment at any time using a stored payment method.

To do this:

  1. Go to the desired invoice in the Admin Area.
  2. Click Attempt Capture. If Attempt Capture does not appear or is disabled, check the invoice's assigned payment method in the Options tab.
  3. Choose the desired payment method to use.
  4. Optionally, enter the CVV number for the card.
  5. Click Attempt Capture to attempt the payment.