Update order details

DocsCurrentADVANCED

Last updated: Apr 19th, 11:56pm

For increased flexibility when obtaining payments from buyers, you can update an existing order. Updating orders allows you to:

Determine additional amounts, including shipping and tax.

Capture a different total amount without the payer re-approving the order.

Update fields, such as shipping address, after collecting them from the payer.

Know before you code

Required
Expanded Checkout

Complete the steps in Get started to get your sandbox account login information and access token from the Developer Dashboard.

This feature modifies an existing Checkout integration and uses the following:
- PayPal JavaScript SDK
- Orders REST API - Create order and Update order

Optional
Explore PayPal APIs with Postman

You can use Postman to explore and test PayPal APIs. Learn more in our Postman guide.

Show a continue button

If you update the final amount of the order after the payer approves the payment, or update other amount fields, such as shipping or tax, show a Continue button during checkout instead of a Pay Now button. A Continue button indicates to the payer that the amount or other details might change before they complete the order.

To show a Continue button, add commit=false in the script tag as shown in the following example:

1<script src="https://www.paypal.com/sdk/js?client-id=CLIENT-ID&commit=false">
2</script>

Tip: Using commit=false reduces the number of payment methods that are shown to your payer because not all funding sources can be used when modifying the order. When possible, determine the final amount before the payer approves the transaction, and avoid using PATCH.

Update order details

Before you capture the money from the order, call the Orders API on your server with the order ID. You can pass in a different amount, invoice_id, and custom_id. See the following code sample:

1curl -v -X PATCH 'https://api-m.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T' \
2 -H 'Authorization: Bearer ACCESS-TOKEN'  \
3 -H 'Content-Type: application/json' \
4 -d '[
5    {
6  "op": "add",
7  "path": "/purchase_units/@reference_id=='PUHF'/invoice_id",
8  "value": {
9    "integration_artifact": "INV-HighFashions"
10  }
11 }
12]'