Difference between revisions of "Stripe"

From WHMCS Documentation

(Migration from a 3rd Party Module)
m
Line 28: Line 28:
  
 
The WHMCS module uses the Stripe "cus_" reference to capture payments - e.g. cus_9MvIb7UlgJfJTn. Find this on the Credit Card Information screen from the Client Summary. The WHMCS module can replace any existing Stripe module that uses the same reference. Activate the WHMCS Module as above. Then, deactivate the existing Stripe module, whilst selecting the official module as a replacement.
 
The WHMCS module uses the Stripe "cus_" reference to capture payments - e.g. cus_9MvIb7UlgJfJTn. Find this on the Credit Card Information screen from the Client Summary. The WHMCS module can replace any existing Stripe module that uses the same reference. Activate the WHMCS Module as above. Then, deactivate the existing Stripe module, whilst selecting the official module as a replacement.
 +
 +
==Migration from another Credit Card Module==
 +
 +
To convert from another module in WHMCS to Stripe is simple and does not need intervention. The Stripe module will create a token from existing card details on payment attempt. Choose Stripe from the Gateway dropdown on a client service to have this happen. On the next invoice, WHMCS will send the card details to Stripe and replace with the generate token.
  
 
==Special Notes for Transaction Fees==
 
==Special Notes for Transaction Fees==
  
 
Stripe provides the fee for transactions in the currency of the account. This can be different from the currencies configured in WHMCS. For the fees to be available, the currency of the Stripe account should be available in WHMCS.
 
Stripe provides the fee for transactions in the currency of the account. This can be different from the currencies configured in WHMCS. For the fees to be available, the currency of the Stripe account should be available in WHMCS.

Revision as of 10:44, 7 November 2016

Supported Features

Type One Time Recurring Refunds 3D Secure
Token Yes Yes Yes No
Remote Update Card Remote Delete Card AddPayMethod API
Yes Yes No

The WHMCS official Stripe module was introduced in WHMCS 7.1. Stripe remotely stores a client's credit card, without storing the details within WHMCS.

Setup

Stripe Module Settings

Stripe uses the API keys found here. Start by activating the module in Setup > Payments > Payment Gateways. The module is listed as Stripe.

When active, enter the Secret and Publishable API Keys and click Save Changes. Stripe is now active for clients to use. Ensure the "Disable Credit Card Storage" option in not enabled. Find this on the Security tab of General Settings.

How does it work?

The Stripe module on Checkout
  1. The client does not leave WHMCS.
  2. The module uses stripe.js for payments and card updates.
  3. The module uses the Stripe API for refunds and obtaining transaction information.
  4. A customer can edit their card at any time from the client area.
  5. An admin with access can request a payment for a token at any point.

Migration from a 3rd Party Stripe Module

The WHMCS module uses the Stripe "cus_" reference to capture payments - e.g. cus_9MvIb7UlgJfJTn. Find this on the Credit Card Information screen from the Client Summary. The WHMCS module can replace any existing Stripe module that uses the same reference. Activate the WHMCS Module as above. Then, deactivate the existing Stripe module, whilst selecting the official module as a replacement.

Migration from another Credit Card Module

To convert from another module in WHMCS to Stripe is simple and does not need intervention. The Stripe module will create a token from existing card details on payment attempt. Choose Stripe from the Gateway dropdown on a client service to have this happen. On the next invoice, WHMCS will send the card details to Stripe and replace with the generate token.

Special Notes for Transaction Fees

Stripe provides the fee for transactions in the currency of the account. This can be different from the currencies configured in WHMCS. For the fees to be available, the currency of the Stripe account should be available in WHMCS.