Payment Extensibility

Payment Extensibility is a feature that allows you to add new gateways to use in a Kibo eCommerce tenant by creating an application in the Kibo Dev Center, configuring that application as a gateway adapter, and then installing that application in your eCommerce tenant.

Uses

Add Your Preferred Payment Gateway through Kibo Dev Center

You want to use a payment gateway that is not currently supported through Kibo eCommerce. You create an app in the Kibo Dev Center, configure it as a payment gateway, and install that app to your eCommerce tenant. Note that multiple instances of a gateway on the same site can be set up with different credentials.

Enable Third-Party Payments and Digital Wallets

Note that both third-party gateways (e.g. PayPal and Pay With Amazon) and digital wallets (e.g. Apple Pay and Visa Checkout) are extensible, but have important distinctions. Digital wallets store card information that they send to an external gateway for processing. Third-party gateways can function as a wallet but can also process the payment details themselves. For instance, PayPal can store card information and either process a payment or send it to CyberSource. These configurations can be tied together in the Payment Types settings menu.

Set Up a Payment Gateway Connector

Overview of Steps:

  1. Create an app in the Kibo Dev Center

  2. Configure your app as a gateway adapter

  3. Submit your app for certification

  4. Install your gateway adapter app

  5. Enable the gateway in your eCommerce tenant

Create an App in the Kibo Dev Center

You will need to create an app in the Kibo Dev Center to complete this process. For detailed instructions on creating an app, see the Payment Extensibility Starter Kit.

Configure Your App as a Gateway Adapter

For further information on how to configure an Apple Pay gateway, see the Apple Pay Configuration guide.

To configure your existing application as a payment gateway adapter:

  1. In the Kibo Dev Center, under the Developer Accounts list, select your developer account.

  2. Select Develop > Applications.

  3. Enter your application’s name in the search bar.

  4. Under the Actions column for your app, select the settings icon.

  5. Select Edit.

  6. On the left hand side, select Packages > Capabilities.

  7. Select Add Capability.

  8. Select Payment Gateway Adapter from the drop down menu.

  9. Select Ok. This displays the Configure Payment Gateway Adapter screen.

    If you are creating a payment gateway that processes gift cards, you must add the supportsGiftcard and schemaVersion fields to your gateway configuration after the administrationUI section as in the following example:

    “administrationUi”: [
    	//administration UI configs
    ],
    	“supportsGiftcard” : true,
    	“schemaVersion” : “1.0”
    }
    				

    The supportsGiftcard field must be set to true, and the schemaVersion field must be set to 1.0.

  10. On the Configure Payment Gateway Adapter screen, enter your Payment Gateway endpoint URL.

    Note: This field is used for payment gateway testing only. It indicates the endpoint for the payment gateway processor.
  11. In the Gateway Configuration field, a template is displayed for you to enter configurations for your payment gateway in JSON format.

  12. Depending on what kind on payments your connector can process, you need to set the following configuration.

    • Set paymentType field(supportedCards -> paymentType) to one of the below values based on payment type.
      1. CreditCards – “CC”
      2. DigitalWallets – “DW”
      3. ThirdPartyPayments – “3P”
    • Also populate the features collection with at least one of the valid values from below
      1. “CreditCards”
      2. “DigitalWallets”
      3. “ThirdPartyPayments”

      Example:

       "features":[
      	"CreditCards",
      	"DigitalWallets"
      ],
      					
    • When setting administration ui fields for connector, use ‘xtype’ field to configure the type of field you want to display in the admin.
      • "textfield"
      • "password"
      • “dropdown”
      • “radio”
      • “email”
      • “date”
      • “checkbox”
      • “number”
  13. Select the countries whose payments you want this payment gateway to process.

Submit Your App for Certification

If you are deploying this app to a production tenant, you need to submit your app for certification first. Certification ensures that your payment gateway app is PCI compliant, secure, and that it does not retain or leak any PCI data.

To submit your app for certification, from the application detail screen, select More > Submit for Certification. The system displays an error message if your app is still undergoing certification. To check the status of your application’s certification, contact Kibo Support.

Install Your Gateway Adapter App

To install your gateway adapter:

  1. In the Dev Center Console, select Develop > Applications.

  2. Search for your Application.

  3. Under the Actions column, select the settings icon.

  4. Select Edit.

  5. Select Install.

  6. Select your sandbox from the list.

  7. Select OK.

Enable the Gateway in Your eCommerce Tenant

Once you’ve successfully created and installed your payment gateway adapter in your eCommerce tenant, you need to enable that payment gateway in your eCommerce tenant’s admin UI.

To enable your payment gateway in eCommerce:

  1. In the Admin UI, go to System > Settings > Payment Gateways.

  2. Select Create New Payment Gateway.

  3. In the Payment Gateway drop-down menu, select your app to enable it as a payment gateway.

Note: Recall that gateways are always implemented on the tenant level. If there are multiple sites that need to use the same gateway, it must be set up for each site individually.

Edit an Existing Gateway

Once a gateway has been created, you can always go back and edit it by clicking on it in the Payment Gateways menu.

Configure Payment Types for Gateways

Go to the Payment Types settings menu of the site to configure payments types and processes relevant to the new gateways, particularly for third-party payments and gift cards. This is where "third party accounts" and "processing gateways" are defined, with the former being where the card information comes from and the latter being the service processing the payment. The processing gateway may be an optional field, depending on whether the account is acting as digital wallet or third party payment.

Note: If you are using Kount or Decision Manager for fraud management, then an update to the fraud cartridge will be required so that it can recognize the new payment type. This update must be performed by Kibo. Send a support ticket with information about the payment type whenever you implement a new third party gateway that will send payments to Kount or Decision Manager.

This is also where you can specify when to capture the payment: on either order placement or shipment.

Once configured, these payment options will display to customers as an option for checkout:

View enabled gift cards and specify when they should be redeemed further down the page.

For more information about setting Payment Types, see the Payment Gateways and Payment Types guide.

How to Process Payments

Users can process payments using the Kibo eCommerce interface. For information on payment processing:

PCI Security

All gateway connectors will need to be certified ensure they are PCI secure. Once your gateway connector is certified, you will need to submit a Dev Ops/Support task to enable the gateway adapter in a Production Tenant.