Shopify

Learn about using plugins to power up your Shopify website.

Shopify offers online retailers a suite of services including payments, marketing, shipping and customer engagement tools.

With Maya Business' Checkout-Shopify plugin, your website can accept secure payments using Mastercard, Visa, e-wallets and more.

Step-by-step guide

Step 1. Account Creation

Create a Maya Business Manager 2.0 account. Once approved, you will be provided with a Merchant Account.

Step 2. Search for Maya Business Plugin

Go to https://apps.shopify.com/maya-checkout and click Add app.

Maya Business Plugin - Shopify page

Maya Business Plugin - Shopify page

Step 3. Maya Business Plugin Installation

Click Install App

Step 4. Accessing the API Keys

For Manager 1.0

To activate your Maya eCommerce Plugin, you will need to generate API Keys and a Shopify Token from your Maya Business Manager 1.0 or 2.0. Log in to your Maya Business Manager 1.0 or 2.0, select API Keys and enter your Merchant ID to generate the API Key you will use to set up your Shopify account.

For Manager 1.0

For Manager 1.0

For Manager 2.0

For Manager 2.0

For Manager 2.0

Step 5. Generating the API Keys

Manager 1.0

From your Maya Business Manager dashboard, generate your Shopify Token and a public API key.

Manager 2.0

From your Manager 2.0, go to Solutions and choose PayMaya Checkout. You can Generate your Shopify key from the dashboard.

Step 6. Input keys on Maya Business Plugin installation

Enter the Public API Key, Shopify Token and Website URL.

📘

Masked vs Unmasked Key

Full unmasked keys are shown only once during creation.

Masked Key: pk-masked****

Unmasked Key: pk-unmaskedkey123

Step 7. Review your installation

On the Shopify dashboard, the Payments section will also show that you are fully connected to "Credit/Debit Cards and e-Wallets" plugin.

Please make sure to tick the payment schemes (e.g. Visa, Mastercard and other) if applicable.

Step 8. Activate Maya Business Plugin

Click Activate Pay via Credit/Debit Card & PayMaya Wallet V2

🚧

Disable Test mode

Make sure that “Enable test mode” is NOT checked.

Step 9. (optional) Setting Payment Capture

Back on Shopify's Settings Page, navigate to Payments. Make sure the Payment Capture is set according to your Maya Manager's Auth and Capture setting.

  • If your Maya Manager's Auth and Capture settings is off, your Payment capture setting in Shopify should only be Automatic.
  • If your Maya Manager's Auth and Capture settings is on, your Payment capture setting in Shopify can either be Automatic or Manual. Manual Payment capture will mean extra steps on your Shopify before finalizing the transaction.

Step 10. Configuring Shopify's Checkout

For Kount merchants, navigate to Checkout. Make sure that Email is used for checking out, and both first name and last name are required.

Troubleshooting

  • If a customer is experiencing payment issues due to insufficient funds or transactions that have expired on any payment options, Shopify recommends asking them to refresh their cart before trying to transact again.