---
title: "Elavon Converge for HBook"
canonical: "https://maestrel-resource-center.refined.site/space/PGD/71106561/Elavon%20Converge%20for%20HBook"
format: markdown
---
## 1. Activate Elavon Converge as payment gateway

- Once you have activated Elavon Converge  plugin, you need to **validate the licence** in **HBook > Licence**.
  
- Set Elavon Converge as active payment gateways in **HBook > Payment > Active payment gateways.**

## 2. In HBook, add Elavon Converge credentials

You will need to add the “Merchant ID”, “User ID”, “Pin” in **HBook > Payment > Elavon Converge settings**.


![converge-settings.png](media://8051fc33-70ee-45e1-8c98-8cbe7816c88d)


### How to create a Sandbox/Demo Elavon Converge account?

- To create a **Sandbox/Demo** Account, you would need to contact Elavon Converge. You can check what information you need to provide [https://developer.elavon.com/products/hosted-payment-page/v1/overview](https://developer.elavon.com/products/hosted-payment-page/v1/overview). You will need to communicate **your IP address, website URL, and the URL for the Exports script.**
- The **URL for the Exports script** will always be created using the following structure: https://mysite.com/confirmation-converge, by changing “mysite.com” to your own domain name.

### Where can I find the PIN for the Elavon converge account?

The PIN is associated to the user of the terminal. Go to **Employees**, then select the User. You will be able to find the PIN.

![converge-pin.png](media://9ca98b1b-9373-4c20-9793-197b2ebe2381)

### How can I customize the Payment form on Elavon converge?

- Go to **Settings > Advanced API Settings > Hosted Payments**

![converge-custom1.png](media://7b25ddf8-20e1-4b3c-9b2f-b7636fd982f3)

- We use the “Payment modal”. Click on **Set up**.
- You can now add customize the payment modal form. We recommend that you add your logo for a better user experience.

![converge-custom2.png](media://a88ca62c-b888-4b0c-bdbc-9613bcd6e4ff)

### Which Test cards to use?

You can find the test card details [on this page](https://developer.elavon.com/products/converge/v1/test-cards).

### What to do when moving from Sandbox to Live for Elavon Converge?

You will need to make sure that you contact Elavon to provide them with **your IP address**, **website URL**, and the **URL for the Exports script**.

> ℹ️ Please note that the “URL for the Exports script” can not be local, and it needs to be accessible. For example, if you have a “Maintenance” or “Coming soon” plugin, the notification will not work and HBook will not be able to get the results of the transaction.