Customer View
Below you will find an overview of the most important features in the daily usage of the Converge Plugin.
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.
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)
Clicking Place Order opens HPP.
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 the Checkout button.
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
Return to Merchant
When payment is declined, user will have option to return to Magento by clicking RETURN TO MERCHANT. 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 has the option to re-enter card details or to try again with same card by clicking the TRY AGAIN button. You will be presented with the same page as if you have reached the HPP Checkout screen for the first time and the possible outcomes are also 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:
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
Payment with gift card, where you should provide the following details: Card number and Expiration Date.
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.
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, the user has to have an active account created in the Magento store and they need to be logged in before reaching the checkout page. In that case, on the checkout page, user will see an additional option to Store 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
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:
Once you click the Place Order button, an API call to Converge is made, 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 supports wallets, the list of available wallets will be displayed at checkout.
PayPal Checkout
After selecting the PayPal Checkout option, you will be redirected to the login page. You can continue as a new or a registered customer.
If you select the Pay with Debit or Credit card option, you can check out 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.
After choosing a payment method, the new page will review the shipping details and the chosen payment option.
Once you click Continue, you will be redirected to Magento. If the payment was successful, you will see the number of the new order.
PayPal Credit
After selecting the PayPal Credit option, you will be redirected to the login page. You can continue as a new or a registered customer.
If you select the Create an account option, you can check out 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.
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.