Skip to main content
To process credit card transactions on your storefront, you must first set up a payment gateway and then assign that gateway to payment types regardless of whether your implementation is Order Management-only or includes eCommerce.

Watch: Payment Gateways

Learn how to configure payment gateways
 Payment gateways are created for each supported credit or gift card type, meaning that you can use different gateways for each individual card type or the same gateway with different credentials. Once gateways have been created, you can assign them through the Payment Type settings. For information on how to configure new payment gateways for third-party payments and gift cards that aren’t already supported, see the Payment Extensibility guide and Starter Kit. Note that changes to these settings may not immediately take effect when processing orders. It may take up to 15 minutes for updates to be reflected in the system while the cache refreshes.

​
Supported Providers

A number of payment gateways are available out-of-the-box, while others require applications to be installed and configured in your Dev Center first. The table below lists the payment gateways provided by KCCP and which actions they support. You can also create your own applications and custom gateways through Payment Extensibility. The credit cards below are available out-of-the-box and do not require you to install an application. The only configuration required is providing your account credentials as shown in the Add a Payment Gateway section of this guide. However, the digital wallets, third-party payments, and fraud gateways do require additional integration. See their linked documentation for more information.
Payment GatewayTokenized (supports OMS-Only)AuthRe-AuthCaptureCredit3DS
Credit Cards
CybersourceYesYesYesYesYesNo
Vantiv (Litle)YesYesYesYesYesNo
Authorize.netYesYesYesYesYesNo
CardConnectNoYesYesYesYesNo
Chase PaymentechNoYesYesYesYesNo
PaymetricYesYesYesYesYesNo
NoOpNoYesYesYesYesNo
Digital Wallets
ApplePay via CybersourceNoYesNoYesYesNo
ApplePay via VantivNoYesNoYesYesNo
Third Party Payments
AdyenYesYesYesYesYesNo
Pay With AmazonNoYesNoYesYesNo
PayPal ExpressNoYesNoYesYesNo
StripeYesYesYesYesYesYes
Fraud
KountN/AN/AN/AN/AN/AN/A
Cybersource Decision ManagerN/AN/AN/AN/AN/AN/A
When viewing the list of all available options while configuring a new gateway, you may see “OMS Bundled.” This is from the previous version of Order Management and should be ignored by most users. Likewise, options with the “xAuth” prefix should only be used by certain implementations upgraded from the previous version of eCommerce.

​
Add a Payment Gateway

To create a new payment gateway:
  1. Go to System > Settings > Payment Gateways. 
  2. Click Add New Gateway.
  3. Select a payment gateway provider from the drop-down menu.
  4. Based on the payment gateway selected, enter a nickname and the necessary authentication credentials. The nickname is used to identify that particular set of credentials and payment gateway when enabling payment types. The Cybersource payment gateway requires additional actions on your part to complete this step. See the expandable Cybersource Gateways section below these instructions for more details. The Create Payment Gateway module with Apple Pay configured
  5. Click Save.
If you are creating special cases such as a no-operation, gift card, or Cybersource gateway then refer to the below sections for more details and additional steps.

​
No-Operation Gateways

A No-Operation, or “NoOp” gateway, is not a real gateway that connects to an external service. It does not require any credentials and will consider all actions submitted to it to be automatic successes, since it does not actually perform any operations. These may be used in cases such as Order Management-only instances of KCCP, where the actual payment actions have been performed by the storefront service (such as Klarna, CrowdTwist, or Sezzle) and the payment information is only being passed into KCCP with the order data for fulfillment. The Create Payment Gateway module, showing fewer options for a NoOp gateway

​
Gift Card Gateways

Sites can support payment via gift cards if the appropriate gateway has been enabled. These gift card gateways differ from standard credit cards, as they include functions specifically built to handle gift card payments. This includes an alternate type of payment capture and the ability to update card balances.  Remember that once you create a payment gateway for gift cards, you must enable it as the processing gateway in the Gift Card payment type settings. This is different from “store credit” even if the credit has been given to a customer in the form of a merchant gift card. Store credit on customer accounts is managed through the eCommerce features of KCCP, but KCCP does not track the balances of external gift cards being used to pay for orders.

​
Global Gateway

Global Gateway is a supported gift card provider. However, the payment gateway cannot be created unless its application has first been installed. The apps available in the Dev Center are Global Gateway Dev (used for testing environments) and Global Gateway Adapter (used for live environments). Once installed, then the Global Gateway option will be included in the dropdown options when creating a new payment gateway.

​
Cybersource Gateways

When configuring a Cybersource gateway, a Merchant ID and Transaction Key needs to be provided. These details should be retrieved from the Cybersource account and copy-pasted into the KCCP payment gateway settings.
  1. Log in to Cybersource. Note the Account ID and Merchant ID in the top banner of the dashboard; this is the Merchant ID that will soon be used for the gateway in KCCP.
  2. Generate a REST API Key and Shared Secret according to Cybersource’s instructions.
  3. In the Kibo Admin, go to System > Settings > Payment Gateways. 
  4. Click Create New Payment Gateway.
  5. Select “Cybersource V2” from the drop-down menu.
  6. Enter a Nickname for the gateway.
  7. Enter your Merchant Id, Api Key, and Api Shared Secret.The payment gateway configurations for Cybersource
  8. Click Save.
Once a gateway is saved, you can continue to the Payment Types settings to select the processing gateways for different types of credit cards.

​
Edit a Payment Gateway

  1. Go to System > Settings > Payment Gateways.
  2. Click the existing payment gateway that you want to edit.
  3. Make updates to the nickname or the authentication credentials. All authentication fields must be re-entered; partial updates result in blank fields being saved.
  4. Click Save to save your changes.
  5. Click Cancel to return to the Payment Gateways list.
The payment gateway type cannot be edited, meaning that you cannot change a gateway from one type to another. You must instead add a new gateway.

​
Configure Gateway to Recognize Branded Credit Cards

To add branded credit cards to a gateway:
  1. Go to System > Settings > Payment Gateways.
  2. Select the Payment Settings tab.
  3. Select a payment gateway.
  4. In the empty field below underneath payment gateway, enter the BIN number for the credit card you want your gateway to recognize.
  5. Click Add BIN to apply it to your gateway.The Payment Gateways page with Authorize.Net selected
To remove branded credit cards:
  1. On the Payment Settings page, select a payment gateway.
  2. Find the BIN number of the credit card you want to remove in the list.
  3. Click the X to the right of that number.
  4. The branded credit card has now been removed.