Shopify

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

🚧

New Plugin & Migration Notice

The following steps below are for the new Checkout plugin for Shopify. If you are using the older plugin - Pay via Credit/Debit Card & PayMaya Wallet, read the migration guides here.

Step 1

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

Step 2

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

Step 3

Click Install App

Step 4

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 2.0

Step 5

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

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

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

Click “Activate” (Make sure that “Enable test mode” is NOT checked).

Step 9

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

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.