On This Page
Unified Checkout Flow
Unified Checkout
FlowTo integrate
Unified Checkout
into your
platform, you must follow several integration steps. This section gives a high-level
overview of how to integrate and launch Unified Checkout
on your
webpage and process a transaction. You can find the detailed specifications of the
APIs later in this document.The integration flow consists of four events:
- You send a server-to-server API request for a capture context. This request is fully authenticated and returns a JSON Web Token (JWT) that is necessary in order to invoke the frontend JavaScript library. For information on setting up the server side, see Server-Side Set Up.
- You invoke theUnified CheckoutJavaScript library using the JWT response from the capture context request. For information on setting up the client side, see Client-Side Set Up.
- You process the payment through theUnified Checkoutcomplete mandate feature and interpret the response of the transaction flow that is displayed on your browser.IMPORTANTIf you do not use the complete mandate forUnified Checkout, you must request follow-on services using a transient token to process the payment.
- Optional:Capture the full payment response through webhook notifications.
Information that is captured by
Unified Checkout
, including the billing
and shipping address, can be retrieved using the payment details API.The figure below shows the
Unified Checkout
payment flow.Figure:
Unified Checkout
Payment Flow For more information on the specific APIs referenced, see these topics:
Enabling Unified Checkout in the Business Center
Unified Checkout
in the Business Center
To begin using
Unified Checkout
, you must first ensure that your merchant ID (MID)
is configured to use the service and that any payment methods you intend to use are
properly set up.- Log in to theBusiness Center:Production URL:If you are unable to access this page, contact your sales representative.
- In theBusiness Center, go to the left navigation panel and choosePayment Configuration>Unified Checkout.
- You can configure various payment methods such as Apple Pay,Click to Pay, and Google Pay. ClickSet upand follow the instructions for your selected payment methods. When payment methods are enabled, they appear on the payment configuration page.IMPORTANTYou must configure payment methods you want to use for each transacting MID.
Figure:
- ClickManageto edit your existing payment method configurations or enroll in new payment methods as they are released.