# Medpaid

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FL24HtNnY9XKPvnZ9EOjZ%2Fimage.png?alt=media&#x26;token=c42843d5-e0a0-43b8-a62b-35001e0a92cd" 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**

To activate the Medpaid gateway, go to **Checkout Champ | Gateways | Gateway Integrations** and select the Medpaid tile. Click the <mark style="color:green;">+</mark> <mark style="color:green;"></mark><mark style="color:green;">**Activate**</mark> button to activate **Medpaid**.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FcrId7byLyCTMxGCJFOZN%2Fimage.png?alt=media&#x26;token=8c85e382-e27f-4200-a425-9a0c6a32fe28" 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="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2Fgs4DRbMXvS89b4QBAR5R%2Fimage.png?alt=media&#x26;token=011293e2-0e56-4010-bfdd-69306f9f5c18" 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="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FVaSQSWYHXJEdUycTxMMC%2Fimage.png?alt=media&#x26;token=cd832487-0b8d-4894-a710-da34f8e228ad" 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](https://help.checkoutchamp.com/crm/gateway-setup/direct-api-3ds-instructions)&#x20;

***

**STEP 5**

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

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="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F3zChkfRmmPPSIpfNjcXh%2Fimage.png?alt=media&#x26;token=1a26f941-219c-4c64-b6d4-896ba340c214" 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="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FYOhCWU6wrmvNGzJTPhgC%2Fimage.png?alt=media&#x26;token=5b9753b9-69e8-4ef6-9f2f-4a272bf2243a" alt="" width="563"><figcaption></figcaption></figure>

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