Stripe Checkout v2

Overview


HostBill supports Stripe Checkout payment gateway for collecting payments out of the box. v2 module was created to support Strong Customer Authentication

Note:

This module does not support recurring automated captures. If you want to store customer card in stripe and capture payment automatically from HostBill (+ be SCA compliant) consider using Stripe Intents 3D secure module

Activating the module


In order to activate the module login to your HostBill admin panel, go to Settings → Modules → Payment Modules, choose Stripe Checkout v2 gateway and click Activate.  

Module configuration


Once the payment gateway is activated you need to configure it. 
Please see external articles on how to setup:

Then proceed to filling in all other configuration fields:

  1. Secret Key
  2. Publishable Key - both keys can be obtained once you login to your Stripe dashboard (go to Developers → API Keys)
  3. Signing secret - Generated by stripe when creating webhook (described below)
  4. Payment methods - Select what payment methods you wish to present customer with at stripe checkout page

All required information can be obtained once you login to your Stripe merchant panel.


Go to Developers → Webhooks section and click "Add endpoint". Copy Callback URL from HostBill module to Endpoint URL in Stripe dashboard.

When selecting events, pick:

  • charge.succeeded
  • charge.dispute.funds_withdrawn
  • checkout.session.payment_failed

Select Webhook URL and copy Signing secret for configuring Stripe integration module in HostBill.


FAQ


Question: I've enabled the module but it does not display in my client portal.
Answer: This module does not support the currency you attempt to display it in, please use background currency conversion.