使用網路付款功能的付款交易始於發現您的付款應用程式。瞭解如何設定付款方式,並讓付款應用程式準備好可供商家和客戶進行付款。
如要與 Payment Request API 搭配使用,付款應用程式必須與付款方式 ID 建立關聯。要整合付款應用程式的商家會使用付款方式 ID 向瀏覽器指出。本文將討論付款應用程式探索的運作方式,以及如何將付款應用程式設定為可供瀏覽器正確探索及叫用。
如果您不熟悉網路付款的概念,或是如何透過付款應用程式進行付款交易,請先閱讀下列文章:
瀏覽器支援
網路付款功能包含幾項不同技術,支援狀態會因瀏覽器而異。
瀏覽器如何發現付款應用程式
所有付款應用程式都必須提供以下項目:
- 網址付款方式 ID
- 付款方式資訊清單 (除非第三方提供付款方式 ID)
- 網頁應用程式資訊清單
探索程序會從商家發起交易時展開:
- 瀏覽器將要求傳送至付款方式 ID 網址,並擷取付款方式資訊清單。
- 瀏覽器會從付款方式資訊清單決定網頁應用程式資訊清單網址,並擷取網頁應用程式資訊清單。
- 瀏覽器會從網頁應用程式資訊清單判斷要啟動 OS 付款應用程式,還是網頁式付款應用程式。
以下各節將詳細說明如何設定自己的付款方式,以便瀏覽器找到。
步驟 1:提供付款方式 ID
付款方式 ID 是以網址為基礎的字串。例如,Google Pay 的 ID 為 https://google.com/pay
。只要付款應用程式開發人員能控管任何網址,且能提供任意內容,就能選擇任何網址做為付款方式 ID。在本文中,我們將使用 https://bobbucks.dev/pay
做為付款方式 ID。
商家如何使用付款方式 ID
PaymentRequest
物件由付款方式 ID 清單建構,該清單可識別商家決定接受的付款應用程式。付款方式 ID 會設為 supportedMethods
屬性的值。例如:
[merchant] 要求付款:
const request = new PaymentRequest([{
supportedMethods: 'https://bobbucks.dev/pay'
}], {
total: {
label: 'total',
amount: { value: '10', currency: 'USD' }
}
});
步驟 2:提供付款方式資訊清單
付款方式資訊清單是 JSON 檔案,用於定義哪些付款應用程式可使用此付款方式。
提供付款方式資訊清單
商家發起付款交易時,瀏覽器傳送 HTTP GET
要求至付款方式 ID 網址。伺服器回應付款方式資訊清單內文。
付款方式資訊清單包含 default_applications
和 supported_origins
這兩個欄位。
資源名稱 | 說明 |
---|---|
default_applications (必填) |
一系列指向代管付款應用程式的網頁應用程式資訊清單的網址陣列。(網址可以是相對網址)。這個陣列應參照開發資訊清單、正式版資訊清單等。 |
supported_origins |
指向來源的網址陣列,可能代管採用相同付款方式的第三方付款應用程式。請注意,付款方式可由多個付款應用程式實作。 |
付款方式資訊清單檔案應如下所示:
[付款處理常式] /payment-manifest.json:
{
"default_applications": ["https://bobbucks.dev/manifest.json"],
"supported_origins": [
"https://alicepay.friendsofalice.example"
]
}
瀏覽器讀取 default_applications
欄位時,會找到支援付款應用程式的網頁應用程式資訊清單連結清單。
視需要轉送瀏覽器,找出另一個位置的付款方式資訊清單
付款方式 ID 網址可以視需要使用 Link
標頭回應,指向另一個可讓瀏覽器擷取付款方式資訊清單的網址。如果付款方式資訊清單由其他伺服器代管,或是付款應用程式是由第三方提供,這項功能就非常實用。
設定付款方式伺服器以使用 HTTP Link
標頭回應,其中包含 rel="payment-method-manifest"
屬性和付款方式資訊清單網址。
舉例來說,如果資訊清單位於 https://bobbucks.dev/payment-manifest.json
,回應標頭會包含以下內容:
Link: <https://bobbucks.dev/payment-manifest.json>; rel="payment-method-manifest"
網址可以是完整的網域名稱或相對路徑。檢查 https://bobbucks.dev/pay/
以取得網路流量範例。您也可以使用 curl
指令:
curl --include https://bobbucks.dev/pay
步驟 3:提供網頁應用程式資訊清單
網頁應用程式資訊清單會用來定義當做名稱建議的網頁應用程式。這是定義漸進式網頁應用程式 (PWA) 的資訊清單檔案。
一般的網頁應用程式資訊清單看起來會像這樣:
[付款處理常式] /manifest.json:
{
"name": "Pay with Bobpay",
"short_name": "Bobpay",
"description": "This is an example of the Payment Handler API.",
"icons": [
{
"src": "images/manifest/icon-192x192.png",
"sizes": "192x192",
"type": "image/png"
},
{
"src": "images/manifest/icon-512x512.png",
"sizes": "512x512",
"type": "image/png"
}
],
"serviceworker": {
"src": "service-worker.js",
"scope": "/",
"use_cache": false
},
"start_url": "/",
"display": "standalone",
"theme_color": "#3f51b5",
"background_color": "#3f51b5",
"related_applications": [
{
"platform": "play",
"id": "com.example.android.samplepay",
"min_version": "1",
"fingerprints": [
{
"type": "sha256_cert",
"value": "4C:FC:14:C6:97:DE:66:4E:66:97:50:C0:24:CE:5F:27:00:92:EE:F3:7F:18:B3:DA:77:66:84:CD:9D:E9:D2:CB"
}
]
}
]
}
網頁應用程式資訊清單中描述的資訊也會用來定義付款應用程式在付款要求 UI 中的顯示方式。
資源名稱 | 說明 |
---|---|
name (必要) |
做為付款應用程式名稱。 |
icons (必要) |
做為付款應用程式圖示。只有 Chrome 會使用這些圖示;如果您未將這些圖示指定為付款方式,其他瀏覽器則可使用這些圖示。 |
serviceworker
|
用於偵測做為網頁式付款應用程式的 Service Worker。 |
serviceworker.src |
Service Worker 指令碼的下載網址。 |
serviceworker.scope |
代表網址的字串,用於定義 Service Worker 的註冊範圍。 |
serviceworker.use_cache |
Service Worker 指令碼的下載網址。 |
related_applications
|
用於偵測作為 OS 提供的付款應用程式的應用程式。詳情請參閱 Android 付款應用程式開發人員指南。 |
prefer_related_applications
|
用於判斷當 OS 提供的付款應用程式和網頁式付款應用程式都可用時,要啟動哪個付款應用程式。 |
系統會使用網頁應用程式資訊清單的 name
屬性做為付款應用程式名稱,將 icons
屬性做為付款應用程式圖示。
Chrome 如何判斷要啟動哪個付款應用程式
啟動平台專用的付款應用程式
如要啟動平台專屬的付款應用程式,必須符合下列條件:
related_applications
欄位是在網頁應用程式資訊清單中指定,且:- 已安裝應用程式的套件 ID 和簽章相符,但網頁應用程式資訊清單中的最低版本 (
min_version
) 小於或等於已安裝應用程式的版本。
- 已安裝應用程式的套件 ID 和簽章相符,但網頁應用程式資訊清單中的最低版本 (
prefer_related_applications
欄位為true
。- 平台專屬付款應用程式已安裝,且具備以下功能:
org.chromium.action.PAY
的意圖篩選器。- 指定為
org.chromium.default_payment_method_name
屬性值的付款方式 ID。
請參閱 Android 付款應用程式:開發人員指南,進一步瞭解如何設定相關設定。
[付款處理常式] /manifest.json
"prefer_related_applications": true,
"related_applications": [{
"platform": "play",
"id": "xyz.bobpay.app",
"min_version": "1",
"fingerprints": [{
"type": "sha256_cert",
"value": "92:5A:39:05:C5:B9:EA:BC:71:48:5F:F2:05:0A:1E:57:5F:23:40:E9:E3:87:14:EC:6D:A2:04:21:E0:FD:3B:D1"
}]
}]
如果瀏覽器判定可以使用平台專屬的付款應用程式,探索流程就會在此終止。否則,請繼續進行下一個步驟,也就是啟動網頁式付款應用程式。
啟動網頁式付款應用程式
網頁式付款應用程式應在網頁應用程式資訊清單的 serviceworker
欄位中指定。
[付款處理常式] /manifest.json:
"serviceworker": {
"src": "payment-handler.js"
}
瀏覽器將 paymentrequest
事件傳送至 Service Worker,以啟動網頁式付款應用程式。服務工作站也不需要事先註冊。您可以及時註冊。
瞭解特殊最佳化
瀏覽器如何略過付款要求使用者介面,直接啟動付款應用程式
在 Chrome 中呼叫 PaymentRequest
的 show()
方法時,PaymentRequest API 會顯示瀏覽器提供的 UI,名稱為「付款要求 UI」。這個 UI 可讓使用者選擇付款應用程式。按下付款要求 UI 中的「Continue」按鈕後,即可啟動所選的付款應用程式。
在啟動付款應用程式之前顯示付款要求 UI,會增加使用者完成付款所需的步驟。為了最佳化程序,瀏覽器可以將該資訊的執行要求委派給付款應用程式,並直接啟動付款應用程式,而在呼叫 show()
時不顯示付款要求 UI。
如要直接啟動付款應用程式,必須符合下列條件:
show()
可透過使用者手勢 (例如滑鼠點擊) 觸發。- 目前只有單一付款應用程式符合下列條件:
- 支援要求的付款方式 ID。
這是何時註冊的網頁式付款應用程式 (JIT)?
網頁式付款應用程式可在使用者未明確造訪付款應用程式網站及註冊 Service Worker 前啟動。使用者選擇使用網頁式付款應用程式付款時,服務工作站可以及時註冊。註冊時間有兩種類型:
- 如果向使用者顯示付款要求 UI,表示應用程式僅及時註冊,並在使用者按一下「Continue」時啟動。
- 如果系統略過付款要求 UI,付款應用程式會及時註冊並直接啟動。如果略過付款要求 UI 來啟動即時註冊的應用程式,就需要使用者手勢,以防止意外的跨來源服務工作站註冊。
後續步驟
您現在已能找到付款應用程式,接下來請瞭解如何開發平台專屬付款應用程式和網頁式付款應用程式。