---
title: PaymentRequest
slug: Web/API/PaymentRequest
translation_of: Web/API/PaymentRequest
---
<div>{{securecontext_header}}{{APIRef("Payment Request API")}}</div>

<p><strong><code>PaymentRequest</code></strong> 介面是 <a href="/zh-TW/docs/Web/API/Payment_Request_API">Payment Request API</a> 的主要切入點，它能讓網頁或 app 接受終端用戶的付款。</p>

<h2 id="建構子">建構子</h2>

<dl>
 <dt>{{domxref('PaymentRequest.PaymentRequest()','PaymentRequest()')}} {{securecontext_inline}}</dt>
 <dd>建立新的 <code>PaymentRequest</code> 物件。</dd>
</dl>

<h2 id="屬性">屬性</h2>

<dl>
 <dt>{{domxref('PaymentRequest.id')}} {{readonlyinline}}{{securecontext_inline}}</dt>
 <dd>個別 <code>PaymentRequest</code> 的唯一標識符（unique identifier），可透過 <code>details.id</code> 設定之。若尚未指定，預設為 UUID。</dd>
 <dt>{{domxref('PaymentRequest.shippingAddress')}} {{readonlyinline}} {{securecontext_inline}}</dt>
 <dd>若透過付款設定（payment options）請求的話，回傳用戶指定的運送地址，以便計算運輸事宜。只有在呼叫的建構子 <code>requestShipping</code> flag 為 true 時，此屬性才能作動。另外，部份瀏覽器會出於隱私上的理由而只節錄部分地址，除非用戶表示交易手續即將完成（例如按下「付款」鈕）。</dd>
 <dt>{{domxref('PaymentRequest.shippingOption')}} {{readonlyinline}} {{securecontext_inline}}</dt>
 <dd>回傳的運送選項的標識符。只有在呼叫的建構子 <code>requestShipping</code> flag 為 true 時，此屬性才能作動。</dd>
 <dt>{{domxref('PaymentRequest.shippingType')}} {{readonlyinline}} {{securecontext_inline}}</dt>
 <dd>回傳用於完成交易的運送類型。可以是 <code>shipping</code>, <code>delivery</code>, <code>pickup</code>, 或在建構子未提供的情形下：<code>null</code>。</dd>
</dl>

<h3 id="事件處理器">事件處理器</h3>

<dl>
 <dt>{{domxref('PaymentRequest.onshippingaddresschange')}} {{securecontext_inline}}</dt>
 <dd>用戶修改運送地址時觸發之。</dd>
 <dt>{{domxref('PaymentRequest.onshippingoptionchange')}} {{securecontext_inline}}</dt>
 <dd>用戶修改運送選項時觸發之。</dd>
 <dt>{{domxref('PaymentRequest.onpaymentmethodchange')}} {{securecontext_inline}}</dt>
 <dd>針對付款方法（如 Apple Pay），用戶修改支付方式時觸發之，比方說從信用卡改為簽帳卡。</dd>
 <dt>{{domxref('PaymentRequest.onmerchantvalidation')}} {{securecontext_inline}}</dt>
 <dd>針對付款方法（如 Apple Pay），本事件會呼叫 {{event("merchantvalidation")}} 事件，在用戶代理要求驗證付款商家或供應商是否合法時觸發之。</dd>
</dl>

<h2 id="方法">方法</h2>

<dl>
 <dt>{{domxref('PaymentRequest.canMakePayment()')}} {{securecontext_inline}}</dt>
 <dd>在呼叫 <code>show()</code> 前告訴 <code>PaymentRequest</code> 物件能不能付款。</dd>
</dl>

<dl>
 <dt>{{domxref('PaymentRequest.show()')}} {{securecontext_inline}}</dt>
 <dd>讓用戶代理開始付款請求的用戶交互。</dd>
 <dt>{{domxref('PaymentRequest.abort()')}} {{securecontext_inline}}</dt>
 <dd>讓用戶代理結束付款請求並刪除可能顯示的任何用戶界面。</dd>
</dl>

<h2 id="規範">規範</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">規範</th>
   <th scope="col">狀態</th>
   <th scope="col">註解</th>
  </tr>
  <tr>
   <td>{{SpecName('Payment','#paymentrequest-interface','PaymentRequest')}}</td>
   <td>{{Spec2('Payment')}}</td>
   <td>初始定義。</td>
  </tr>
 </tbody>
</table>

<h2 id="瀏覽器相容性">瀏覽器相容性</h2>

<div>


<p>{{Compat("api.PaymentRequest")}}</p>
</div>