Overview

Introduction

The Samsung Pay SDKs allow you to integrate wallet features into your Android-based app to enable card transactions. The Samsung Pay SDKs offer 2 components:

• Samsung Pay SDK for Android for implementing apps using the native Android OS
• Samsung Pay SDK for Flutter for implementing apps using Google's Flutter framework

The Samsung Pay SDK for Android and Flutter both provide the same Samsung Pay features that give customers the option of paying for products and services with Samsung Pay using a card in Samsung Wallet.

The following sections provide all the information you need to integrate the Samsung Pay SDK for Android or Flutter:

• Prerequisites

  Defines the requirements for using the Samsung Pay SDK for Android or the Samsung Pay SDK for Flutter.

• Implement device support validation for Samsung Pay

  Gives step-by-step instructions for checking that the device running your app supports Samsung Pay. You must always run this check before using any Samsung Pay features.

• Implement card transaction functionalities

  Gives step-by-step instructions for coding the card transaction functionalities needed to allow the customer to pay for their in-app purchases with Samsung Pay.

• Sample apps

  Offers code samples demonstrating different features of the Samsung Pay SDK for Android or Samsung Pay SDK for Flutter integrations. For a more detailed step-by-step example, see Samsung Pay code lab.

• API reference

  Supplies the necessary method and object details for your coding for Samsung Pay SDK for Android and Samsung Pay SDK for Flutter.

Implementation

To implement Samsung Pay as a payment method for your store:

1. Check that you have fulfilled the prerequisites for integrating the Samsung Pay SDK for Android or the Samsung Pay SDK for Flutter.

2. Check that the customer device supports Samsung Pay.

3. Display Samsung Pay as a payment option.

4. If the customer selects Samsung Pay, initiate a payment transaction by implementing card transaction functionalities.

   After the customer has authorized the payment in the Samsung Wallet app, send the payment credentials you receive from the wallet to your payment gateway (PG) for processing.

Architecture

The following diagram shows a high-level architecture of the general interactions between Samsung Pay and your app.

The key components involved are:

• Partner app: Merchant app for making payments
• Samsung Pay SDK: Samsung Pay SDK for Android or Flutter, integrated into the partner app for direct communication with Samsung Pay
• Samsung Pay: Samsung payment service that creates transactions using the payment methods stored in Samsung Wallet
• Financial network: Payment gateways, acquirers, card associations, and issuers that participate in transaction processing under agreement with the merchant