Customer View

Below you will find an overview of the most important features in the daily usage of the Converge Plugin.

error_outline
important

The transaction management between Converge and your shop isn't synchronized.

Any action performed directly through Converge back office will not be synchronized with Magento. To keep record in both places, you must initiate actions such as capture, delete etc... from your Magento back office only.

Placing an Order

To capture new Authorization Only transaction using Converge Payment plugin you need to make sure that payment action option is set to Authorize along with other options:

  • Enabled = Yes
  • Environment = Sandbox (if this is a test transaction)
  • Merchant ID, API User ID, User PIN = ID information provided by Converge
  • Payment Action = Authorize

For Authorization and Capture transaction only one option should be changed:

  • Enabled = Yes

  • Environment = Sandbox (if this is a test transaction); Merchant ID, API User ID, User PIN = ID information provided by Converge

  • Payment Action = Authorize and Capture

Payment procedure is similar for guest and logged in user, with only exception that logged in user has option to save credit card for later use.

To initiate actual payment via Converge you will have to access Checkout page from Magento store view. After you populate Shipping Address (for products with weight) and click on the next button you will be presented with Review and Payments page where you can select Converge Gateway as payment method.

*Figure 0-29 Magento Store - Review & Payments screen*

Payment with HPP

If HPP is selected in the configuration page, once you select Converge Payment you will be presented with several additional options:

  • option to use previously entered Shipping Address as Billing Address
  • option to Place Order
  • option to Save card for later use (for logged in user only)


*Figure 0-30 Magento Store - Converge Payment options -- HPP (logged in user)*

Place Order button will open HPP:



*Figure 0-31 Actual HPP screen may vary depending on the options enabled in Converge*

error_outline
note

To Customize the Converge Hosted Payment Page, please refer to the Converge User Guide. From this page you will have the option to:

  • Cancel Payment or

  • to proceed to next step screen of HPP

HPP - Cancel payment

For Cancel button to work you need to set actual link where the click on this button will lead you.

Please refer to the Converge User Guide to configure the Cancel URL.

Best practice is to set this link to return to payment methods:

  • Magento_base_url/checkout/#payment (make sure that you are making changes for appropriate terminal indicated in the upper right corner)

HPP -- Checkout

If you do not want to Cancel your payment, you need to click on the Checkout button.

*Figure 0-32 HPP - Checkout screen with Billing and Shipping address carried over from Magento*

Once you reach the next step of payment process on HPP you will be presented with page that will be automatically populated with Shipping and Billing details from Magento, and the user will have option to change them directly on HPP.

After you enter card details you should scroll down to Submit Payment button. Two possible outcomes can happen after you click on Submit Payment button:

  • Payment is Declined

  • Payment is Accepted

HPP Checkout -- Declined

If the payment is declined, error message is displayed to the user and he will be presented with two options:

  • RETURN TO MERCHANT
  • TRY AGAIN

*Figure 0-33 HPP - Declined payment*

Return to Merchant

When payment is declined, user will have option to return to Magento by clicking on RETURN TO MERCHANT button. For this button to work you need to make additional changes in the Converge-Back office.

Please refer to Converge User guide to configure the Cancel URL

There you will need to set return to merchant link, and best practice is to set this link to return to cart page:

  • Magento_base_url/checkout/cart (make sure that you are making changes for appropriate terminal indicated in the upper right corner)

Try Again

When payment is declined, user will have option to re-enter card details or to try again with same card again by clicking on TRY AGAIN button. You will be presented with same page as if you have reached the HPP Checkout screen for the first time and the possible outcomes will also be the same.

HPP Checkout -- Accepted

When your payment is accepted by Converge, you will be redirected back to Magento and new order will be created. For this to happen you need to set approval link in Converge-Back office.

Please refer to the Converge User Guide to configure the Return URL This link needs to be set to the following location:

  • Magento_base_url/converge/payment/iframeresponse

Once link is updated, you should be re-directed back to Magento after each successful payment on HPP. In Magento you should see the number of newly created order:

*Figure 0-34 Magento Store - Order Created*

You will find more details on how to see payment details and how to manage captured transactions in section describing the use of Magento Admin.

Payment with Checkout.js

If Checkout.js is selected in the configuration page, once you select Converge Payment you will be presented with several additional options:

  • option to use previously entered Shipping Address as Billing Address

  • option to Place Order

  • option to Save card for later use (for logged in user only)

Also, based on other options selected in the configuration page, the following options are available:

  • payment with credit card, where you should provide the following details: Credit Card Number, Expiration Date and Card Verification Number

*Figure 0-35 Magento Store - Converge Payment options -- Checkout.js -- Credit card (logged in user)*
  • Payment with gift card, where you should provide the following details: Card number and Expiration Date.

*Figure 0-36 Magento Store - Converge Payment options -- Checkout.js -- Gift card (logged in user)*
  • Payment with Electronic Check (ACH), where you should provide the following details: Bank Routing/Transit Number, Bank Account Number, Check Number, Bank Account Type, First Name, Last Name and to agree to the displayed message.

*Figure 0-37 Magento Store - Converge Payment options -- Checkout.js -- ACH (logged in user)*

Stored Card

Add Card

Logged in users have additional option to store credit card used for payment on HPP, so it can be used for future payments without leaving Magento store.

To do this user has to have active account created in Magento store and he needs to be logged in before he reaches checkout page. In that case, on the checkout page, user will see additional option to store card for later use:

*Figure 0-38 Magento Store - Store credit card for later use*

Once you make successful payment, with this option selected, you will save the card used to process payment in both Converge and Magento.

To view card stored in Magento you should navigate to the following screen:

  • Magento Store (Logged In) -> My Account -> Stored Payment Methods

*Figure 0-39 Magento Store - Card stored in Magento*

Delete card

You have an option to delete stored card directly from Magento, by clicking on the Delete button next to the card, and the card will also be deleted from Converge. If merchant deletes card from Converge, synchronization with Magento does not exists so user will still be able to see the card in Magento with an option to delete it manually.

Pay with stored card

Once the card is stored, you can use it to initiate a payment. To do that, perform the same steps as for HPP payment for the logged in user until Review & Payments screen. New section with the option to select stored cards will be visible and once you select one of the stored cards Place Order button will appear:

*Figure 0-40 Magento Store - Stored Card checkout*

Once you click on the Place Order button, API call to the Converge will be made in the background, and depending on the response we will get:

  • Error message -> in case when the payment is declined by Converge

  • Newly created order number -> in case when the payment is accepted by Converge

3D Secure

If 3DSecure is enabled within your plug-in configuration, as soon as the customer clicks Place Order a request is sent to ConvergeGateway to check that their card is enrolled in 3DSecure.

If their card is not enrolled in 3Dsecure the authorization will be processed as usual. Data within the authorization message will notify ConvergeGateway that the check was performed and that the cardholder was not participating.

If the cardholder is participating, they will be redirected to their issuing bank’s Access Control Server (ACS). This is the page where the customer enters the passphrase associated with their card. The customer will be redirected to either the success or failure page, depending on whether the 3Dsecure outcome falls under the allowed scenarios.

Wallets

If the terminal support wallets, the list of available wallets will be displayed at checkout.

*Figure 0-41 Magento Store -- Checkout with online wallets*

Visa Checkout

After selectin the Visa Checkout option, you will be redirected to the login page. You can continue as a new or a registered customer.

*Figure 0-42 Magento Store -- Login page for Visa Checkout*

If you sign in as a register customer and click on the "Sign in to Visa Checkout" button, the next page will contain information about the card and delivery address. You can add additional information or edit the current one.

*Figure 0-43 Magento Store -- Checkout with Visa Checkout*

Once you click on continue, you will be redirected to Magento. If the payment was successful, you will see the number of the new order.

PayPal Checkout

After selectin the PayPal Checkout option, you will be redirected to the login page. You can continue as a new or a registered customer.

*Figure 0-44 Magento Store -- Login page for PayPal Checkout*

If you select the Pay with Debit or Credit card option, you can check out as a guest.

*Figure 0-45 Magento Store -- Checkout with PayPal Checkout as a guest*

If you checkout as a logged in user, clicking on the Log in button will take you to the page where you have the list of payments options.

*Figure 0-46 Magento Store -- Checkout with PayPal Checkout as a logged in user -- payment option*

After choosing a payment method, the new page will review the shipping details and the chosen payment option.

*Figure 0-47 Magento Store -- Checkout with PayPal Checkout as a logged in user -- review payment details*

Once you click on continue, you will be redirected to Magento. If the payment was successful, you will see the number of the new order.

PayPal Credit

After selectin the PayPal Credit option, you will be redirected to the login page. You can continue as a new or a registered customer.

*Figure 0-48 Magento Store -- Checkout with PayPal Credit*

If you select the Create an account option, you can check out as a guest.

*Figure 0-49 Magento Store -- Checkout with PayPal Credit -- create an account*

If you checkout as a logged in user, clicking on the Log in button will take you to the page where you have the list of payments options.

*Figure 0-50 Magento Store -- Checkout with PayPal Credit as a logged in user*

Once you click on continue, you will be redirected to Magento. If the payment was successful, you will see the number of the new order.

View Order Details

After successful payment, order details can be seen by navigating to the following screen:

  • Magento Store (Logged In) ->My Account->My Orders->View Order

In case of Authorization Only transaction, Invoice details will not be visible as it has to be created first.

In case of Authorization and Capture transaction invoice details will be visible as the invoice is created automatically for this types of transactions.

*Figure 0-51 Magento Store - Order details 1/2*

*Figure 0-52 Magento Store - Order details 2/2*