# HYROS Installation: Easy Pay Direct

**Direct URL:** https://app.hyros.com/#/mh/external-services/cart-integration/easy_pay_direct

---

## STEP 1: Create and Copy the Private Key in Easy Pay Direct

**If automating:**
Navigate to Easy Pay Direct, go to Options → Settings → Security Keys, and create a new private key with API and Cart permissions.

**If guiding user:**
1. "Inside Easy Pay Direct, click on Options on the left-hand side menu and select Settings."
2. "Click on Security Keys."
3. "Click on Add New Private Key."
4. "Fill the form including API and Cart permissions."
5. "Once complete, copy the Security key created for later."

→ Confirm: "Do you have the Security Key copied?"

---

## STEP 2: Create the Integration in HYROS

**If automating:**
Navigate to Settings → Integrations → EasyPay in HYROS, create a new integration, enter the Private Security Key from step 1, save, then get the webhook URL.

**If guiding user:**
1. "Click on Settings → Integrations → EasyPay. You can also get there directly: https://app.hyros.com/#/mh/external-services/cart-integration/easy_pay_direct"
2. "Click on Create new Integration."
3. "Enter any name."
4. "Enter the previously created Private Security Key from step 1."
5. "Click on Save Integration."
6. "Click on Configure, then Get Webhook and copy the webhook for the next step."

→ Confirm: "Do you have the HYROS webhook copied?"

---

## STEP 3: Add the Webhook to Easy Pay Direct

**If automating:**
Navigate to Options → Settings → Webhooks in Easy Pay Direct, create a new webhook with the HYROS URL, and subscribe to transaction.refund.success and transaction.sale.success events.

**If guiding user:**
1. "In EasyPay, click on Options then select Settings."
2. "Click on Webhooks."
3. "Click on Create."
4. "Paste the previously copied webhook URL to Easy Pay Direct."
5. "Configure the webhook to send 'transaction.refund.success' and 'transaction.sale.success' in the Subscribed events."

→ Confirm: "Is the webhook configured with the correct events?"

---

## Source
Synced from: docsContent.ts (easyPayDirectGuide)
Last synced: 2026-01-03