money-check-dollar-penMedpaid

Accept HSA/FSA payments with Medpaid. Case study after case study proves HSA/FSA payments with Medpaid increase customer spending, reduce friction, and powers a new market segment.

triangle-exclamation
circle-info

Medpaid will work with Checkout Champ pages and landers that connect to Checkout Champ via Direct API. This will NOT work with Order Entry.

circle-exclamation

STEP 1

To activate the Medpaid gateway, go to Checkout Champ | Gateways | Gateway Integrations and select the Medpaid tile. Click the + Activate button to activate Medpaid.

STEP 2

Enter Title and Descriptor of your choosing

Enter OnboardingKey and ExternalKey in the General Details section. These are obtained from your Medpaid account.

Click the Create Gateway button to save your changes and create the gateway

STEP 3

HSA/FSA products must be approved by Medpaid. Products can be sent for approval directly from CheckoutChamp.

Go to CRM > Products. Edit the product that could be eligible for HSA/FSA. Type "Medpaid" (without quotes) into Client ID. Enter a proper Description for Medpaid medical providers to evaluate. Save. Repeat this for each eligible product.

Edit the gateway in Step 2. Find the Sync Products button. Press the button to send the products to Medpaid.

It will take some time for Medpaid medical providers to review the products. The final status will be automatically updated. If approved, a hsa_fsa_eligible tag will be added to the product. This tag cannot be removed. If denied, the product Client ID will be cleared. If the product needs to send again then type "Medpaid" into Client ID to begin the process anew.


STEP 4

circle-info

This step is for a direct API integration only. It can be ignored if using CheckoutChamp hosted pages.

The Checkout page must be secure HTTPS. A non-secured call to the Medpaid gateway will be rejected.

Pass paySource=PREPAID and prepaidType=MEDPAID on the import order API call from your checkout page

One option is to use hidden input fields on the page

The checkout page must handle standard 3DS processing

Direct API 3DS Instructions


STEP 5

circle-info

This step is for CheckoutChamp hosted pages only

Medpaid requires a radio button on the Checkout page. Start by dragging a Radio Button element from the Blocks menu onto your Checkout page.

Select the Radio. Edit the Settings so that the Name is payment_method and the Value is MEDPAID. This may also be used with a payment toggler, just use a Name of fk-payment-option-toggler instead. Save the page, exit the page builder, and Publish.

STEP 6

Additional Considerations:

  • Medpaid requires that at least 1 product in the order is HSA/FSA eligible

  • The options in Step 5 are disabled if no HSA/FSA eligible products are in the shopping cart

  • Medpaid supports rebills

  • Medpaid can process split payments between HSA/FSA eligible products and ineligible products. CheckoutChamp is not aware of this split payment. The split is available in Medpaid only.

Last updated