--- title: "Converge Saved Payment Methods" slug: "converge-saved-payment-methods" description: "Learn how to tokenize cards with Converge's Commerce Web Services and set up a shared token vault for seamless payment processing across terminals." updated: 2025-11-06T18:29:30Z published: 2025-11-06T18:29:30Z canonical: "www.civicplus.help/converge-saved-payment-methods" --- > ## 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 Saved Payment Methods Converge allows for the tokenization of cards through both their Commerce Web Services and Hosted Payment Pages APIs. For example, for card-present and card-not-present transactions. For more information on how this works in CivicPlus Payments, see our [Saved Payment Methods article](/civicplus-help-center/docs/saved-payment-methods). ## Disclaimer This article is provided for informational 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). ## Shared Token Vault It is recommended that before you start collecting saved payment methods, you instruct Converge to set up a shared token vault across all of your terminals. This will allow a user to save a card through one terminal but use it at another. If you do not have this setting on, you will run into processing issues. If you only have one terminal, for example, if you only take e-commerce transactions, then setting this up in advance is not as important. However, if you were to add more terminals in the future, you would lose all the cards you had collected. This is because Converge does not have a way to move cards from a single terminal vault to a shared vault and keep the same token IDs. Since the IDs change, the connection between CivicPlus Payments and Converge is severed. --- ## Viewing Your Stored Payment Methods Cards-on-File saved through CivicPlus Payments can be seen under **Customers** in **Converge**:![Customers tab.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639082883095.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=AHoQe2Fwl5uG2sFv%2Bxi8iaWQolszmYDlmDNqE8ueVWc%3D) --- ## Customer Names You may see numbers in place of customer names in the **Customers section** of **Converge**. This occurs when the cardholder's name cannot be read off the card. This is typical for contactless and manually entered transactions.![List of customer numbers.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639079431703.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=0UC8UPyyhKgc4oE6sjim22NrWupYs0pZ51uJVLbcOCc%3D) --- ## Troubleshooting ### Card Brand Showing as Unknown If all of your saved cards are showing as "Unknown" for the card type, it may be because Converge is not configured to send this information to Payments. To fix this, double-check that you have the Card Short Description set to "Forward on Approval" and "Forward on Decline." 1. Log in to your **Converge** account 2. Select **Settings**, then select **Payment Fields**: ![Settings, Payment Fields option.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639185422103.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=0%2FYWVZ2aFPGw1cDke1ZTzNaGeOIbTh0zrnYXM2RHIys%3D) 3. Click the **Edit** icon next to the **Card Short Description** field: ![Card Short Description Field, Edit Button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639185374487.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=z20giL4t%2FlyNu9x9u20f1D3KL9%2FwixaqwYIRi3ieERA%3D) 4. Make sure that the **Forward on Approval** and **Forward on Decline** checkboxes are checked: ![Forward on approval and decline.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639185373719.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=EcIz3SgsoRQabwPZyqSC9WoWlPfLL39uY3bS2obvplY%3D) 5. If you have made any changes, click the **Update** link: ![Update button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639230504087.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=%2FTXeugs3OkXNfhoCpw4fIlmXMaN7dvPMrxdFYbeZFiw%3D) 6. Be sure to click the green **Save** button following the section: ![Save button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639230443031.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=brA6W0Qgd3sWobx7UA%2BTgkIa9%2Bm6dXuVMDZTH213CDY%3D) ### Saving a Payment Method Outside a Transaction When trying to save a payment method outside a transaction, you will want to be sure that you have two specific custom fields added to Converge, or the request to save the payment method will fail: ![CivicPlus Payments Error Page.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/1500007634402.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=bBqE4ItIJP54uzlnoXzzX1iXZ%2BRCJF%2B3eYTK3WItJNo%3D) The two fields you will need are **CP Form Type** and **CP Form ID**: 1. Log in to your **Converge** account 2. Navigate to **Settings**, then select **Payment Fields**: ![Settings, Payment Fields option.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639185422103.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=0%2FYWVZ2aFPGw1cDke1ZTzNaGeOIbTh0zrnYXM2RHIys%3D) 3. In the order section, click the **Add Payment Field** button: ![Add a payment field button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/24596994108439.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=TDYB2tn9BWn60ksNv1CUdgUDIIOJqzKZsL0ySPcnEpE%3D) 4. Fill out the following fields for the **CP Form Type** field. Be sure to make them match exactly, spelling and case matter: ![Add Payment Field, CP Form Type Fields.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639326358935.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=EPUfpGRWxOmeFmFaUU%2FkxJBw2VRUOjXUA%2F9wKQXUbYQ%3D) - **Name**: cp_form_type - **Display Name**: CP Form Type - **Display Name French**: CP Form Type - **Section**: Order Section - **Field Type**: Text - **Minimum Number Characters**: 1 - **Maximum Number Characters**: 50 5. Check the **Forward on Approval**, **Forward on Decline**, and **Show on Export Script** checkboxes: ![Forward on Approval, Forward on Decline, and Show on Export Script Checkboxes.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639326335511.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=r%2FUuAP8i%2FglxixOTbOlOujG0sXJrjPA2Bmp4L1lHeAM%3D) 6. Click the **Add** button: ![Add Field Button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639326321175.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=yXgtXnT%2FMOBJK8HlFhp4xyAE%2FzqWzi%2Bt0EOFmfOvf3E%3D) 7. Select the **Add Payment Field** button to add another field by **repeating steps 2 through 5**, this time for the **CP Form ID** field: ![Add payment field option.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/24596994108439.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=TDYB2tn9BWn60ksNv1CUdgUDIIOJqzKZsL0ySPcnEpE%3D) 8. Fill out the fields with the following information: ![CP Form ID Fields.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639461817879.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=0RZqXwIHZ%2B5PCjXT1ukprjtLu9KPlf3xiEj3lPWBxtQ%3D) - **Name**: cp_form_id - **Display Name**: CP Form ID - **Display Name French**: CP Form ID - **Section**: Order Section - **Field Type:** Text - **Minimum Number Characters**: 1 - **Maximum Number Characters**: 50 9. Check the checkboxes for **Forward on Approval**, **Forward on Decline**, and **Show on Export Script**: ![Forward on Approval, Forward on Decline, and Show on Export Script Checkboxes.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639326335511.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=r%2FUuAP8i%2FglxixOTbOlOujG0sXJrjPA2Bmp4L1lHeAM%3D) 10. Click the **Add** link: ![Add Field Button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639326321175.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=yXgtXnT%2FMOBJK8HlFhp4xyAE%2FzqWzi%2Bt0EOFmfOvf3E%3D) 11. Click the **Save** button: ![Add Payment Field, Save Button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639230443031.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=brA6W0Qgd3sWobx7UA%2BTgkIa9%2Bm6dXuVMDZTH213CDY%3D) 12. You should now have a total of three custom fields: ![CP Trans ID, CP Form Type, and CP Form ID Custom Fields.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/10639523072151.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A15%3A09Z&se=2026-11-22T14%3A15%3A09Z&sr=b&sp=r&sig=t7TAoxLTr1%2FHSOQY1%2Fx2RTYWIaPBfXP08YLiKnPhip4%3D) 13. You are now ready to try saving a payment method again 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. Identification or Identifier.