Shopify Plugin Install

How to Uninstall the Old OnePay App from Your Shopify Store (Step-by-Step)

If you’re migrating to a new OnePay integration or simply removing the old app, follow this clean, comprehensive process. It ensures your checkout won’t break, stray code won’t slow your theme, and billing stops on time.

TL;DR (Quick Checklist)

• Pause OnePay as a payment method: Settings → Payments → OnePay → Deactivate
• Remove the app: Settings → Apps and sales channels → Uninstall
• Clean theme code: Online Store → Themes → Edit code (search and remove “onepay” snippets/scripts)
• Turn off app embeds/blocks: Themes → Customize → App embeds/Sections
• Clear scripts & pixels: Settings → Customer events (remove OnePay scripts if any)
• Export data you need (payouts, settlements, mapping): from your OnePay dashboard (if applicable)
• Verify checkout & speed; publish theme

Before You Start

• Access level: You’ll need Shopify admin access with permission to manage apps and theme code.
• Downtime plan: Deactivating a payment method affects new orders immediately—do this during a low-traffic window.
• Backup: Duplicate your live theme: Online Store → Themes → … → Duplicate.
• Data export (recommended): From the OnePay dashboard, export any settlement reports, reconciliation files, or mappings you’ll need for accounting and support.

1. Deactivate OnePay as a Payment Method

Video Tutorial

1. Uninstall the Old OnePay App

   Path A (most common):

   Path B (older layout):

How to Install the New OnePay App on Shopify (Step-by-Step)

Integrating OnePay into your Shopify store unlocks seamless payment processing, faster settlements, and multiple payment options for your customers. To make sure your setup is smooth, follow this detailed step-by-step installation guide.

Before You Begin

• Shopify Access: You’ll need admin-level access.
• OnePay Account: Make sure you already have a OnePay merchant account (with approved credentials).
• Theme Backup (recommended): Duplicate your live theme in Online Store → Themes → … → Duplicate. This ensures you have a fallback in case of theme edits.

Video Tutorial

1. Open the Shopify App Store

2. Add the OnePay App

3. Connect Your OnePay Merchant Account

4. Activate OnePay as a Payment Method

5. Enable App Embeds (If Applicable)

   Some features (e.g., branded checkout buttons) may use Shopify’s App embeds.

6. Test Your Integration

7. Go Live

   • Switch from Test Mode to Live Mode in OnePay settings.
   • Announce to your customers that you now support OnePay for faster and more secure payments.

Troubleshooting

I don’t see OnePay in the payment providers list.

• Make sure the app is installed and you’ve activated it under Settings → Payments.

My payments are failing.

• Double-check API credentials. A typo in the secret key or merchant ID can cause issues.

Checkout page looks broken.

• Check if leftover code from an old app is interfering (see uninstall guide).
• Make sure OnePay app embeds are enabled.

Best Practices

• Always test after installation before announcing live payments.
• Keep your OnePay credentials secure—never share publicly.
• Review your settlement reports regularly to match transactions with Shopify orders.