---
schema_version: "1"
id: df7c660ddeaccbd495307da17b4480d33d125e2ae853b43e7b5d8cfe400799ee
title: Configure a Payment Gateway
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/commerce/264-0-0/rt_adv_config_pay_gate_config.md
canonical_url: https://help.salesforce.com/s/articleView?id=commerce.rt_adv_config_pay_gate_config.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: c62dddc39ca669fb18dc8637cb27460cb3dccc7d1bd4db6cbb81b0fb8f28ebbc
description: Configure payment gateways in Point of Sale CMS to securely process customer payments. By connecting preferred payment providers, you streamline transactions and enhance the customer checkout experience. Accept a variety of payment methods, reduce friction, and improve overall sales efficiency.
products:
  - Commerce
release: "264"
---
# Configure a Payment Gateway

Configure payment gateways in Point of Sale CMS to securely process customer payments. By connecting preferred payment providers, you streamline transactions and enhance the customer checkout experience. Accept a variety of payment methods, reduce friction, and improve overall sales efficiency.

- Modern POS App build: Depends on the Payment Gateway used by the merchant
- Platform Support: iPhone & iPad
- Offline Support: No

1. In the CMS, go to **Integrations** | **Payment Gateways**.
2. Click **CREATE** to create a new configuration.
3. Select a Payment Gateway from the dropdown or click the Edit icon to edit an existing one.
4. Complete all of the required fields and click **SAVE**.![The payment gateway option listing payment gateways, environment, fulfillment type, store ID, payment method, and device ID.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_adv_config_pay_gate_config.png) ![The payment gateway details dialog shows options for a payment gateway, environment, fulfillment type, store ID, payment method, and device ID.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_adv_config_pay_gate_config_fiields.png)

## Payment Gateway Fields

       
| Payment Gateway Fields | Adyen | Elavon | PayPal Here | Fiserv | HiPay | UTA | Verifone PSDK |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Payment Gateway | Required | Required | Required | Required | Required | Required | Required |
| Environment | Required | Required | Required | Required | Required | Required | Required |
| Fulfillment Type | Required | Required | Required | Required | Required | Required | X |
| Store ID | Required | Required | Required | Required | Required | Required | X |
| Payment Method | Required | Required | Required | Required | Required | Required | X |
| Device ID | Required | Required | Required | Required | Required | Required | X |
| Default Device ID | X | Required | X | X | X | X | X |
| URL Base | Required | Required | Required | X | Required | Required | X |
| Secondary URL Base | X | X | X | X | X | X | X |
| Merchant Gateway ID | Required | X | X | X | X | Required | X |
| Merchant Key | Required | X | Required | X | Required | Required | X |
| Merchant Secret | X | X | Required | X | X | Required | X |
| Merchant Token | X | X | Required | X | X | X | X |
| Merchant Organization ID | X | Required | X | X | X | X | X |
| Services | Required | Optional | X | X | X | X | X |
| Terminal Certificate Name Suffix | Required | X | X | X | X | X | X |
| Terminal Gateway ID | Required | Required | X | X | X | X | X |
| Terminal Username | Optional | X | X | X | Required | X | X |
| Terminal Password | Optional | X | X | X | Required | X | X |
| Terminal Key Identifier | Optional | X | X | X | X | X | X |
| Terminal Key Encryption Version | Optional | X | X | X | X | X | X |
| Terminal Key Passphrase | Optional | X | X | X | X | X | X |
| Terminal Beacon ID | Optional | X | X | X | X | X | X |
| Terminal Request Timeout Interval In Seconds | Optional | Optional | X | Optional | X | X | X |
| Payment Status Check API Timeout In Seconds | Optional | Optional | X | X | X | X | X |
| Transaction Verification Days | Optional | X | X | X | X | X | X |
| Skip Fraud Check | Optional | X | X | X | X | X | X |
| Has Cart Summary On Payment Terminal | Optional | X | X | X | X | X | Optional |
| Manual Credit Card Entry | Optional | Optional | X | X | X | X | Optional |
| Manual Payment Capture | Optional | X | X | X | X | X | Optional |
| Adyen Company Account Name | Optional | X | X | X | X | X | Optional |
| Adyen Store Code | Optional | X | X | X | X | X | X |
| Adyen Terminal Management URL Prefix | Optional | X | X | X | X | X | X |
| Pay By Link Base URL | Optional | X | X | X | Required | X | Optional |
| Pay By Link URL Expiration In Hours | Optional | X | X | X | X | X | Optional |
| Callback URL | Should Exist | X | Should Exist | X | Should Exist | X | Should Exist |

X - Not Applicable

## Common Fields

Environment: Test / Live based on if this is for a test account or live account.

Fulfillment Type: Choose DEFAULT if you wish to create this config for a POS app to perform transactions.

Store ID: Choose DEFAULT if you wish to have the same config across all stores. Otherwise, choose a particular store from the store drop-down to apply these settings to a particular store.

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_important.png)

Important

If you've yet to set up an Adyen and Point of Sale account, please ensure your StoreIDs are the same for both accounts.

If your Point of Sale account is already live but have yet to set up Adyen, please ensure your Adyen's StoreID is the same as your Point of Sale's StoreID.

If your Adyen account is already live but have yet to set up Point of Sale, please ensure your Point of Sale's StoreID is the same as Adyen's StoreID.

Payment Method: Choose CHECK if the configured payment gateway is for check flow. Otherwise, Credit Card for all other cases.

Device ID: Choose DEFAULT if you wish to have the same config across all the store devices. Enter a particular device ID to apply these settings to a particular device.

## Payment Gateway Types

The Point of Sale platform integrates with many of the most commonly used payment gateways. The following tables list the supported payment gateway types with their related configuration articles.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
          <colgroup>
            <col style="width:50%">
            <col style="width:50%">
          </colgroup>
          <tbody>
            <tr class="">
              <td class="slds-cell-wrap" style="vertical-align:top;">Supported Payment Gateway Types</td>

              <td class="slds-cell-wrap" style="vertical-align:top;">Related Articles </td>

            </tr>
            <tr class="">
              <td class="slds-cell-wrap" style="vertical-align:top;">Adyen</td>

              <td class="slds-cell-wrap" style="vertical-align:top;">
                <ul>
                  <li><a href="https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_ayden_payment_resources.htm&amp;release=264.0.0&amp;type=5" title="Integrate Adyen payment resources with Point of Sale CMS to process point-of-sale transactions. Use either Adyen SDK or Terminal API configurations for terminals."><u>Adyen Payment Resources</u></a></li>

                  <li><a href="https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_ayden_gateway_info.htm&amp;release=264.0.0&amp;type=5" title="You can configure different payment gateways at the store level, such as store-level settlements, reporting, and currency requirements and integrate Adyen into Point of Sale."><u>Adyen Payment Gateway Integration</u></a></li>

                  <li><a href="https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_ayden_enabling_beacons.htm&amp;release=264.0.0&amp;type=5" title="Beacon functionality in Adyen Terminal allows it to broadcast its presence to nearby Bluetooth devices. We use beacons in the Adyen terminals to locate them from the Point of Sale Point of Sale (POS) app and connect them to the one to carry out the particular transaction."><u>Enabling Beacons for Adyen</u></a></li>

                </ul>
              </td>

            </tr>
            <tr class="">
              <td class="slds-cell-wrap" style="vertical-align:top;">Elavon</td>

              <td class="slds-cell-wrap" style="vertical-align:top;">
                <ul>
                  <li><a href="https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_config_elavon_terminal_payments.htm&amp;release=264.0.0&amp;type=5" title="Set up Elavon Terminals to use with the Point of Sale (POS) app. The Elavon card reader terminals can process payments using Ingenico Move 5000, Lane 7000, and Link 2500 Elavon card reader terminals."><u>Elavon Payments</u></a></li>

                  <li><a href="https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_onboard_troubleshoot_elavon.htm&amp;release=264.0.0&amp;type=5" title="Configure your Elavon terminal to work with Point of Sale for secure payment acceptance, whether in-store or online."><u>Elavon Terminals - Onboarding &amp;
                        Troubleshooting</u></a></li>

                </ul>
              </td>

            </tr>
            <tr class="">
              <td class="slds-cell-wrap" style="vertical-align:top;">Paypal Here</td>

              <td class="slds-cell-wrap" style="vertical-align:top;">
                <ul>
                  <li><a href="https://help.salesforce.com/s/articleView?id=commerce.rt_adv_config_3p_int_finance_paypal.htm&amp;release=264.0.0&amp;type=5" title="Discover the process of setting up an OAuth token for a Paypal Here device and Square for use in Point of Sale. For these card readers to work, after merchants have provided initial keys, the user needs to login to CMS and invoke the Paypal and Square buttons to generate a secure token that will be used for checkout."><u>Setting up OAuth Payment Token for Paypal Here Devices
                        and Square</u></a></li>

                </ul>
              </td>

            </tr>
            <tr class="">
              <td class="slds-cell-wrap" style="vertical-align:top;">Fiserv</td>

              <td class="slds-cell-wrap" style="vertical-align:top;">TBD</td>

            </tr>
            <tr class="">
              <td class="slds-cell-wrap" style="vertical-align:top;">HiPay</td>

              <td class="slds-cell-wrap" style="vertical-align:top;">
                <ul>
                  <li><a href="https://help.salesforce.com/s/articleView?id=commerce.rt_adv_config_3p_int_finance_hipay.htm&amp;release=264.0.0&amp;type=5" title="HiPay allows Point of Sale to generate a hosted page or payment link where customers can pay securely. Learn how to implement this in CMS implementation and get details of the user flow in the POS app. By enabling HiPay, you provide a secure and trusted payment experience for your customers."><u>HiPay Hosted Page Payment</u></a></li>

                </ul>
              </td>

            </tr>
            <tr class="">
              <td class="slds-cell-wrap" style="vertical-align:top;">UTA</td>

              <td class="slds-cell-wrap" style="vertical-align:top;">TBD</td>

            </tr>
          </tbody>
        </table>