Overview

This guide describes the Samsung Pay Web Checkout service and how you can integrate it on your website. The guide contains information about the service flow and instructions for implementing the Samsung Pay Web Checkout SDK and its API calls.

Features

The Samsung Pay Web Checkout SDK is a JavaScript-based web development kit that integrates the Samsung Pay payment system to your website through a Web Checkout.

The Samsung Pay Web Checkout solution enables your users to pay for purchases on your website with payment cards saved in the Samsung Wallet application on their mobile device. The Web Checkout supports browser-based payments on both computers and mobile devices. A mobile device with Samsung Wallet installed is required to make purchases through Samsung Pay Web Checkout.

When the user chooses to pay with Samsung Pay, they must provide their Samsung account ID (email ID) or scan the code on the screen with their mobile device. The user then authorizes the purchase within the Samsung Wallet application, which generates the payment credential on the device and transmits it to your website through the Web Checkout.

User Scenario

The following figures describe the user scenario for making a purchase through Samsung Pay Web Checkout.

Part 1: Payment initiation and device binding

Figure 1: Payment initiation and device binding

  1. On your website, the user selects "Samsung Pay" at checkout.

  2. The Web Checkout UI is launched, showing the device binding screen. The user links the transaction to their device by entering their Samsung account email or by scanning the QR code with the device.

  3. The Samsung server sends a push notification to the Samsung Wallet application on the user's device. They must respond to the notification within the time limit shown on the screen.

Part 2: User confirmation on mobile device

Figure 2: User confirmation on mobile device

  1. The user taps the Samsung Wallet push notification on their device.

  2. The payment sheet is opened, and shows the payment summary to be confirmed. The user selects the payment card they want to use and verifies the payment.

  3. The payment credential information is generated and sent to the Samsung server.

Part 3: Payment completion

Figure 3: Payment completion

  1. In the user's web browser, the Web Checkout UI displays the "Verified" screen. The payment credential is transmitted securely to your website.

  2. You must submit the transaction information and payment credential to your payment provider for processing. The user's purchase is complete.

Service Flow

The following figure illustrates the Samsung Pay Web Checkout flow.

Figure 4: Web Checkout flow