跳转到内容

为 PWA 创造收入

发布于

Payment Request API 是收集支付信息、地址和联系方式的标准 API, 使用浏览器自带的支付面板。把它接到 PWA 的结账按钮上,就能取得买家的卡片或钱包信息, 再将支付响应交给服务器。浏览器拒绝请求时,回退到现有表单。API 只负责收集信息,实际扣款由支付处理商完成。

页面须使用 HTTPS(普通 HTTP 下 API 为 undefined)。你还需要支付处理商提供的支付方式标识符, 以及接收处理商令牌的服务端接口。商店和支付网络各自规定是否允许网页结账, 支付附有带日期的政策来源。

没有该 API 的浏览器中 window.PaymentRequest 不存在,所以渲染原生结账按钮之前先检测。存在时,构造一个 一次性请求并调用 canMakePayment():浏览器只要能处理所列方式中的一种,返回值就是 true。下面的 URL 形式 标识符沿用 MDN 示例的写法;你的处理商会给出自己的标识符。

const methodData = [{ supportedMethods: 'https://example.com/pay' }];
const stubDetails = {
total: { label: 'Stub', amount: { currency: 'USD', value: '0.01' } },
};
async function nativeCheckoutAvailable() {
if (!('PaymentRequest' in window)) return false;
try {
return await new PaymentRequest(methodData, stubDetails).canMakePayment();
} catch {
// 用户可能在隐私设置里关闭了该查询,或者浏览器对频繁调用
// 以 DOMException 拒绝。
return false;
}
}

每个页面只调用一次 canMakePayment(),不要每次渲染都调:MDN 注明调用过于频繁时浏览器可能以 DOMException 拒绝该 Promise。传给预检请求的 methodData 要与真实请求完全一致,否则预检回答的是另一个问题。

每次点击都新建一个 PaymentRequest:show() 在每个实例上只能调用一次。在处理函数内同步调用 show()。 规范允许浏览器在页面没有瞬时用户激活时以 SecurityError 拒绝 show(),Chromium 对每个页面加载中第一次之后的 show() 调用要求瞬时用户激活或委托的支付请求能力。 在点击与 show() 之间 await 一次网络请求,可能让用户激活过期,导致结账失败。金额还没算好时,把 Promise 传给 show(),而不是先 await。

function buildDetails(cart) {
return {
id: cart.orderId,
displayItems: cart.lines.map((line) => ({
label: line.name,
amount: { currency: 'USD', value: line.price },
})),
total: { label: 'Total', amount: { currency: 'USD', value: cart.total } },
};
}
document.querySelector('#checkout').addEventListener('click', async () => {
const request = new PaymentRequest(methodData, buildDetails(currentCart()));
try {
const response = await request.show();
const result = await fetch('/api/charge', {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ orderId: currentCart().orderId, details: response.details }),
});
await response.complete(result.ok ? 'success' : 'fail');
} catch (error) {
if (error.name === 'NotSupportedError') {
location.assign('/checkout/form'); // 这种支付方式没有可用的支付应用
} else if (error.name !== 'AbortError') {
throw error; // 买家关闭面板不算错误
}
}
});

response.details 包含支付方式返回的内容。Google Pay 返回支付令牌,你的后端将它转交给处理商。 扣款在服务端完成,再把结果传给 complete()。Google Pay 也提供自己的 JavaScript 库(pay.js) 来驱动同一个面板;代价是页面多加载一个脚本,换来的是在没有 Payment Request API 的浏览器里也能渲染按钮。

3. 保留表单路径并显示正确的按钮

链接到“3. 保留表单路径并显示正确的按钮”一节

只在第 1 步返回 true 时渲染原生结账按钮;否则渲染指向表单结账的链接。原生面板省去买家在手机上打字, 代价是多出一条需要测试的结账路径。浏览器没有该 API 时(参见 Payment Request API 浏览器支持),仍可使用表单结账。买家关闭面板后也能回退到表单。

nativeCheckoutAvailable().then((ok) => {
document.querySelector('#checkout').hidden = !ok;
document.querySelector('#checkout-form-link').hidden = ok;
});

面板以 success 关闭时,浏览器收起面板、页面继续;以 fail 关闭时,浏览器显示自己的错误状态。

← 返回指南总览。