Help : Stripe - Getting Started

MD HQ allows you to process credit card transactions and recurring subscription payments via your Stripe account. The EMR communicates with Stripe via an API, meaning that once you set up your Stripe account and we connect to it, you continue to handle billing inside MD HQ, rather than having to go to an external website or application.

This help section describes how you set up and connect your Stripe account to begin processing credit cards via the EMR and Patient Portal.

Setting Up Your Stripe Account

First, set up your account at stripe.com. Then activate your account (use the link or, from your Stripe home page, click on "Your Account" in the upper righthand corner and then on "Activate Account"). You will need to provide basic information about your business and the bank account where you want credit card payments to be deposited.

Stripe Screenshot - Activate Account

Toggle into Live mode by clicking the toggle button in the upper left hand corner of your Stripe dashboard. You can go back to Test mode at any time, but can only process credit card payments in Live mode.

Linking Stripe to MD HQ

Go to your Stripe Account Settings (use the link or, from your Stripe dashboard, click on "Your Account" in the upper righthand corner, then click on "Account Settings").

Stripe screenshot - API keys

Get your API Keys: In the API Keys tab, copy and paste both live API keys (not the test keys) into a sticky note on the schedule home page of your EMR. The two keys, which are long strings of letters and numbers, should start with "sk_live_..." and "pk_live_..." Send us a note at support@md-hq.com to let us know when this is done. We'll log in to your build, pick up the keys, and use them to connect your Stripe account with your EMR build. Note: DO NOT send us your keys via email, as this is sensitive information and email is not secure.

Configure Webhooks: This is optional, but strongly recommended, particularly if you use subscription billing. Webhooks allow our server to log what Stripe is doing so that we can alert you if there is a failed payment, for example, or help look through the logs if you think there has been an error. Otherwise, we have no way of seeing what Stripe is doing. Note that sensitive information (like a credit card number) is never viewable or logged by our system.

Configure webhooks by clicking on the webhooks tab and then on "+ Add URL." Type in https://YOUR EMR URL/webhooks/stripe.php (replacing YOUR EMR URL with the actual URL of your EMR - see below for help with this).

  • What is my EMR URL? Looking at any page of your EMR, copy everything in the web address bar starting after "https://" and going through ".md-hq.com". So, for example, if you see "https://demo1.md-hq.com/calendar.php," your URL is the underlined part: "demo1.md-hq.com".

Stripe Configuration Options

You can set various configuration options for Stripe in the "Your Account" pop up window, including:

  • In the main tab - check the box if you want a credit card payment to be declined if there is a mismatch with the zip code or the CCV.
  • In the subscriptions tab - tell Stripe what to do if there is a failed credit card payment. The default is for Stripe to retry three times, but you can vary this, as well as set the interval at which it should retry each time.
  • In the emails tab - set whether Stripe sends you and/or your customer an automatic email when a payment is made and customize your Stripe invoices.

Accepting FSA and HSA cards on Stripe

Stripe is able to accept Flexible Spending Account (FSA) and Health Saving Account (HSA) credit/debit cards. However, before you can do so, you need to contact Stripe and request that they classify your account as an MCC business. More information on setting this up can be found here: https://support.stripe.com/questions/can-i-process-hsa-fsa-cards-using-stripe

Getting Credit Card Information

If you have credit card information on file in another program, such as Authorize.net or Braintree, Stripe can likely import this information. Or you can add a credit card to a patient's account in the EMR by clicking on "Save New Credit Card" in the Billing Info tab of the Patient Info pop-out. Or, patients can add a credit card via their Patient Portal account if you have this feature turned on. Contact support@md-hq.com if you would like to activate this feature.