Difference between revisions of "PayPal"

From WHMCS Documentation

(Modify subscriptions)
 
(71 intermediate revisions by 10 users not shown)
Line 1: Line 1:
For PayPal invoices to be automatically marked paid when you receive a payment you need to enable IPN inside your PayPal accountThis is done in the My Account > Profile -> Instant Payment Notification Preferences (under Selling Preferences) areaYou need to check the IPN box and leave the callback URL blank. The callback URL is pre-populated with "http://", which must be deleted.
+
According to PayPal® research, 49% of PayPal users abandon their purchases if PayPal isn’t a payment option. WHMCS’s supported payment gateway modules include several options for accepting payments through PayPal, helping you maximize your business and offer the options that your customers want most.
 
+
   
As of April 2009, PayPal have removed the ability to leave the callback URL blank and so you must now set it to an url. It's not important what URL you use but you can set it to the WHMCS callback file using the path http://www.yourdomain.com/whmcspath/modules/gateways/callback/paypal.php
+
You can enable payment gateways, including the PayPal options below, at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps_and_Integrations|Apps & Integrations]]''' (in WHMCS 8.6 and later) or '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' (in WHMCS 8.5 and earlier).
 
+
   
[[Image:paypalipn.jpg]]
+
== PayPal Gateway Comparison ==
 
+
==PayPal Subscriptions==
+
Each PayPal payment gateway includes features to help you accept and manage payments:
 
+
   
Unless disabled in the PayPal gateway config, when a user views an invoice for a recurring product or service they will be shown a PayPal Subscribe button. This allows the user to subscribe so that their payment for that product or service is sent to you automatically each month and automatically applied to the invoices.
+
<table class="table table-striped table-condensed">
 
+
    <tr>
The subscribe button will only show on or before the due date of the invoice. This is to prevent the user signing up for a subscription late as then the invoice would be paid late every month.
+
      <th>Feature</th>
 
+
      <th>PayPal Payments</th>
===Modify Subscriptions===
+
      <th>PayPal Card Payments</th>
 
+
      <th>PayPal Checkout</th>
By enabling Modify Subscriptions, customers will be given the option to create a new agreement or modify an existing one when going through the subscribe process. Saving you from having to cancel a subscription and create a new one.
+
      <th>PayPal Basic</th>
 
+
      <th>PayPal Pro Reference Payments</th>
==Automated Refunds==
+
      <th>PayPal Website Payments Pro</th>
 
+
      <th>PayFlow Pro</th>
As of version 4, you can issue refunds for PayPal payments directly from within WHMCSBefore you can do this however, you need to setup PayPal API accessThe steps for doing this are as follows:
+
    </tr>
 
+
    <tr>
#Login to PayPal
+
      <td>Recommended for New PayPal Merchants</td>
#Go to Profile > API Access
+
      <td>✓</td><td>✓</td><td>✖️</td><td>✖️</td><td>✖️</td><td>✖️</td><td>✖️</td>
#Choose Option 2 - Request API credentials to create your own API username and password.
+
    </tr>
#Choose Option 1 - Request API Signature and click Agree and Submit
+
    <tr>
#Copy the username, password and signature that get provided and then click Done
+
      <td>Gateway Type</td>
#Enter the details from the previous step into the WHMCS Payment Gateways config screen where requested
+
      <td>''Token''</td><td>''Token''</td><td>''Third-Party''</td><td>''Third-Party''</td><td>''Token''</td><td>''Merchant''</td><td>''Merchant''</td>
 
+
    </tr>
You will now be able to enter a refund and have it sent from PayPal at the same time from within the WHMCS admin area invoice management screen.
+
    <tr>
 
+
      <td>One-Time<br/>Payments</td>
{{modules}}
+
      <td>✓</td><td>✓</td><td>✓</td><td>✓</td><td>✓</td><td>✓</td><td>✓</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Recurring<br/>Payments</td>
 +
      <td>✓</td><td>✓</td><td>✓</td><td>✓</td><td>✓</td><td>✓</td><td>✓</td>
 +
    </tr>
 +
    <tr>
 +
      <td>PayPal<br/>Subscriptions</td>
 +
      <td>✖️</td><td>✖️</td><td>✓</td><td>✓</td><td>✖️</td><td>✖️</td><td>✖️</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Refunds</td>
 +
      <td>✓</td><td>✓</td><td>✓</td><td>✓</td><td>✓</td><td>✓</td><td>✓</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Reversals<br/>(in WHMCS)</td>
 +
      <td>✓</td><td>✓</td><td>✖️</td><td>✓</td><td>✖️</td><td>✖️</td><td>✖️</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Disputes<br/>(in WHMCS)</td>
 +
      <td>✓</td><td>✓</td><td>✓</td><td>✖️</td><td>✖️</td><td>✖️</td><td>✖️</td>
 +
    </tr>
 +
    <tr>
 +
      <td>3D Secure</td>
 +
      <td>N/A</td><td>✓</td><td>✖️</td><td>✖️</td><td>✓</td><td>✓</td><td>✓</td>
 +
    </tr>
 +
    <tr>
 +
      <td>View Balances<br/>(in WHMCS)</td>
 +
      <td>✓</td><td>✓</td><td>✖️</td><td>✖️</td><td>✓</td><td>✓</td><td>✓</td>
 +
    </tr>
 +
</table>
 +
 +
== Our PayPal Gateways ==
 +
 +
We support the following PayPal payment gateways and ship them by default for all supported installations:
 +
 +
=== PayPal Payments ===
 +
 +
<div class="docs-alert-info">
 +
We '''strongly''' recommend the PayPal Payments module to all new PayPal merchants. For steps to activate and configure '''PayPal Payments''', see [https://help.whmcs.com/a/1782848 Start Using PayPal Payments].
 +
</div>
 +
 +
'''PayPal Payments''' uses PayPal’s latest secure tokenization system and lets your clients make payments with PayPal, including credit and debit card transactions. It ensures the security of your customers’ stored payment details with merchant-level vaulting through PayPal Vault, now available for PayPal merchant accounts in [[PayPal_Payments#Vaulting|PayPal-supported countries]]. It also supports [[Disputes|disputes]], and you can view your current merchant account balance at '''Billing > [[Transactions]]'''.
 +
 +
When you activate '''PayPal Payments''', the system also activates '''PayPal Card Payments''' (below). This module augments PayPal Payments, allowing you the option to visually separate the PayPal checkout experience from credit and debit card payments.
 +
 +
For more information, see [[PayPal Payments]].
 +
 +
=== PayPal Card Payments ===
 +
 +
'''PayPal Card Payments''' works with the '''PayPal Payments''' module to add an unbranded credit and debit card option that uses PayPal Advanced Checkout. When you activate '''PayPal Payments''', the system automatically activates '''PayPal Card Payments''' with it, with both modules using the account details that you configure for '''PayPal Payments'''.
 +
 +
Display '''PayPal Card Payments''' on your Client Area order form to visually separate the PayPal checkout experience from credit and debit card payments. Like '''PayPal Payments''', '''PayPal Card Payments''' also supports [Disputes|disputes]], and you can view your current merchant account balance at '''Billing > [[Transactions]]'''.
 +
 +
For more information, see [[PayPal Card Payments]].
 +
 +
=== PayPal Checkout ===
 +
 +
'''PayPal Checkout''' gives your customers a simplified and secure checkout experience, with the option to use '''Express Checkout''' to complete the transaction. '''Express Checkout''' appears automatically as a payment option for any product that uses a ''One-Time'', ''Biennial'', or ''Triennial'' billing cycle.
 +
 +
'''PayPal Checkout''' allows you to accept one-time and recurring payments through PayPal (including PayPal Subscriptions), process refunds, and handle [[Disputes|disputes]] from within WHMCS.
 +
 +
For more information, see [[PayPal Checkout]].
 +
 +
=== PayPal Basic ===
 +
 +
'''PayPal Basic''' allows you to accept one-time and recurring payments through PayPal (including PayPal Subscriptions), process refunds, and handle payment reversals. In WHMCS 8.2 and later, you can view payment gateway balances for '''PayPal Basic''' at '''Billing > [[Transactions]]''' in the WHMCS Admin Area. This lets you check your financial details sooner and stay aware of trends and changes.
 +
 +
For more information, see [[PayPal Basic]].
 +
 +
=== PayPal Pro Reference Payments ===
 +
 +
'''PayPal Pro Reference Payments''' allows you to store cards with a secure tokenization system for better PCI compliance. It can process one-time and recurring payments and send refunds.
 +
   
 +
This module does '''not''' support adding or updating card data via the Admin Area. Instead, you can do this by paying an invoice on behalf of a client.
 +
 +
For more information, see [[Payflow_Pro|PayPal Pro Reference Payments]].
 +
   
 +
=== PayPal Website Payments Pro ===
 +
 +
'''PayPal Website Payments Pro''' allows you to accept one-time and recurring payments with locally-stored credit cards, process refunds, and handle payment reversals.
 +
 +
For more information, see [[PayPal Website Payments Pro]].
 +
 +
=== PayFlow Pro ===
 +
 +
'''Payflow Pro''' includes one-time and recurring payments with locally-stored credit cards and process refunds. You will need to enable the PayFlow Pro API in order to use this payment gateway.
 +
 +
For more information, see [[Payflow Pro]].

Latest revision as of 20:15, 22 March 2024

According to PayPal® research, 49% of PayPal users abandon their purchases if PayPal isn’t a payment option. WHMCS’s supported payment gateway modules include several options for accepting payments through PayPal, helping you maximize your business and offer the options that your customers want most.

You can enable payment gateways, including the PayPal options below, at Configuration () > Apps & Integrations (in WHMCS 8.6 and later) or Configuration () > System Settings > Payment Gateways (in WHMCS 8.5 and earlier).

PayPal Gateway Comparison

Each PayPal payment gateway includes features to help you accept and manage payments:

Feature PayPal Payments PayPal Card Payments PayPal Checkout PayPal Basic PayPal Pro Reference Payments PayPal Website Payments Pro PayFlow Pro
Recommended for New PayPal Merchants ✖️✖️✖️✖️✖️
Gateway Type TokenTokenThird-PartyThird-PartyTokenMerchantMerchant
One-Time
Payments
Recurring
Payments
PayPal
Subscriptions
✖️✖️✖️✖️✖️
Refunds
Reversals
(in WHMCS)
✖️✖️✖️✖️
Disputes
(in WHMCS)
✖️✖️✖️✖️
3D Secure N/A✖️✖️
View Balances
(in WHMCS)
✖️✖️

Our PayPal Gateways

We support the following PayPal payment gateways and ship them by default for all supported installations:

PayPal Payments

We strongly recommend the PayPal Payments module to all new PayPal merchants. For steps to activate and configure PayPal Payments, see Start Using PayPal Payments.

PayPal Payments uses PayPal’s latest secure tokenization system and lets your clients make payments with PayPal, including credit and debit card transactions. It ensures the security of your customers’ stored payment details with merchant-level vaulting through PayPal Vault, now available for PayPal merchant accounts in PayPal-supported countries. It also supports disputes, and you can view your current merchant account balance at Billing > Transactions.

When you activate PayPal Payments, the system also activates PayPal Card Payments (below). This module augments PayPal Payments, allowing you the option to visually separate the PayPal checkout experience from credit and debit card payments.

For more information, see PayPal Payments.

PayPal Card Payments

PayPal Card Payments works with the PayPal Payments module to add an unbranded credit and debit card option that uses PayPal Advanced Checkout. When you activate PayPal Payments, the system automatically activates PayPal Card Payments with it, with both modules using the account details that you configure for PayPal Payments.

Display PayPal Card Payments on your Client Area order form to visually separate the PayPal checkout experience from credit and debit card payments. Like PayPal Payments, PayPal Card Payments also supports [Disputes|disputes]], and you can view your current merchant account balance at Billing > Transactions.

For more information, see PayPal Card Payments.

PayPal Checkout

PayPal Checkout gives your customers a simplified and secure checkout experience, with the option to use Express Checkout to complete the transaction. Express Checkout appears automatically as a payment option for any product that uses a One-Time, Biennial, or Triennial billing cycle.

PayPal Checkout allows you to accept one-time and recurring payments through PayPal (including PayPal Subscriptions), process refunds, and handle disputes from within WHMCS.

For more information, see PayPal Checkout.

PayPal Basic

PayPal Basic allows you to accept one-time and recurring payments through PayPal (including PayPal Subscriptions), process refunds, and handle payment reversals. In WHMCS 8.2 and later, you can view payment gateway balances for PayPal Basic at Billing > Transactions in the WHMCS Admin Area. This lets you check your financial details sooner and stay aware of trends and changes.

For more information, see PayPal Basic.

PayPal Pro Reference Payments

PayPal Pro Reference Payments allows you to store cards with a secure tokenization system for better PCI compliance. It can process one-time and recurring payments and send refunds.

This module does not support adding or updating card data via the Admin Area. Instead, you can do this by paying an invoice on behalf of a client.

For more information, see PayPal Pro Reference Payments.

PayPal Website Payments Pro

PayPal Website Payments Pro allows you to accept one-time and recurring payments with locally-stored credit cards, process refunds, and handle payment reversals.

For more information, see PayPal Website Payments Pro.

PayFlow Pro

Payflow Pro includes one-time and recurring payments with locally-stored credit cards and process refunds. You will need to enable the PayFlow Pro API in order to use this payment gateway.

For more information, see Payflow Pro.