QashPay Shopify Plugin (ACI Worldwide) – Installation & Configuration Guide
This guide explains how to install and configure the QashPay Shopify plugin (listed as ACI Worldwide in the Shopify App Store).
👉 Shopify App: https://apps.shopify.com/aci-worldwide
🎥 Video walkthrough: https://www.youtube.com/watch?v=r37k1Vo8mOs
📄 Reference documentation:
Overview
The QashPay Shopify plugin (powered by ACI Worldwide) enables secure payment processing and supports a wide range of payment methods through a single integration.
1. Installation
Step-by-step
| Step | Action | Notes |
|---|---|---|
| 1 | Obtain installation link or open Shopify App Store | Provided by QashPay / Account Manager |
| 2 | Open the ACI Worldwide app page | Shopify will redirect to your admin |
| 3 | Click Install App | Approve permissions |
| 4 | Access the app | Automatically redirected or via Apps → ACI Worldwide |
After installation, you will land on the App Dashboard.
2. Accessing the App
| Method | Steps |
|---|---|
| Direct redirect | After installation |
| Shopify admin | Apps → Select ACI Worldwide |
3. Configuration Overview
You must configure the plugin before accepting payments.
There are two main sections:
- General Settings
- Payment Page Customisation
4. General Settings (Required Fields)
| Field | Description | Required |
|---|---|---|
| Entity ID (Test) | Test merchant/channel ID from QashPay BIP Portal | Yes |
| API Key (Test) | Test API key from QashPay BIP Portal | Yes |
| Test Mode | INTERNAL or EXTERNAL (test only) | Yes |
| Entity ID (Live) | Production merchant ID | Yes (for go-live) |
| API Key (Live) | Production API key | Yes |
| Webhook URL | Auto-generated (read-only) | Yes |
| Webhook Decryption Key | Provided from QashPay BIP webhook setup | Yes |
| Merchant Name | Displayed on payment page | Yes |
📌 Notes:
- Test Mode determines whether payments are simulated or redirected externally (e.g. Visa).
- Webhooks must be configured in the QashPay BIP Portal using the provided URL.
- QashPay BIP > Select Channel > Administration > Webhook
Configure Webhook
Follow the steps below to configure the webhook in the QashPay BIP Portal:
| Setting | Value / Action |
|---|---|
| URL | Copy and Paste from Shopify - Webhook URL |
| Notification Types | Select the notification types required by your business |
| Fields to Include | Select the fields required by your business |
| Secret for Encryption | Copy this value and paste it into the “Webhook Decryption Key” field under General Settings in Shopify (see sample configuration) |
| Wrapper for Encrypted Notification | Select JSON |
| Emails | Enter email addresses to receive webhook notifications |
5. Payment Page Customisation
| Field | Description |
|---|---|
| Terms & Conditions URL | Link shown on checkout |
| Privacy Policy URL | Link shown on checkout |
| WPWL Customisation | Advanced JS customisation https://qashpay.docs.oppwa.com/integrations/widget/advanced-options |
| Logo URL | Payment page logo |
| Logo Width / Height | Size of logo |
| Background Image | Checkout background |
| Merchant Name Colour | Text colour |
| Amount Colour | Price display colour |
| Pay Button Colour | Button colour |
| Pay Button Text Colour | Button text colour |
📌 Customisation uses QashPay COPYandPAY widget options https://qashpay.docs.oppwa.com/integrations/widget/customization.
6. Saving Configuration
| Step | Action |
|---|---|
| 1 | Complete all required fields |
| 2 | Click Submit |
| 3 | Confirm “Settings updated” message |
| 4 | Click Return to Shopify |
7. Enable Payments in Shopify
| Step | Action |
|---|---|
| 1 | Go to Shopify → Settings → Payments |
| 2 | Locate ACI Worldwide |
| 3 | Click Activate |
| 4 | Enable Test Mode (optional) |
Once activated, the payment option will appear at checkout.
8. Payment Capabilities
Supported Operations
| Operation | Supported |
|---|---|
| Authorisation | ✅ |
| Debit | ✅ |
| Capture (Full / Partial / Multiple) | ✅ |
| Refund (Full / Partial / Multiple) | ✅ |
| Reversal (Full) | ✅ |
Not Supported (Key Items)
| Feature | Status |
|---|---|
| Apple Pay / Google Pay | ❌ (Shopify limitation) |
| Recurring payments | ❌ |
| Tokenisation (native) | ❌ |
9. Payment Methods & Coverage
| Category | Details |
|---|---|
| Cards | Visa, Mastercard, Amex |
| Alternative Methods | Supported via QashPay (depends on setup) |
| Countries | All Shopify-supported regions |
| Currencies | All |
10. QASHPAY BIP Portal Setup (Important)
To complete setup:
- Configure merchant accounts
- Enable payment brands
- Set up webhooks
- Ensure Shopify processing is enabled
👉 Contact QashPay support if unsure on support@qashpay.com
11. Testing
| Mode | Description |
|---|---|
| Test Mode | Simulated transactions |
| Live Mode | Real payments |
✔ Always test before going live.
12. Troubleshooting
| Issue | Likely Cause | Fix |
|---|---|---|
| Payments not showing | App not activated | Enable in Shopify Payments |
| Transactions failing | Wrong API / Entity ID | Verify credentials |
| Webhooks not working | Not configured in BIP | Set webhook URL |
| Missing payment methods | Not enabled in BIP | Contact support |
13. Best Practices
- Always start in Test Mode
- Double-check API credentials
- Configure webhooks early
- Confirm payment methods in QashPay BIP Portal
Related to
Comments
0 comments
Article is closed for comments.