Update order details

DocsCurrentStandard

Last updated: Sept 26th, 5:17pm

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
Get Started

Complete the steps in Get started to get the following sandbox account information from the Developer Dashboard:

Your personal and business sandbox accounts.

Your access token.

Required
Standard or Advanced Checkout

This feature modifies an existing standard Checkout or advanced Checkout integration and uses the following:

JavaScript SDK: Adds PayPal-supported payment methods.

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]'