API Overview

Samsung Pay Developer Guide
- Recent Revisions to This Document
- VISA Platform Connect: Specifications and Conditions for Resellers/Partners

Introduction
- Requirements for Using Samsung Pay
- Supported Card Types and Optional Features
- Transaction Endpoints

Getting Started
- Registering with Samsung Pay
- Registering with National Australia Bank
- Creating a Project
- Integrating the Samsung Pay SDK
- Using the API Key
  - Example: Debug Mode
  - Example: Release Mode
- Verify That Your Application is Eligible for Samsung Pay
  - Example: Samsung Pay Class
- Initiating a Payment
  - Required Fields for Initiating a Payment
  - Example: Transaction Request Structure
- Requesting a Payment
  - Example: Request startSamsungPay() API Method

Services
- Authorization Service
  - Authorizing a Payment with JCB Using National Australia Bank Decryption Method
    - Required Fields for Authorizing a Payment Using JCB and the National Australia Bank Decryption Method
    - Authorizing a Payment
    - Example: National Australia Bank Decryption with JCB Using the REST API
  - Authorizing a Payment with Mastercard Using National Australia Bank Decryption Method
    - Required Fields for Authorizing a Payment Using Mastercard and the National Australia Bank Decryption Method
    - Authorizing a Payment
    - Example: National Australia Bank Decryption with Mastercard Using the REST API
  - Authorizing a Payment with Visa Using National Australia Bank Decryption Method
    - Required Fields for Authorizing a Payment Using Visa and the National Australia Bank Decryption Method
    - Authorizing a Payment
    - Example: National Australia Bank Decryption with Visa Using the REST API
  - Authorizing a Payment with JCB Using Merchant Decryption Method
    - Required Fields for Authorizing a Payment Using JCB and the Merchant Decryption Method
    - Authorizing a Payment
    - Example: Merchant Decryption with JCB Using the REST API
  - Authorizing a Payment with Mastercard Using Merchant Decryption Method
    - Required Fields for Authorizing a Payment Using Mastercard and the Merchant Decryption Method
    - Authorizing a Payment
    - Example: Merchant Decryption with Mastercard Using the REST API
  - Authorizing a Payment with Visa Using Merchant Decryption Method
    - Required Fields for Authorizing a Payment Using Visa and the Merchant Decryption Method
    - Authorizing a Payment
    - Example: Merchant Decryption with Visa Using the REST API
- Authorization Reversal Service
  - Required Fields for Reversing an Authorization
  - Reversing an Authorization
  - Example: Basic Credit Card Authorization Reversal Using the REST API
- Capture Service
  - Required Fields for Capturing a Payment
  - Capturing a Payment
  - Example: Basic Credit Card Capture Using the REST API
- Sale Service
  - Required Fields for Performing a Sale
  - Authorizing and Capturing a Payment
  - Example: Basic Credit Card Sale Using the REST API

On This Page

Required Fields for Initiating a Payment

The following fields are required for initiating a payment; include these fields in the

PaymentInfo

class:

IMPORTANT

If the required fields are not included, you receive a

NullPointerException

error.

Merchant Name: The merchant name as it appears on the payment sheet of Samsung Pay and customer’s bank statement.
Amount
Payment Protocol: 3-D Secure.
Permitted Card Brands: Specify the card brands that are supported such as American Express, JCB, Mastercard, or Visa.
Merchant ID
Order Number
Shipping Address: This field is required if
SEND_SHIPPING or NEED_BILLING_AND_SEND_SHIPPING
is set for
AddressVisibilityOption
.
Address Visibility Option
Card Holder Name
Recurring Option

Back to top