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

Requesting a Payment

Use the

startSamsungPay()

API method in the

PaymentManager

class. The

PaymentManager

class includes the following API methods:

ADDITIONAL INFORMATION

startSamsungPay()

—requests to initiate payment with Samsung Pay.

updateAmount()

—updates the transaction amount if shipping address or card information is updated by Samsung Pay.

updateAmountFailed()

—returns an error code when the new amount cannot be updated because of a wrong address.

Request the

startSamsungPay()

API method and include the following data:

ADDITIONAL INFORMATION

PaymentInfo

—contains payment information.

PID

—the product ID created in the Samsung Pay Partner Portal.

StatusListener

—the result of the payment request is delivered to

StatusListener

. This listener should be registered before you call the

startSamsungPay()

API method.

When you request the

startSamsungPay()

API method, the Samsung Pay online payment sheet is displayed on your application. The customer selects a registered card for payment and can also update the billing and shipping address.

The payment reply is delivered as one of the following events to

StatusListener

:

onSuccess()

—this event is requested when Samsung Pay confirms the payment. It includes

encryptedPaymentCredential

in JSON format:

method:
Payment protocol: 3-D Secure.

merchant_ref:
Merchant reference code.

billing_address.street
: Number, street name.

billing_address.state_province:
Two-letter state code.

billing_address.zip_postal_code:
Five-character zip code.

billing_address.city:
City name.

billing_address.county:
Two-letter country code.

3ds.type:

S

for Samsung Pay. Encrypted.

3ds.version:
Current version

100

. Encrypted.

3ds.data:
Base64-encoded payment data. Encrypted.

Refer to the Samsung Pay developer website for information on how to decrypt the encrypted payment credential.

onFailure()

—this event is requested when the transaction fails. It returns an error code and error message.