PaymentResponse.retry()

在此页

句法
范例
规范
浏览器兼容性
另请参阅
相关话题

安全上下文
此特征只可用于安全上下文 (HTTPS)，在某些或所有支持浏览器 .

PaymentResponse 接口的 retry() method makes it possible to ask the user to retry a payment after an error occurs during processing. This lets your app gracefully deal with situations such as invalid shipping addresses or declined credit cards.

句法

retryPromise = paymentRequest.retry(errorFields);

参数

errorFields

error 可选: A general description of a payment error from which the user may attempt to recover by retrying the payment, possibly after correcting mistakes in the payment information. error can be provided all by itself to provide only a generic error message, or in concert with the other properties to serve as an overview while other properties' values gude the user to errors in specific fields in the payment form.
payer 可选: A PayerErrors compliant object which provides appropriate error messages for any of the fields describing the payer which failed validation.
paymentMethod 可选: Any payment method specific errors which may have occurred. This object's contents will vary depending on the payment used. For example, if the user chose to pay by credit card using the basic-card payment method, this is a BasicCardErrors 对象。

shippingAddress 可选: AddressErrors object which contains error messages for any of the fields in the shipping address that failed validation.

返回值

A Promise which is resolved when the payment is successfully completed. The promise is rejected with an appropriate exception value if the payment fails again.

Typically you will use this by calling show() , then entering a loop or recursive function that checks the PaymentResponse for errors or other reasons to retry the payment request. If a retry is needed, the loop calls retry() , then loops back to check the response when it comes in. The loop exits only when the user either cancels the payment request or the request is successful.

见范例 below for a thorough example, but the basic concept, in outline form, is:

创建新的 PaymentRequest ( new PaymentRequest() )
Display the payment request ( PaymentRequest.show()
若 show() resolves, the returned PaymentResponse describes the requested payment and the options chosen by the user. Continue by...
1. Validate the returned reponse; if there are any fields whose values are not acceptable, call the response's complete() method with a value of "fail" to indicate failure.
2. If the response's data is valid and acceptable, call complete("success") to finalize the payment and proces it.
若 show() is rejected, the payment request failed, usually because either there's already one being processed, because the 用户代理 doesn't support any of the specified payment methods, or because of a security issue. See the list of exceptions for show() for further details. Call complete("fail") to close the payment request.

async function handlePayment() {
  const payRequest = new PaymentRequest(methodData, details, options);
  try {
    let payResponse = await payRequest.show();
    while (payResponse has errors) {
      /* let the user edit the payment information,
         wait until they submit */
      await response.retry();
    }
    await payResponse.complete("success");
  } catch(err) {
    /* handle the exception */
  }
}

范例

try { await paymentRequest.retry(errorFields); } catch (DOMException err) { ... }

async function doPaymentRequest() {
  const request = new PaymentRequest(methodData, details, options);
  const response = await request.show();
  await recursiveValidate(request, response);
  await response.complete("success");
}
// Keep validating until the data looks good!
async function recursiveValidate(request, response) {
  const promisesToFixThings = [];
  const errors = await validate(request, response);
  if (!errors) {
    return;
  }
  if (errors.shippingAddress) {
    // "shippingaddresschange" fired at request object
    const promise = fixField(request, "shippingaddresschange", shippingValidator);
    promisesToFixThings.push(promise);
  }
  if (errors.payer) {
    // "payerdetailchange" fired at response object
    const promise = fixField(response, "payerdetailchange", payerValidator);
    promisesToFixThings.push(promise);
  }
  await Promise.all([response.retry(errors), ...promisesToFixThings]);
  await recursiveValidate(request, response);
}
function fixField(requestOrResponse, event, validator) {
  return new Promise(resolve => {
    // Browser keeps calling this until promise resolves.
    requestOrResponse.addEventListener(event, async function listener(ev) {
      const promiseToValidate = validator(requestOrResponse);
      ev.updateWith(promiseToValidate);
      const errors = await promiseToValidate;
      if (!errors) { // yay! fixed!
        event.removeEventListener(event, listener);
        resolve();
      }
    });
  });
}
doPaymentRequest();

规范

规范	状态	注释
支付请求 API The definition of 'retry()' in that specification.	候选推荐	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

No compatibility data found. Please contribute data for "api.PaymentRequest.retry" (depth: 1) to the MDN 兼容性数据存储库 .

另请参阅

PaymentResponse 接口。

元数据

最后修改： Dec 2, 2019

在此页

句法

参数

返回值

范例

规范

浏览器兼容性

另请参阅

相关话题