瞭解商家如何整合付款應用程式,以及付款交易如何與 Payment Request API 搭配運作。
Web Payments API 是首次內建於瀏覽器的專屬付款功能。有了 Web Payments,商家與付款應用程式的整合變得更簡單,客戶體驗也更流暢、更安全。
如要進一步瞭解使用 Web Payments 的好處,請參閱「透過 Web Payments 強化付款應用程式」。
本文將逐步說明商家網站上的付款交易,並協助您瞭解付款應用程式整合的運作方式。
這項程序包含 6 個步驟:
- 商家發起付款交易。
- 商家顯示付款按鈕。
顧客按下付款按鈕。
瀏覽器會啟動付款應用程式。
如果客戶變更任何詳細資料 (例如運送選項或地址),商家會更新交易明細,反映變更。
客戶確認購買後,商家會驗證付款並完成交易。
步驟 1:商家發起付款交易
當顧客決定購買時,商家會建構 PaymentRequest 物件,啟動付款交易。這個物件包含交易的重要資訊:
- 可接受的付款方式和相關資料,用於處理交易。
- 詳細資料,例如總價 (必填) 和商品資訊。
- 商家可要求提供運送資訊 (例如運送地址和運送選項) 的選項。
- 商家也可以要求提供帳單地址、付款人姓名、電子郵件和電話號碼。
- 商家也可以在
PaymentRequest中加入選用的運送類型 (shipping、delivery或pickup)。付款應用程式可根據這項資訊,在 UI 中顯示正確的標籤。
const request = new PaymentRequest([{
supportedMethods: 'https://bobpay.xyz/pay',
data: {
transactionId: '****'
}
}], {
displayItems: [{
label: 'Anvil L/S Crew Neck - Grey M x1',
amount: { currency: 'USD', value: '22.15' }
}],
total: {
label: 'Total due',
amount: { currency: 'USD', value : '22.15' }
}
}, {
requestShipping: true,
requestBillingAddress: true,
requestPayerEmail: true,
requestPayerPhone: true,
requestPayerName: true,
shippingType: 'delivery'
});
部分付款處理常式可能會要求商家提供預先核發的交易 ID,做為交易資訊的一部分。一般整合程序包括商家和付款處理工具伺服器之間的通訊,以保留總價。這樣一來,惡意客戶就無法在交易結束時,透過驗證程序操縱價格及欺騙商家。
商家可以將交易 ID 做為 PaymentMethodData 物件 data 屬性的一部分傳遞。
提供交易資訊後,瀏覽器會根據付款方式 ID,在 PaymentRequest 中指定的付款應用程式中進行探索程序。這樣一來,只要商家準備好進行交易,瀏覽器就能判斷要啟動哪個付款應用程式。
如要進一步瞭解探索程序,請參閱「設定付款方式」。
步驟 2:商家顯示付款按鈕
商家可以支援多種付款方式,但應只顯示顧客實際可用的付款按鈕。如果顯示無法使用的付款按鈕,會導致使用者體驗不佳。如果商家可以預測 PaymentRequest 物件中指定的付款方式不適用於客戶,則可提供備用解決方案,或完全不顯示該按鈕。
商家可以使用 PaymentRequest 執行個體,查詢客戶是否可以使用付款應用程式。
客戶是否能使用付款應用程式?
如果客戶的裝置上有付款應用程式,PaymentRequest 的 canMakePayment() 方法會傳回 true。「可用」表示系統找到支援該付款方式的付款應用程式,且已安裝平台專屬付款應用程式,或網頁式付款應用程式已可註冊。
const canMakePayment = await request.canMakePayment();
if (!canMakePayment) {
// Fallback to other means of payment or hide the button.
}
步驟 3:顧客按下付款按鈕
顧客按下付款按鈕後,商家會呼叫 PaymentRequest 例項的 show() 方法,立即觸發付款 UI。
如果最終總價是動態設定 (例如從伺服器擷取),商家可以延後啟動付款 UI,直到得知總價為止。
延遲啟動付款 UI
請參閱延遲付款 UI 的示範,瞭解如何等到最終總價確定後再顯示付款 UI。
如要延遲付款 UI,商家會將 Promise 傳遞至 show() 方法。瀏覽器會顯示載入指標,直到 Promise 解析完成且交易準備開始。
const getTotalAmount = async () => {
// Fetch the total amount from the server, etc.
};
try {
const result = await request.show(getTotalAmount());
// Process the result…
} catch(e) {
handleError(e);
}
如果未指定承諾做為 show() 的引數,瀏覽器會立即啟動付款 UI。
步驟 4:瀏覽器啟動付款應用程式
瀏覽器可以啟動平台專屬或網頁式付款應用程式 (進一步瞭解 Chrome 如何判斷要啟動哪個付款應用程式)。
付款應用程式的建構方式大多取決於開發人員,但與商家之間傳送的事件,以及與這些事件一起傳遞的資料結構,都採用標準化格式。
付款應用程式啟動時,會收到步驟 1 中傳遞至 PaymentRequest 物件的交易資訊,包括:
- 付款方式資料
- 總價
- 付款方式
付款應用程式會使用交易資訊標示 UI。
步驟 5:商家如何根據顧客動作更新交易明細
顧客可以在付款應用程式中變更交易明細,例如付款方式和運送選項。顧客變更後,商家會收到變更事件並更新交易明細。
商家可接收四種事件:
- 付款方式變更事件
- 運送地址變更事件
- 運送選項變更事件
- 商家驗證事件
付款方式變更事件
付款應用程式可支援多種付款方式,商家可能會根據顧客的選擇提供特別折扣。為涵蓋這個用途,付款方式變更事件可將新的付款方式通知商家,以便商家更新折扣後的總價,並將總價傳回付款應用程式。
request.addEventListener('paymentmethodchange', e => {
e.updateWith({
// Add discount etc.
});
});
運送地址變更事件
付款應用程式可選擇提供消費者的運送地址。這對消費者來說很方便,因為他們不必手動在表單中輸入任何詳細資料,而且可以將運送地址儲存在偏好的付款應用程式中,而不是多個不同的商家網站。
如果顧客在交易啟動後,於付款應用程式中更新運送地址,系統會傳送 'shippingaddresschange' 事件給商家。商家可根據這個事件,依新地址決定運費、更新總價,並將資訊傳回付款應用程式。
request.addEventListener('shippingaddresschange', e => {
e.updateWith({
// Update the details
});
});
如果商家無法運送至更新後的地址,可以在傳回付款應用程式的交易明細中,加入錯誤參數,提供錯誤訊息。
運送選項變更事件
商家可以向顧客提供多種運送選項,並將該選項委派給付款應用程式。運送選項會以價格和服務名稱清單的形式顯示,供顧客選取。例如:
- 標準配送服務 - 免費
- 快捷配送 - 5 美元
當消費者在付款應用程式中更新運送選項時,系統會將 'shippingoptionchange' 事件傳送給商家。商家可以決定運費、更新總價,然後將資訊傳回付款應用程式。
request.addEventListener('shippingoptionchange', e => {
e.updateWith({
// Update the details
});
});
商家也可以根據消費者的運送地址,動態修改運送選項。如果商家想為國內外顧客提供不同的運送選項,這個方法就很實用。
商家驗證事件
為進一步確保安全,付款應用程式可在進入付款流程前,先驗證商家。驗證機制的設計取決於付款應用程式,但商家驗證事件會通知商家可用於驗證自身的網址。
request.addEventListener('merchantvalidation', e => {
e.updateWith({
// Use `e.validateURL` to validate
});
});
步驟 6:商家驗證付款並完成交易
當客戶成功授權付款時,show() 方法會傳回解析為 PaymentResponse 的 Promise。PaymentResponse 物件包含下列資訊:
- 付款結果詳細資料
- 運送地址
- 運送選項
- 聯絡資訊
此時,瀏覽器 UI 可能仍會顯示載入指標,表示交易尚未完成。
如果付款應用程式因付款失敗或錯誤而終止,從 show() 傳回的承諾會拒絕,瀏覽器也會終止付款交易。
處理及驗證付款
PaymentResponse 中的 details 是付款應用程式傳回的付款憑證物件。商家可以使用憑證處理或驗證付款。這項重要程序的運作方式取決於付款處理常式。
完成或重試交易
商家判斷交易成功或失敗後,可以採取下列任一做法:
- 呼叫
.complete()方法完成交易,並關閉載入指標。 - 呼叫
retry()方法,讓客戶重試。
async function doPaymentRequest() {
try {
const request = new PaymentRequest(methodData, details, options);
const response = await request.show();
await validateResponse(response);
} catch (err) {
// AbortError, SecurityError
console.error(err);
}
}
async function validateResponse(response) {
try {
const errors = await checkAllValuesAreGood(response);
if (errors.length) {
await response.retry(errors);
return validateResponse(response);
}
await response.complete("success");
} catch (err) {
// Something went wrong…
await response.complete("fail");
}
}
// Must be called as a result of a click
// or some explicit user action.
doPaymentRequest();
後續步驟
- 如要進一步瞭解如何宣告付款方式 ID,請參閱「設定付款方式」。
- 如要瞭解如何建構平台專屬的付款應用程式,請參閱 Android 付款應用程式開發人員指南。
- 如要瞭解如何建構網頁式付款應用程式,請參閱網頁式付款應用程式開發人員指南。