# Medpaid

<figure><img src="/files/aWrZO2abgztSDwyGTOTZ" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**Disclaimer:**

Medpaid is for US consumers only

Medpaid does not support Authorize, Capture, or Void
{% endhint %}

{% hint style="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.
{% endhint %}

{% hint style="warning" %}
Refunds will not be completed instantly. Refunds are completed some time later after a final disposition is received from Medpaid.
{% endhint %}

**STEP 1**

Go to **Checkout Champ CRM | Gateways | Gateway Integrations**&#x20;

Select the Medpaid tile

If already a Medpaid customer then click the <mark style="color:green;">+</mark> <mark style="color:green;"></mark><mark style="color:green;">**Activate**</mark> button to activate **Medpaid**.  Then proceed to Step 2.

If not a customer, press <mark style="color:green;">**Sign Up**</mark> and follow the instructions.  Once the onboarding is complete the Medpaid gateway will be automatically created.  Proceed to Step 3.

<figure><img src="/files/CauZvrTqgSoNVPVIppcZ" alt="" width="375"><figcaption></figcaption></figure>

**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.

<figure><img src="/files/eJ6mFpAbIEHnEGxkwiit" alt="" width="375"><figcaption></figcaption></figure>

Click the <mark style="color:green;">**Create Gateway**</mark> 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 <mark style="color:purple;">**Sync Products**</mark> button.  Press the button to send the products to Medpaid.

<figure><img src="/files/jDnLHRL7c7jxEZRjsAfP" alt="" width="188"><figcaption></figcaption></figure>

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**

{% hint style="info" %}
This step is for a direct API integration only.  It can be ignored if using CheckoutChamp hosted pages.
{% endhint %}

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

```
<input type="hidden" name='paySource' value="PREPAID">
<input type='hidden' name='prepaidType' value='MEDPAID'>
```

The checkout page must handle standard 3DS processing

[Direct API 3DS Instructions](/crm/gateway-setup/direct-api-3ds-instructions.md)&#x20;

***

**STEP 5**

{% hint style="info" %}
This step is for CheckoutChamp hosted pages only
{% endhint %}

Products approved by Medpaid automatically display in the shopping cart with a hsa\_fsa\_eligible badge.

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

<figure><img src="/files/1d8AbH7BWuZIh194MFNE" alt="" width="375"><figcaption></figcaption></figure>

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.

<figure><img src="/files/o2Gu3WhUsiWLdpWVHaPr" alt="" width="563"><figcaption></figcaption></figure>

The radio button is disabled on a live page if no approved products are in the shopping cart.

***

**STEP 6**

Additional Considerations:

* Medpaid requires that at least 1 product in the order is HSA/FSA eligible (approved)
* 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.checkoutchamp.com/crm/gateway-setup/gateway-integrations/medpaid.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.