Commerce Connect - Overview

Purpose

This integration guide defines an overview of steps required to integrate the FirstPay SDK with a Merchant web application. This guide is targeted to be used by technical representatives of a Merchant's development team.

Commerce Connect SDK

The Commerce Connect SDK provides a drop-in solution for Merchants with built-in UI and workflow for accepting payment through web application.

The Commerce Connect SDK will show end to end UI (multi-step, multi-screen) and makes Payment API calls in the background to complete the transactions. Merchant can choose to use different combinations of payment modes which can be configured through server-to-server call between Merchant Server and First Data APIs.SDK provides a variety of configurations for theme and multi-language support.Merchants can provide their desired theme configuration during SDK initialization.

Overview of payment processing via Commerce Connect checkout

The payment process starts at the click of pay button on merchant order summary page. On this click, you need to:

• Create an order in your order system and then generate sessionID using Commerce Connect SDK kit. sessionID is used for detecting errors or tampering introduced during its transmission of request. sessionID is generated using merchantID which should be kept only on server side for security reasons.
• Redirects the customer to Commerce Connect payment page with sessionID and ConfigID (https://test.fdconnect.com/Pay/?sessionToken=XXXX&configId=YYYY)
• Customer fills payment details and completes the payment authentication. Once the payment is complete, redirected to website's callback URL with status ,merchant transaction id ,transactionID
• Lastly, verify transaction status with TransactionStatus API via server to server call. This protects you from scenarios where your account credentials are compromised or request/response has been tampered