PaymentRequest.PaymentRequest()

The PaymentRequest() constructor creates a new PaymentRequest object.

Syntax

var paymentRequest = new PaymentRequest(methodData, details [, options]);

Returns

An instance of the PaymentRequest interface.

Parameters

methodData

Contains the payment method identifiers for the payment methods the merchant web site accepts and any associated payment method specific data. methodData contains the following fields.

supportedMethods

A required sequence of strings containing payment method identifiers for payment methods that the merchant web site accepts.

data

A JSON-serializable object that provides optional information that might be needed by the supported payment methods.

details

Provides information about the requested transaction. details contains the following fields.

total

The total amount of the payment request.

displayItems

Optional line items for the payment request that the user agent may display, such as product details, tax, and shipping.

shippingOptions

The shipping options the user may choose from. If this sequence is blank, it indicates the merchant cannot ship to the current shipping address. The default shipping option may be indicated in this sequence.

modifiers

Modifiers for specific payment methods; for example, adjusting the total amount based on the payment method.

Example

The following example shows minimal functionality and focuses instead on showing the complete context of instantiating a PaymentRequest object.

  var supportedInstruments = [{
    supportedMethods: [
      'amex', 'diners', 'discover', 'jcb', 'maestro', 'mastercard', 'visa'
    ]
  }];

  var details = {
    total: {label: 'Donation', amount: {currency: 'USD', value: '55.00'}},
    displayItems: [
      {
        label: 'Original donation amount',
        amount: {currency: 'USD', value: '65.00'}
      }
    ],
    shippingOptions: [
      {
        id: 'standard',
        label: 'Standard shipping',
        amount: {currency: 'USD', value: '0.00'},
        selected: true
      }
    ]
  };

  var options = {requestShipping: true};

    try {
    var request = new PaymentRequest(supportedInstruments, details, options);

    // Add event listeners here.

    // Call show() to trigger the browser's payment flow.
    request.show().then(function(instrumentResponse) {
      // Do something with the response from the UI.
    })
    .catch(function(err) {
      // Do something with the error from request.show().
    });
  } catch (e) {
    // Catch any other errors.
  }

Specifications

Browser Compatibility