Verwenden Sie Zahlungsposten in flexiblen Zahlungsszenarien.Öffentliche Vorschau

Verwenden Sie Zahlungsposten für komplexe Zahlungen wie Mehrfacherfassungen.

Sie können Zahlungsposten während komplexer Zahlungen wie Mehrfacherfassungen und Übererfassungen verwenden.

Multicapture

Sie können Zahlungsposten bei Mehrfacherfassungen verwenden.

Notiz

Mehrfacherfassung wird für Klarna oder PayPal nicht unterstützt.

Einen nicht erfassten PaymentIntent erstellen und bestätigen

Notiz

The API response doesn’t include line items by default. To return line items, expand amount_details.line_items.

Geben Sie bei der Erstellung des PaymentIntent die capture_method als manuell an und verwenden Sie den Parameter if_available, um Mehrfacherfassung für diese Zahlung anzufordern. Der erstellte PaymentIntent ermöglicht mehrere Erfassungen, sofern die Zahlungsmethode dies unterstützt.

In der Antwort enthält das Feld amount_details die in PaymentIntent angegebenen Einzelposten.

{
  "amount": 4600,
  "amount_capturable": 4600,
  "amount_received": 0,
  "payment_details": {
    "customer_reference": "customer_reference",
    "order_reference": "order_reference"
  },
  "amount_details": {
    "discount_amount": 200,
    "tax": {
      "total_tax_amount": 400
    },
    "shipping": {
      "from_postal_code": "94110",
      "to_postal_code": "94117",
      "amount": 400
    },
    "line_items": [
      {
        "product_code": "SKU001",
        "product_name": "Product 001",
        "unit_cost": 2000,
        "quantity": 1,
        "unit_of_measure": "feet",
        "payment_method_options": {
          "card": {
            "commodity_code": "123123"
          }
        }
      },
      {
        "product_code": "SKU002",
        "product_name": "Product 002",
        "unit_cost": 2000,
        "quantity": 1,
        "unit_of_measure": "gallons",
        "payment_method_options": {
          "card": {
            "commodity_code": "123123"
          }
        }
      }
    ]
  }
  ...
}

PaymentIntent erfassen

Sie können amount_details beim ersten Erfassen hinzufügen, auch wenn sie bei der Erstellung nicht angegeben wurden.
Wenn Sie bei der Erstellung amount_details angegeben haben, müssen Sie entweder amount_details übergeben oder sie bei der ersten Erfassung deaktivieren.

Dieselben Regeln gelten für amount_details [line_items] — Sie können sie beim ersten Erfassen hinzufügen, wenn Sie sie nicht bei der Erstellung angegeben haben, müssen sie jedoch einbeziehen oder explizit entfernen, falls sie bei der Erstellung vorhanden waren.

In der Antwort enthält das Feld amount_details die bei der ersten Erfassung angegebenen Einzelposten.

{
  "amount": 4600,
  "amount_capturable": 2300,
  "amount_received": 2300,
  "payment_details": {
    "customer_reference": "customer_reference",
    "order_reference": "order_reference"
  },
  "amount_details": {
    "discount_amount": 100,
    "tax": {
      "total_tax_amount": 200
    },
    "shipping": {
      "from_postal_code": "94110",
      "to_postal_code": "94117",
      "amount": 200
    },
    "line_items": [
      {
        "product_code": "SKU001",
        "product_name": "Product 001",
        "unit_cost": 2000,
        "quantity": 1,
        "unit_of_measure": "feet",
        "payment_method_options": {
          "card": {
            "commodity_code": "123123"
          }
        }
      }
    ]
  },
  "status": "requires_capture"
  ...
}

Der PaymentIntent verbleibt im Status requires_capture. An dieser Stelle können Sie entweder:

Erfassen Sie den PaymentIntent weiterhin mehrfach bis zum vollen Betrag des PaymentIntent.
Versetzen Sie PaymentIntent in den Status succeeded, indem Sie final_capture auf true setzen oder eine Erfassung ohne den final_capture-Parameter durchführen (weil final_capture standardmäßig auf true gesetzt ist).

Wenn frühere Erfassungen amount_details oder amount_details[line_items] enthielten, müssen Sie sie weiterhin in nachfolgende Erfassungen einbeziehen.
Wenn frühere Erfassungen diese Felder nicht enthielten, können Sie sie in späteren Erfassungen nicht hinzufügen.

In der Antwort enthält das Feld amount_details die Einzelposten der ersten beiden Erfassungen gemäß den folgenden Regeln:

discount_amount, tax.total_tax_amount und shipping.amount werden über alle Erfassungen hinweg summiert.
shipping.from_postal_code und shipping.to_postal_code könnten in den Erfassungen weggelassen werden, aber wenn sie bereitgestellt werden, dürfen Sie sie nicht zwischen den Erfassungen ändern.
line_items wird über alle Erfassungen hinweg aggregiert.

{
  "amount": 4600,
  "amount_capturable": 0,
  "amount_received": 4600,
  "payment_details": {
    "customer_reference": "customer_reference",
    "order_reference": "order_reference"
  },
  "amount_details": {
    "discount_amount": 200,
    "tax": {
      "total_tax_amount": 400
    },
    "shipping": {
      "from_postal_code": "94110",
      "to_postal_code": "94117",
      "amount": 400
    },
    "line_items": [
      {
        "product_code": "SKU001",
        "product_name": "Product 001",
        "unit_cost": 2000,
        "quantity": 1,
        "unit_of_measure": "feet",
        "payment_method_options": {
          "card": {
            "commodity_code": "123123"
          }
        }
      },
      {
        "product_code": "SKU002",
        "product_name": "Product 002",
        "unit_cost": 2000,
        "quantity": 1,
        "unit_of_measure": "gallons",
        "payment_method_options": {
          "card": {
            "commodity_code": "123123"
          }
        }
      }
    ]
  },
  "status": "succeeded"
  ...
}

Übererfassung

Sie können Zahlungsposten während Übererfassungen verwenden.

Einen nicht erfassten PaymentIntent erstellen und bestätigen

Notiz

The API response doesn’t include line items by default. To return line items, expand amount_details.line_items.

Geben Sie bei der Erstellung des PaymentIntent die capture_method als manuell an und verwenden Sie den Parameter if_available, um die Übererfassung für diese Zahlung anzufragen. Der erstellte PaymentIntent erlaubt die Übererfassung, wenn die Zahlungsmethode dies unterstützt.

In der Antwort enthält das Feld amount_details die in PaymentIntent angegebenen Einzelposten.

{
  "amount": 4600,
  "amount_capturable": 4600,
  "amount_received": 0,
  "payment_details": {
    "customer_reference": "customer_reference",
    "order_reference": "order_reference"
  },
  "amount_details": {
    "discount_amount": 200,
    "tax": {
      "total_tax_amount": 400
    },
    "shipping": {
      "from_postal_code": "94110",
      "to_postal_code": "94117",
      "amount": 400
    },
    "line_items": [
      {
        "product_code": "SKU001",
        "product_name": "Product 001",
        "unit_cost": 2000,
        "quantity": 1,
        "unit_of_measure": "feet",
        "payment_method_options": {
          "card": {
            "commodity_code": "123123"
          }
        }
      },
      {
        "product_code": "SKU002",
        "product_name": "Product 002",
        "unit_cost": 2000,
        "quantity": 1,
        "unit_of_measure": "gallons",
        "payment_method_options": {
          "card": {
            "commodity_code": "123123"
          }
        }
      }
    ]
  }
  ...
}

PaymentIntent erfassen

Um mehr als den aktuell autorisierten Betrag für einen PaymentIntent zu erfassen, verwenden Sie Endpunkt erfassen und geben einen amount_to_capture bis zum maximum_amount_capturable an.

Übergeben Sie bei der Erfassung einen aktualisierten amount_details Hash, der mit dem erfassten Betrag übereinstimmt.

In der Antwort enthält das Feld amount_details die Posten, die beim Erfassen angegeben wurden.

{
  "amount": 5000,
  "amount_capturable": 0,
  "amount_received": 5000,
  "payment_details": {
    "customer_reference": "customer_reference",
    "order_reference": "order_reference"
  },
  "amount_details": {
    "discount_amount": 200,
    "tax": {
      "total_tax_amount": 600
    },
    "shipping": {
      "from_postal_code": "94110",
      "to_postal_code": "94117",
      "amount": 600
    },
    "line_items": [
      {
        "product_code": "SKU001",
        "product_name": "Product 001",
        "unit_cost": 2000,
        "quantity": 1,
        "unit_of_measure": "feet",
        "payment_method_options": {
          "card": {
            "commodity_code": "123123"
          }
        }
      },
      {
        "product_code": "SKU002",
        "product_name": "Product 002",
        "unit_cost": 2000,
        "quantity": 1,
        "unit_of_measure": "gallons",
        "payment_method_options": {
          "card": {
            "commodity_code": "123123"
          }
        }
      }
    ]
  },
  "status": "succeeded"
  ...
}