PaymentResponse.details

Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The details read-only property of the PaymentResponse interface returns a JSON-serializable object that provides a payment method specific message used by the merchant to process the transaction and determine a successful funds transfer.

This data is returned by the payment app that satisfies the payment request, and must conform to the structure defined in the BasicCardResponse dictionary.

Syntax

var detailsObject = PaymentResponse.details;

Example

The following example extracts the details from the PaymentResponse object to the promise returned from PaymentRequest.show(). In a real-world implementation this data would then be sent to a payment server.

payment.show().then(paymentResponse => {
  var paymentData = {
    // payment method string
    method: paymentResponse.methodName,
    // payment details as you requested
    details: paymentResponse.details,
    // shipping address information
    address: toDict(paymentResponse.shippingAddress)
  };
  // Send information to the server
});

Specifications

Specification Status Comment
Payment Request API Candidate Recommendation Initial definition.

Browser Compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support6115561 No No ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support No53 Yes561 No ?6.0

1. From version 56: this feature is behind the dom.payments.request.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

Document Tags and Contributors

Contributors to this page: fscholz, jpmedley, chrisdavidmills, libbymc, dgashmdn
Last updated by: fscholz,