The Samsungpay payment method specification describes the data formats used by the PaymentRequest API [[!PAYMENTREQUESTAPI]] to support payment by SamsungPay.

Dependencies

This specification relies on several other underlying specifications.

Payment Request Architecture

The terms Payment Method, Payment App, and Payment Transaction Message Specification are defined by the Payment Request Architecture document [[!PAYMENTARCH]].

Payment Request API

The term PaymentRequest constructor is defined by the PaymentRequest API specification [[!PAYMENTREQUESTAPI]].

Payment Method Identifiers

The term Payment Method Identifier is defined by the Payment Method Identifiers specification [[!METHODIDENTIFIERS]].

Web IDL

The IDL in this specification is defined by Web IDL [[!WEBIDL]].

Payment Method Identifier

The following payment method identifier strings are supported by the Samsung Pay data formats.

SamsungPay Prerequisites

• Make sure you are in of the supported countries
• Ensure that your payment gateway / processor supports Samsung Pay tokens
• Ensure that your payment gateway supports indirect payment method and has support to provide gateway token
• Sign up with your company name, origin and contact details using merchant onboarding portal
• We recommend that you obtain public key from gateway/processor in order to decrypt tokens from SamsungPay

SamsungPay Payment flows

Payment Method Specific Data

This section describes payment method specific data that is supplied as part of the data argument to the PaymentRequest constructor.

The following example shows how to construct data parameter and provide requried payment method information:

        var supportedInstruments = [
          {
            supportedMethods: ['https://samsung.com/pay'],
            data: {
              allowedCardNetworks: ['AMEX', 'MASTERCARD', 'VISA', 'DISCOVER'],
              paymentMethodTokenizationParameters: {
                tokenizationType: 'GATEWAY_TOKEN',
                parameters: {
                  // name of the gateway you support. Stripe is an example here. 
                  'gateway': 'stripe',
                  // Stripe publishable key here.
                  'stripe:publishableKey': 'pk_live_fD7ggZCtrB0vJNApRX5TyJ9T',
                  'stripe:version': '2016-07-06'
                }
              }
            }
          }
        ];
      

In order to use Samsung Pay with the gateway token approach, add a JSON object that contains the following parameters per the above example.

• supportedMethods
  The supportedMethods: ['https://samsung.com/pay'] field indicates this payment method is using Samsung Pay.
• allowedCardNetworks
  The allowedCardNetworks field contains allowed credit card networks that constitutes a valid response.
• tokenizationType
  The tokenizationType field contains type of merchant prefered token.
• gateway
  The gateway field specifies merchant's prefered gateway for payment processing.
• stripe:publishableKey
  The stripe:publishableKey field is publishable key merchant received from gateway (stripe in this example)
• stripe:version
  The stripe:version gateway specific information.

         dictionary  SamsungPayRequestData { 
           required sequence<DOMString> allowedCardNetworks;
           object paymentMethodTokenizationParameters;
         };

         dictionary paymentMethodTokenizationParameters {
           required DOMString tokenizationType;
           object parameters;
         };
      

         object parameters {
          required 'gateway' : 'type-of-gateway';
          'gateway:keys' : "values";
          ...        
         };
      

Payment Method Response

Samsung Pay does not process the payment. The merchant would still need to invoke gateway APIs to charge/process the gateway token returned from Samsung Pay. When requesting a gateway token, Samsung Pay makes a call to your processor on your behalf and returns a chargeable gateway token. Payment Request API provides shipping address, contact information as outlined in specification [[!PAYMENTREQUESTAPI]]. SamsungPay returns JSON-serializable object SamsungPayResponse in addition to information received from [[!PAYMENTREQUESTAPI]].

The SamsungPayResponse dictionary contains the response from SamsungPay and returned as part of PaymentResponse details parameter.

          paymentRequest.show().then(response => {
            // Manually clone the resulting object
            var data = {};
            data.methodName = response.methodName;
            data.details    = response.details; // SamsungPayResponse
            data.payerEmail = response.payerEmail;
            data.payerPhone = response.payerPhone;
            data.address    = response.shippingAddress;
            data.shipping   = response.shippingOption;
          }
      

      dictionary SamsungPayResponse {
        required DOMString token;
        object billingAddress;
        object contact;
      };