Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.paypal.ai/llms.txt

Use this file to discover all available pages before exploring further.

Ship items from a single order to multiple addresses. Common scenarios include:
  • Holiday gifts sent to different recipients
  • Corporate orders shipped to various office locations
  • Drop shipping to different addresses
Use multiple purchase_units in a single PayPal order, each with its own shipping address. The customer pays once but items ship to different locations.

​
Prerequisites

​
Integrate server side

Endpoint: POST /v2/checkout/orders
curl -X POST https://api-m.paypal.com/v2/checkout/orders \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -d '{
    "intent": "CAPTURE",
    "purchase_units": [
      {
        "reference_id": "SHIPMENT_1",
        "amount": {
          "currency_code": "USD",
          "value": "50.00"
        },
        "shipping": {
          "name": {
            "full_name": "Recipient 1"
          },
          "address": {
            "address_line_1": "123 Main St",
            "admin_area_2": "San Jose",
            "admin_area_1": "CA",
            "postal_code": "95131",
            "country_code": "US"
          }
        }
      },
      {
        "reference_id": "SHIPMENT_2",
        "amount": {
          "currency_code": "USD",
          "value": "30.00"
        },
        "shipping": {
          "name": {
            "full_name": "Recipient 2"
          },
          "address": {
            "address_line_1": "456 Oak Ave",
            "admin_area_2": "Austin",
            "admin_area_1": "TX",
            "postal_code": "78701",
            "country_code": "US"
          }
        }
      }
    ]
  }'