Overview

This guide describes how to integrate Resolve into your Magento eCommerce platform so you can provide Resolve as a payment option to your customers. After integrating Resolve, your Magento site will:

• Offer Resolve as payment option on the checkout page

• Process Resolve charges in your order management system

The integration steps are:

1. Install the Magento 1 extension

2. Retrieve keys

3. Configure Resolve as a payment method

4. Review your order management functions

5. Test your integration

6. Go live with Resolve

Instructions

Before you begin

Before beginning integration, you should review:

• ​Magento release notes​

• ​The transaction flow when buying with Resolve​

• Your current checkout process to understand how Resolve will affect operations and customer experience

Request a merchant sandbox account

Develop and test the Resolve integration in your development environment connected to our sandbox. To get started, reach out to your Resolve account manager to request sandbox API credentials.

Create a sandbox customer account

Go to https://app-sandbox.resolvepay.com/<your_merchant_id> and submit a test customer application. Resolve will approve your sandbox buyer account for testing purposes.

1. Install the Magento 1 extension

You have 3 options for installing the Magento 1 Resolve extension. Click here to upgrade your Magento 1 extension.

Install using modgit​

cd MAGENTO_ROOT
modgit init
modgit -i extension/:. add magento-resolve https://github.com/paywithresolve/magento-resolve.git

Install using modman​

cd MAGENTO_ROOT
modman clone https://github.com/paywithresolve/magento-resolve.git

Install using Magento Connect Manager

1. Download the latest package release (compressed TGZ file)

2. In the Magento admin panel, go to System > Magento Connect > Magento Connect Manager

3. Click Choose File and select the downloaded package release file

4. Click Upload

​ ​

2. Retrieve keys

Your Merchant ID and Secret API Key are available in your merchant dashboard. Just go to the Settings tab then choose "Integrations" from the sidebar on the left side of your screen. Your merchant ID and key are under the Direct API section. Be sure you're logged into your sandbox merchant dashboard if you are configuring your sandbox integration. You'll need to log into your production dashboard to retrieve these credentials when you're ready to go to Production.

3. Configure the Resolve payment method

Once you've installed the Resolve extension, Resolve can be easily enabled as a payment method by updating the following configurations:

1. Log in to your Magento Admin portal

2. Visit System > Configuration > Sales > Payment Methods > Resolve

3. Set Enabled to Yes

4. Keep the Mode set to Sandbox for development and testing

5. Enter the Merchant ID that you retrieved from the Resolve

6. Enter the Secret API Key that you retrieved from the Resolve

7. If you currently automatically capture, change the Payment Action to Authorize and Capture

8. Adjust the order-total minimum and maximum options to control when Resolve is shown to your customers; Dollar amount, by default, Minimum Order Total is set to 10 & Maximum amount is set to 50000

9. If you want to change the order of displaying Resolve as a payment method during checkout, enter a number in Sort Order greater than 0

10. If you want to disable Resolve when a backordered item is in the cart, change the Disable for backordered items to Yes

11. If you want to change the appearance of Resolve to display as text instead of a logo during checkout, change Plain Text Appearance to Yes

If you have problems with the changes not showing up immediately

Here is how the Resolve settings configuration will look

1. Visit System > Cache Management

2. Click Flush Magento Cache

3. Log out and log back in to reset permissions

4. Order Processing

When a customer completes checkout with Resolve as the payment method, Resolve authorizes a charge for the amount of the order. The charge appears in a pending state on the customer's Resolve account.

Resolve dashboard

The main screen of your Merchant Dashboard lists recent transactions and allows you to search and filter results. You can see the date the charge was confirmed, customer name, charge status, and total charge amount.

1. Sign in to the Resolve dashboard.

2. To view information about each charge, click All charges.

Magento

• Capture - This action charges the authorized amount to the user's Resolve account.

  • Triggers the customer's billing cycle for the charge

  • Triggers the funds to be transferred from Resolve to the merchant

  • Setting the Payment Action to "Authorize and Capture" will auto-capture transactions for you

• Cancel - This action cancels the authorization for the charge before it has been captured.

  • Note: This action cannot be reversed.

• Refund - This action reverses a charge and refunds the amount to the user's Resolve account

  • Note: This action cannot be reversed.

• Partial Refund - This action reverses part of the charge and refunds the specified amount to the user's Resolve account.

  • Note: This action cannot be reversed.

  • Payments tare refunded on whatever instrument that the customer used for payment

  • Refunds may only be processed within 120 days of captured charge

5. Test your Resolve configuration

Test your configuration to ensure that everything is working before you go live. Email help@resolvepay.com with a link to your test site so that we can verify your configuration and provide you with production keys.

1. Add an item to the cart on your test site.

2. Proceed to checkout.

3. During checkout, enter valid U.S. addresses and mobile-phone information. Resolve cannot test your configuration if the address or phone information is fake.

4. Select Resolve as the payment option.

5. Proceed to Resolve's testing environment checkout.

1. Log in as customer.

2. Confirm your payment.

3. Wait to ensure that you have been redirected to your confirmation page.

4. Verify that the transaction appears in your platform's admin panel and on https://app-sandbox.resolvepay.com/dashboard.

6. Go live with Resolve

After you verify that your configuration is working properly in the Resolve Sandbox environment, your Resolve Client Success Manager will activate your Resolve Live environment access. This will allow you to sign into the Live version of the Merchant Dashboard.