Recent Revisions to This Document

About This Guide

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 Cybersource
- 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 American Express Using Cybersource Decryption Method
    - Required Fields for Authorizing a Payment Using American Express and the Cybersource Decryption Method
    - Authorizing a Payment
    - Example: Cybersource Decryption with American Express Using the Simple Order API
  - Authorizing a Payment with JCB Using Cybersource Decryption Method
    - Required Fields for Authorizing a Payment Using JCB and the Cybersource Decryption Method
    - Authorizing a Payment
    - Example: Cybersource Decryption with JCB Using the Simple Order API
  - Authorizing a Payment with Mastercard Using Cybersource Decryption Method
    - Required Fields for Authorizing a Payment Using Mastercard and the Cybersource Decryption Method
    - Authorizing a Payment
    - Example: Cybersource Decryption with Mastercard Using the Simple Order API
  - Authorizing a Payment with Visa Using Cybersource Decryption Method
    - Required Fields for Authorizing a Payment Using Visa and the Cybersource Decryption Method
    - Authorizing a Payment
    - Example: Cybersource Decryption with Visa Using the Simple Order API
  - Authorizing a Payment with American Express Using Merchant Decryption Method
    - Required Fields for Authorizing a Payment Using American Express and the Merchant Decryption Method
    - Authorizing a Payment
    - Example: Merchant Decryption with American Express Using the Simple Order 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 Simple Order 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 Simple Order 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 Simple Order API
- Authorization Reversal Service
  - Required Fields for Reversing an Authorization
  - Reversing an Authorization
  - NVP Example: Basic Credit Card Authorization Reversal Using the Simple Order API
  - XML Example: Basic Credit Card Authorization Reversal Using the Simple Order API
- Capture Service
  - Required Fields for Capturing a Payment
  - Capturing a Payment
  - NVP Example: Basic Credit Card Capture Using the Simple Order API
  - XML Example: Basic Credit Card Capture Using the Simple Order API
- Sale Service
  - Required Fields for Performing a Sale
  - Authorizing and Capturing a Payment
  - NVP Example: Basic Credit Card Sale Using the Simple Order API
  - XML Example: Basic Credit Card Sale Using the Simple Order API

On This Page

Simple Order API | Visa Platform Connect

Required Fields for Initiating a Payment

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

PaymentInfo

class:

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