Overcapture

最終更新日： 2026年10月23日

作成対象：

オーバーキャプチャを使用すると、PayPalのオーバーキャプチャ契約を持つ資格のある加盟店は、注文の請求時に最初に承認された金額を超える金額をキャプチャできます。例えば、最終金額は、重量にもとづく調整や、承認からフルフィルメントまでの材料費の変更によって増加します。

PayPalは、各加盟店アカウントの超過取得制限を決定します。 Payment Servicesでオーバーキャプチャを有効にしても、契約書が確立されないか、PayPalで承認されている上限が増えません。

NOTE

このトピックでは、Payment Services拡張機能のオーバーキャプチャについて説明します。 Adobe Commerce as a Cloud Serviceについては、個別の可用性とイネーブルメントの要件については、カスタムキャプチャ量を参照してください。

前提条件

オーバーキャプチャを有効にする前に：

オーバーキャプチャは、Payment Services 2.17.0以降でのみ使用できます。
Overcaptureは、米国を拠点とする企業のみが利用できます。 PayPalのオーバーキャプチャ要件（PSD2）は、欧州経済地域（EEA）のPayPal バイヤーに販売する米国を拠点とするマーチャントにも適用されます。
Overcaptureは、代替支払い方法（APM）では利用できません。
PayPalでオーバーキャプチャ契約を取得し、PayPal アカウントマネージャーで加盟店アカウントに承認された制限を確認します。
支払い方法の Payment Action をAuthorizeに設定します。オーバーキャプチャは、請求時に後でキャプチャされた承認済み注文に適用されます。自動的にAuthorize and Captureでキャプチャされた注文には適用されません。 Set Payment Services を支払い方法として参照してください。

管理者 サイドバーで、Stores > Settings>Configurationに移動します。
左側のパネルで、Salesを展開し、Payment Methodsを選択します。
ストアスコープセレクターを使用して設定するweb サイトを選択します。
FEATURED ADOBE PAYMENT SOLUTIONセクションを展開します。
Payment Servicesセクションで、General Configuration セクションを展開します。
Over Capture EnabledをYesに設定します。
Save Configをクリックして変更を保存します。
System > Cache Managementに移動し、Flush Cacheをクリックして、無効なすべてのキャッシュを更新します。

オーバーキャプチャは、Adminでの請求中に行われます。要求されたキャプチャ金額は、加盟店アカウントに対してPayPalが承認した制限内である必要があります。標準の請求ワークフローについては、請求書の作成を参照してください。

管理者 サイドバーで、Sales > Ordersに移動します。
まだキャプチャされていない承認された支払いで注文を開きます。
Invoiceをクリックします。
「カスタム取得金額」フィールドに、取得する合計金額を入力します。例えば、許可された金額がUSD 100で、合意された最終請求がUSD 110の場合は、10ではなく110と入力します。リクエストされた金額は、PayPalが承認した限度内である必要があります。
請求書のオンラインキャプチャを選択して、支払いプロバイダーを通じて支払いをリクエストします。
請求書を確認し、Submit Invoiceをクリックします。

標準の請求書の作成エンドポイントを使用します。

POST /rest/<store_code>/V1/order/<orderId>/invoice

注文のストアコードと注文の内部IDを使用します。承認済みの管理者または統合トークンで認証し、Content-Type: application/jsonを設定します。

次のペイロードの例では、加盟店のPayPal契約でその金額が許可されている場合、USD 100で許可された注文について、USD 110のオンラインキャプチャを含む請求書を全額請求します。

{
  "capture": true,
  "notify": false,
  "arguments": {
    "extension_attributes": {
      "custom_capture_amount": 110
    }
  }
}

この例では、

PayPalがオーバーキャプチャリクエストを拒否した場合：

支払に使用するPayPal加盟店アカウントに対して、超過取得契約が有効であることを確認します。
要求された金額が承認済みの限度内にあることを確認してください。上限を超えた場合は、より低い金額をリクエストするか、PayPalのアカウントマネージャーに連絡して増加について相談してください。

recommendation-more-help

commerce-help-payment-services