Integration Hero
Connect™

Cybersource + Kentico Integration

Clarity Connect™ integrates Cybersource with Kentico, automating business processes and data sharing. This robust integration connects your critical business systems to automate order processing, inventory management, and customer data synchronization.

The Challenge

Connecting with Clarity Connect™

Clarity Connect™ links Cybersource and Kentico through automation and data sharing. Integrating these platforms benefits businesses by streamlining processes and connecting front-end and back-end systems.

Considerations when connecting these applications include security, performance, and physical access. We support both SaaS (Cloud) and On-Premises connection types.

Integration Diagram
Solution Illustration
The Solution

Seamless Integration

Our middleware platform ensures robust and reliable data transfer between Cybersource and Kentico.

  • Kentico: Easily integrate custom fields on `Order`, `Customer`, `Product` entities with corresponding fields in Cybersource requests or responses (e.g., loyalty points, custom discount codes, internal tracking IDs).
  • Cybersource: Utilize custom data fields within Cybersource transaction requests for enhanced fraud screening or specific reporting requirements, mapped from Kentico data.
Implementation Timeline

Go live with Cybersource + Kentico in as little as 2–4 weeks.

A proven, repeatable implementation approach that minimizes risk while getting your team to value quickly.

1

Access Enabled

Secure connections established to both Cybersource and Kentico, with credentials and environments confirmed.

2

Configuration & Mapping

Field mappings, business rules, and workflows configured using visual tools and pre-built templates.

3

Go Live

Launch production-ready integration with monitoring, alerting, and support in place—typically within 2–4 weeks.

Time to Value

2–4 weeks

Typical implementation window from access granted to production go-live for most Cybersource + Kentico deployments.

Project Phases

Discovery
Configure & Map
Validate
Launch

Engagement Model

Guided by Clarity experts with your team involved at key milestones.

Comprehensive Solution Details

  • Kentico: Easily integrate custom fields on `Order`, `Customer`, `Product` entities with corresponding fields in Cybersource requests or responses (e.g., loyalty points, custom discount codes, internal tracking IDs).
  • Cybersource: Utilize custom data fields within Cybersource transaction requests for enhanced fraud screening or specific reporting requirements, mapped from Kentico data.

Integration Architecture: Cybersource & Kentico with iPaaS

The recommended architecture leverages a modern iPaaS as the central orchestration layer, ensuring a scalable, secure, and resilient integration between Kentico's eCommerce platform and Cybersource's payment and fraud services.

Data Flow Steps

Event-Driven Architecture: Primarily uses webhooks from both Kentico (new orders) and Cybersource (payment status, fraud decisions) to trigger real-time workflows in the iPaaS, minimizing polling.

API-First Design: All interactions leverage RESTful APIs from both systems, managed and orchestrated by the iPaaS.

Canonical Data Model: An intermediate, standardized data model within the iPaaS for common entities like 'Order', 'Customer', and 'Payment' to ensure consistent data representation across systems.

Idempotent Operations: Design integration flows to ensure that retrying a failed operation (e.g., creating an order in ERP, processing a refund) does not result in duplicate actions.

Data Touchpoints

Kentico Xperience: eCommerce platform (source of orders, customers, products).
Cybersource: Payment gateway, fraud management (Decision Manager), tokenization services.
iPaaS (Integration Platform as a Service): Central orchestration engine, connectors for Kentico & Cybersource, data mapping & transformation, workflow engine, monitoring, security vault.
Secure Front-end (Kentico): Utilizes Cybersource Microform or secure fields for PCI DSS compliant card data collection.
ERP/OMS/CRM: Downstream systems for order fulfillment, customer 360, and financial reconciliation.

"A hub-and-spoke model where the iPaaS acts as the central hub. Kentico connects to the iPaaS via its REST APIs and webhooks. Cybersource also connects to the iPaaS via REST APIs and webhooks. The iPaaS orchestrates data flow, transformations, and business logic. Other systems like ERP/CRM/OMS also connect to the iPaaS."

Pricing

Simple, transparent pricing for Cybersource + Kentico.

Start with a single integration pair and scale as your business grows—without surprise fees or transaction penalties.

Connect™ Plan

Clarity Connect

$595 /mo

Billed annually • Includes one production integration pair

  • Unlimited transactions and API calls within fair-use limits.
  • Visual workflow designer and reusable mapping templates.
  • Monitoring, alerting, and access to Clarity’s support team.
View full pricing & options
Innovative & Robust

How Middleware Integration Works

Benefits of Integrating Cybersource

Integrating Cybersource fosters greater efficiency and data accuracy. Automate your critical business processes to deliver consistently outstanding results.

Hover over the steps on the right to see detailed integration points.
Data Mapping

Data Entity Mapping

Explore how data flows between systems with intelligent field mapping and transformation logic.

Order (Kentico) & Payment Transaction (Cybersource)

Synchronizing a Kentico Order with its corresponding payment event in Cybersource is central to eCommerce operations. The Kentico Order acts as the source, triggering payment processing in Cybersource, which then returns transaction details and status updates.

Cybersource Fields

transactionId (Cybersource unique ID) amount currency status (e.g., authorized, captured, settled, declined, refunded) authorizationCode paymentMethod merchantReferenceCode (mapped from Kentico OrderID) cardType cardLast4 fraudScore riskDecision

Kentico Fields

OrderID (Kentico unique ID) OrderDate OrderStatus (e.g., Pending, Paid, Refunded, Canceled) CustomerGUID TotalPrice CurrencyCode PaymentMethod TransactionID (to store Cybersource transactionId) PaymentStatus (specific to Kentico's payment module) BillingAddress ShippingAddress

Mapping Notes

The Kentico `OrderID` is typically mapped to Cybersource's `merchantReferenceCode` for traceability. Cybersource's `transactionId` is then stored back in Kentico's `Payment.TransactionID` or a custom field on the Order. Payment statuses require careful mapping (e.g., Cybersource 'authorized' might map to Kentico 'Pending Payment', 'captured' to 'Paid'). Fraud scores and decisions from Cybersource Decision Manager can be stored on the Kentico Order for review.

Next Steps

See Cybersource + Kentico integration in action.

Explore a guided demo, start a sandbox integration, or speak directly with our solution architects about your specific use cases.

Real-World Applications

Integration Use Cases

Explore how the integration behaves in real business scenarios, with clearly defined steps, outcomes, and execution patterns.

Real-time eCommerce Order Payment & Fulfillment

A customer places an order on Kentico; the payment is processed securely via Cybersource. Upon successful payment, the order status and details are instantly updated in Kentico and synchronized with an ERP/OMS for rapid fulfillment.

Integration Steps:

  1. 0 Customer completes checkout in Kentico.
  2. 1 Kentico sends payment request to iPaaS.
  3. 2 iPaaS orchestrates payment with Cybersource (authorization/capture).
  4. 3 Cybersource processes payment and returns status to iPaaS.
  5. 4 iPaaS updates Kentico Order 'Payment' status to 'Paid'.
  6. 5 iPaaS triggers ERP/OMS order creation/update with payment details.
  7. 6 ERP/OMS initiates fulfillment and updates Kentico Order 'Status' to 'Processing'.

Business Outcome

Accelerated order-to-cash cycle, reduced manual data entry, improved inventory accuracy, enhanced customer experience with real-time updates.

Frequency

Real-time (event-driven)

Implementation Timeline

Go live with Cybersource + Kentico in as little as 2–4 weeks.

A proven, repeatable implementation approach that minimizes risk while getting your team to value quickly.

1

Access Enabled

Secure connections established to both Cybersource and Kentico, with credentials and environments confirmed.

2

Configuration & Mapping

Field mappings, business rules, and workflows configured using visual tools and pre-built templates.

3

Go Live

Launch production-ready integration with monitoring, alerting, and support in place—typically within 2–4 weeks.

Time to Value

2–4 weeks

Typical implementation window from access granted to production go-live for most Cybersource + Kentico deployments.

Project Phases

Discovery
Configure & Map
Validate
Launch

Engagement Model

Guided by Clarity experts with your team involved at key milestones.

Technical Documentation

API Endpoints & Data Logic

Technical details for developers and architects.

Method Endpoint Purpose
POST /pts/v2/payments Authorize or capture payments originating from Kentico orders, including tokenized data.
POST /pts/v2/payments/{id}/captures Capture previously authorized payments for Kentico orders (e.g., at shipment).
POST /pts/v2/payments/{id}/refunds Process full or partial refunds for Kentico orders.
POST /tss/v2/tokens Tokenize sensitive payment card data from Kentico's checkout.
POST /dm/v2/decisions Submit transaction data from Kentico for fraud screening via Decision Manager.

Transformation Logic

  • Currency & Amount: Map Kentico `TotalPrice` to Cybersource `amount`, ensuring correct decimal places and `CurrencyCode` to `currency` (ISO 4217).
  • Status Mapping: Translate Cybersource's granular payment statuses (e.g., `authorized`, `captured`, `settled`, `declined`, `pending`) to Kentico's `PaymentStatus` and `OrderStatus` values (e.g., 'Pending Payment', 'Paid', 'Refunded', 'Canceled').
  • Address Formatting: Standardize Kentico's billing and shipping address fields into Cybersource's required format for fraud checks and billing.
  • Identifier Linking: Map Kentico `OrderID` to Cybersource `merchantReferenceCode` for payment requests and store Cybersource `transactionId` back into Kentico's `Payment.TransactionID` field.
  • Data Enrichment: Add Kentico `CustomerGUID`, `Email`, `IPAddress` to Cybersource requests for enhanced fraud screening.
  • Tokenization Handling: Encrypt and securely pass raw card data to Cybersource for tokenization, then store only the secure `Payment Token` and non-sensitive `cardLast4` back into Kentico/CRM.

🛡️ Error Handling

  • Cybersource payment gateway downtime
  • Invalid Kentico order data causing Cybersource API error
  • Network latency causing timeouts
  • Fraud rejection requiring order cancellation
  • Duplicate payment attempts
  • Mismatched refund amounts
Pricing

Simple, transparent pricing for Cybersource + Kentico.

Start with a single integration pair and scale as your business grows—without surprise fees or transaction penalties.

Connect™ Plan

Clarity Connect

$595 /mo

Billed annually • Includes one production integration pair

  • Unlimited transactions and API calls within fair-use limits.
  • Visual workflow designer and reusable mapping templates.
  • Monitoring, alerting, and access to Clarity’s support team.
View full pricing & options
Support & Information

Frequently Asked Questions

Common questions about integration implementation, security, and best practices.

Benefits FAQs

What are the primary benefits of integrating Cybersource with Kentico?
The integration automates secure payment processing, provides advanced fraud prevention (via Cybersource Decision Manager), streamlines financial reconciliation, and ensures real-time synchronization of order and customer data between Kentico and your backend systems. This leads to reduced manual effort, lower fraud losses, and an enhanced customer experience.

iPaaS & Technology FAQs

How does an iPaaS facilitate this integration, and why is it superior to custom coding?
An iPaaS (Integration Platform as a Service) acts as a central hub, offering pre-built connectors, low-code visual designers, and robust data transformation engines. It significantly accelerates development, provides scalability, centralized monitoring, and handles complex error scenarios. Unlike custom coding, it reduces maintenance burden, empowers citizen integrators, and ensures future-proof adaptability without extensive code rewrites.

Security & Compliance FAQs

How does the integration handle PCI DSS compliance for sensitive payment data?
PCI DSS compliance is paramount. The integration leverages Cybersource's secure tokenization services and Microform solutions. This ensures that raw cardholder data never touches your Kentico instance or the iPaaS platform directly. Only secure, non-sensitive payment tokens are stored and used for subsequent transactions, significantly reducing your PCI DSS scope.

Fraud Prevention FAQs

Can this integration support advanced fraud detection and management?
Absolutely. By integrating with Cybersource's Decision Manager, the iPaaS captures real-time fraud decisions and alerts. It can then automatically create fraud cases in your CRM or case management system, notify fraud teams, and even trigger automated actions in Kentico (e.g., hold or cancel suspicious orders), significantly enhancing your fraud prevention capabilities.

Data Flow FAQs

What data entities are typically synchronized between Kentico and Cybersource?
Key entities include Kentico 'Orders' (for payment initiation), Cybersource 'Payment Transactions' (authorizations, captures, refunds), Kentico 'Customers' linked to Cybersource 'Customer Profiles' and 'Payment Tokens'. Additionally, 'Refunds' and 'Fraud Cases' are critical for complete workflow automation.

Technical FAQs

How does the integration ensure real-time updates for order and payment statuses?
The integration utilizes an event-driven architecture. Kentico webhooks notify the iPaaS of new orders, while Cybersource webhooks notify the iPaaS of payment status changes (e.g., authorized, captured, declined) and fraud decisions. This eliminates polling, reduces latency, and ensures immediate synchronization of critical data across systems.

AI FAQs

Can AI enhance the Cybersource Kentico integration?
Yes, AI significantly augments the integration. It can provide AI-assisted data mapping recommendations, detect anomalies in order or payment data for enhanced fraud prevention, suggest optimal payment routing for higher success rates, and even automate initial error resolution or suggest common fixes for integration failures.

Implementation FAQs

What is the typical development lifecycle for a Cybersource Kentico integration project?
A modern iPaaS-driven lifecycle involves discovery and requirements, API analysis, designing integration flows in a low-code visual environment, defining data mappings and business rules, rigorous testing in isolated Dev/QA environments, and finally, controlled promotion to production. Version control and automated testing are integral throughout the process.
Implementation Timeline

Go live with Cybersource + Kentico in as little as 2–4 weeks.

A proven, repeatable implementation approach that minimizes risk while getting your team to value quickly.

1

Access Enabled

Secure connections established to both Cybersource and Kentico, with credentials and environments confirmed.

2

Configuration & Mapping

Field mappings, business rules, and workflows configured using visual tools and pre-built templates.

3

Go Live

Launch production-ready integration with monitoring, alerting, and support in place—typically within 2–4 weeks.

Time to Value

2–4 weeks

Typical implementation window from access granted to production go-live for most Cybersource + Kentico deployments.

Project Phases

Discovery
Configure & Map
Validate
Launch

Engagement Model

Guided by Clarity experts with your team involved at key milestones.

Pricing

Simple, transparent pricing for Cybersource + Kentico.

Start with a single integration pair and scale as your business grows—without surprise fees or transaction penalties.

Connect™ Plan

Clarity Connect

$595 /mo

Billed annually • Includes one production integration pair

  • Unlimited transactions and API calls within fair-use limits.
  • Visual workflow designer and reusable mapping templates.
  • Monitoring, alerting, and access to Clarity’s support team.
View full pricing & options
Next Steps

See Cybersource + Kentico integration in action.

Explore a guided demo, start a sandbox integration, or speak directly with our solution architects about your specific use cases.