Setup Guide

WordPress / WooCommerce Integration

The Medpaid WordPress plugin connects WooCommerce to the Medpaid Plugin API with minimal configuration. Most steps happen automatically once you enter your credentials.

Before you start: You need an active Medpaid merchant account with your OnboardingKey and ExternalKey. Contact support@medpaid.com if you do not have credentials yet.

Install the Medpaid plugin

In your WordPress admin, go to Plugins → Add New and search for "Medpaid". Install and activate the plugin. You can also upload the plugin zip directly if provided by Medpaid.

Enter your credentials

Go to WooCommerce → Settings → Medpaid and enter your OnboardingKey and ExternalKey. These are issued when your merchant account is created — contact support@medpaid.com if you need them.

text

// Plugin settings page fields:
OnboardingKey: ok_your_onboarding_key
ExternalKey:   ek_your_external_key

Platform auto-configures

After saving credentials, the plugin automatically calls POST /plugin/clients/woocommerce/configure-platform with your store URL, callback URI, and plugin key. No manual API call needed.

json

// What the plugin calls for you:
POST https://api.medpaid.com/plugin/clients/woocommerce/configure-platform

{
  "ExternalKey": "ek_your_key",
  "OnboardingKey": "ok_your_key",
  "Website": "https://yourstore.com",
  "CartCallbackUri": "https://yourstore.com/wc-api/medpaid",
  "OrderConfirmationRedirectUri": "https://yourstore.com/order-received/",
  "PluginApiUri": "https://yourstore.com/wp-json/medpaid/v1",
  "PluginKey": "pk_generated_key"
}

// Response:
true

Import your products

Click "Sync Products" in the Medpaid plugin settings. This calls import-products and queues your WooCommerce catalog for Medpaid eligibility review.

json

POST https://api.medpaid.com/plugin/onboarding/woocommerce/import-products

{
  "OnboardingKey": "ok_your_key",
  "ExternalKey": "ek_your_key",
  "Products": [
    {
      "ExternalId": "wc-product-123",
      "Title": "Infrared Sauna Blanket",
      "Vendor": "Your Brand",
      "ProductUrl": "https://yourstore.com/products/sauna-blanket",
      "ImageUrl": "https://yourstore.com/images/sauna-blanket.jpg"
    }
  ]
}

// Response:
{ "Imported": 12, "Skipped": 0 }

Verify setup

Click "Verify Connection" in plugin settings or call check-platform directly. All fields should return true before going live.

json

POST https://api.medpaid.com/plugin/clients/woocommerce/check-platform

{
  "ExternalKey": "ek_your_key",
  "OnboardingKey": "ok_your_key"
}

// Response — all fields should be true:
{
  "IsOk": true,
  "HasWebsite": true,
  "HasPluginKey": true,
  "HasCartCallbackUri": true,
  "HasOrderConfirmationRedirectUri": true,
  "HasPluginApiUri": true,
  "Errors": []
}

Go live

Place a test order using a Medpaid test HSA card, confirm the cart callback fires, and check your Medpaid dashboard. Once the test passes, enable the payment method for all customers.

Need help with setup?

The Medpaid team provides onboarding support for all plugin integrations.

Book a demo Email support

What's next

API Reference WooCommerce configure-platform → Solution Medpaid Reimburse →