--- title: "Converge API User Credentials" slug: "converge-api-user-credentials" description: "Learn how to set up CivicPlus Payments with Converge, including API user details and terminal associations for seamless integration." updated: 2025-11-06T18:20:51Z published: 2025-11-06T18:20:51Z canonical: "www.civicplus.help/converge-api-user-credentials" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Converge API User Credentials When setting up your connections between CivicPlus Payments and Converge, you will need to give the API user and PIN associated with each terminal. This article will explain what CivicPlus needs and how to get it. ## Disclaimer This article is provided for information and educational purposes only. If you are having trouble following the steps in this guide, please reach out to [Converge’s support team](/civicplus-help-center/docs/converge-support). ## About API Users Converge has two types of users: API users and normal users. Normal users can log in to the Converge portal and have a username and password. API users cannot log in to the Converge portal and have a user ID and PIN. API users can only be used for interacting with Converge’s API. When having Converge set up your API users, make sure that you get the API user’s ssl_user_id and ssl_pin. The integration needs the values, and you will be required to give these to CivicPlus. Please do not ever give out direct login information to the Converge portal to CivicPlus. It will not work with the integration and is something you need to keep securely. --- ## Instructions 1. Log in to Converge ![Converge sign in](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4422626332055.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A05Z&se=2026-11-22T14%3A15%3A05Z&sr=b&sp=r&sig=2ABYbGRyWCRiHCgpYvg7k21mNQLWOCW5HaN7wkovSgE%3D) 2. To confirm that you have registered API users go to **Settings**, **Online API Security Allowed List Manager** ![settings tab, online API security allowed list manager button](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4422622214039.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A05Z&se=2026-11-22T14%3A15%3A05Z&sr=b&sp=r&sig=wbsb01InErgTsJYopktj%2FhJyj1Ed%2F1WAEd9rIS1RxGQ%3D) 3. Click on **Registered API Users** ![registered API users button](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4422626334743.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A05Z&se=2026-11-22T14%3A15%3A05Z&sr=b&sp=r&sig=Hf%2BXGfQBY6TWMADeM98kBrULRQMmRNQklVp6DHJ0lSI%3D) > [!WARNING] > **Note**: If you do not see any API users listed, please see the [Instructions for Calling Converge](/civicplus-help-center/docs/set-up-converge-for-payments#Call_Converge). You will not be able to continue until this is complete. 4. Copy the name of the **API user**. This is the ssl_user_id that you will need to give to CivicPlus. ![copy API user name](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4422622211735.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A05Z&se=2026-11-22T14%3A15%3A05Z&sr=b&sp=r&sig=j957IqCzHRs3tlcPYfdRlnD5dLd55kIVBQXk4rWH2ZA%3D) 5. Navigate to the **Employees** tab and click on the **Employee ID** that matches the user ID above ![employees tab, select matching Employee ID](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4422626332439.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A05Z&se=2026-11-22T14%3A15%3A05Z&sr=b&sp=r&sig=MuTrPfSf16bMGhBBnUtcdW0SgOBEMZgAX7MF9yQdMvk%3D) 6. In the area that says **Associated Terminals** you should see one or more terminals listed, click on **Show PIN![show PIN button](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4422622214679.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A05Z&se=2026-11-22T14%3A15%3A05Z&sr=b&sp=r&sig=H0n8sns2upp5vyPMLCwFU%2Fgqz%2BcclSe%2F5jQaFiLUqyQ%3D)** 7. Copy the PIN and give it to CivicPlus ![Copy the PIN](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/4422622211991.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A05Z&se=2026-11-22T14%3A15%3A05Z&sr=b&sp=r&sig=O0tnIR%2B6MDs0ExbLFfwe8vSfMlEJUu6cOINN%2F28F71o%3D) > [!WARNING] > **Note**: Please copy + paste instead of taking a screenshot to ensure accuracy. 8. You should now have both the **API user ID (ssl_user_id)** and the **API PIN (ssl_pin)** > [!WARNING] > **Note**: When completing step 7, if more than one terminal is listed, it is imperative that you document which PIN goes to which Terminal and if it is a Retail or Internet terminal. Application Programming Interface. A set of rules that allows programmers to develop software for a particular operating system without having to be completely familiar with that operating system. Personal Identification Number. Identification or Identifier.