Shopify

Install and set up the Shopify plugin with emerchantpay.

---

Accept payments with the emerchantpay Payments app for Shopify.

Shopify storefront demo(select Enter using password and type in @ccessc0de)

Within Shopify, follow these instructions to process card payments through the emerchantpay Genesis payment gateway.

Supported payment methods:

• Alternative Payment Methods
• Online Banking (oBeP)
• Wallets
• Vouchers
• Cash Payments

---

Prerequisites

---

Installation

Install the emerchantpay Payments app in Shopify:

1. Open the emerchantpay Payments app in the Shopify app store.
2. Select Add app.
3. Log in using your Shopify credentials and select your storefront.
4. Review the privacy and permission details, and select Install app.
5. At the bottom of the resulting emerchantpay Payments window, select Activate emerchantpay Payments.
   

   If you do not see an Activate emerchantpay Payments button or it is disabled, contact emerchantpay support to ensure that your storefront ({storename}.myshopify.com) is added. After your storefront is added, install emerchantpay Payments using Manual installation.

---

Configuration

1. Log in to the Shopify admin portal.
2. In the navigation menu, go to Settings, then select Payments.
3. In the Additional payment methods section, find emerchantpay Payments, and select Manage.
4. Select the payment methods that you would like to accept.
5. Toggle Enable test mode to specify whether transactions go through the emerchantpay staging or emerchantpay production environments.
6. Select Save to confirm your changes.

You are now ready to test your Shopify integration in the emerchantpay staging environment.

Optional: Specify a payment capture method

Be default, orders in your store are captured automatically. To change the payment capture method follow these steps:

1. In the navigation menu, go to Settings > Payments.
2. In the Payment capture section, select Manage.
   
3. Choose between automatic and manual, and select Save.

---

Test your integration

Before you can start accepting live payments from customers, you need to test your integration in the emerchantpay staging environment.

1. In your storefront, add an item to your cart.
2. In your cart, select Check Out.
3. Fill in test values for the required billing fields.
4. Ensure that emerchantpay Payments is selected under Payment and select Complete order.
5. Enter in the following card payment credentials:

   Test cards

   Enter the following test card numbers in the checkout screen to test your integration. For the other fields enter:

   • Any cardholder name
   • Any future expiration date
   • A random 3-digit CVV number

   Test card number	Card Brand
   4200000000000000	Visa
   5555555555554444	Mastercard

   

   Test card numbers are for testing purposes only and will not result in any actual transfer of funds. Refer to testing for more test cards.
6. Select Pay, then select Complete VISA Secure/SecureCode.
7. On the order confirmation page, you will see an Order number in the upper left-hand corner.
8. Log in to the Shopify admin portal.
9. Select Orders in the main navigation menu. You should see your test Order number in the Order field.

You are now ready to move to the production environment where you can accept live payments from your customers.

---

Accept live payments

Once you have successfully configured and tested the Shopify plugin in the staging environment, you’re ready to configure your merchant account for the production environment and accept live transactions.

To move to the production environment:

1. Contact emerchantpay support to activate your merchant account in the emerchantpay production environment.
2. In the Shopify admin portal, uncheck Enable test mode in the emerchantpay Payments configuration options.

You are now ready to accept live payments from your customers.