PayPal

Orders

An order represents a payment between two or more parties. Use the Orders API to create, update, retrieve, authorize, and capture orders.

Payments#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

An order represents a payment between two or more parties. Use the Orders API to create, update, retrieve, authorize, and capture orders.

Endpoints 9

externalcallback

  • POSTReceive updated order information via callback URL/v2/checkout/orders/order-update-callbackThe documentation for this 'endpoint' is different from the other endpoints under v2 Orders. For this endpoint the role of client and server is reversed. The…

orders

  • POSTCreate order/v2/checkout/ordersCreates an order. Merchants and partners can add Level 2 and 3 data to payments to reduce risk and payment processing costs. For more information about…
  • GETShow order details/v2/checkout/orders/:id?fields=stringShows details for an order, by ID.<blockquote><strong>Note:</strong> For error handling and troubleshooting, see <a…
  • PATCHUpdate order/v2/checkout/orders/:idUpdates an order with a CREATED or APPROVED status. You cannot update an order with the COMPLETED status.<br/><br/>To make an update, you must provide a…
  • POSTConfirm the Order/v2/checkout/orders/:id/confirm-payment-sourcePayer confirms their intent to pay for the the Order with the given payment source.
  • POSTAuthorize payment for order/v2/checkout/orders/:id/authorizeAuthorizes payment for an order. To successfully authorize payment for an order, the buyer must first approve the order or a valid payment_source must be…
  • POSTCapture payment for order/v2/checkout/orders/:id/captureCaptures payment for an order. To successfully capture payment for an order, the buyer must first approve the order or a valid payment_source must be provided…
  • POSTAdd tracking information for an Order./v2/checkout/orders/:id/trackAdds tracking information for an Order.

trackers

  • PATCHUpdate or cancel tracking information for an order/v2/checkout/orders/:id/trackers/:tracker_idUpdates or cancels the tracking information for a PayPal order, by ID. Updatable attributes or…

API details

Base URL
https://api-m.paypal.com
Authentication
OAuth 2.0 (client credentials flow) with 6 scopes
Operations
9 operations on 8 pathsPOST 6PATCH 2GET 1
Main resources
orders 7externalcallback 1trackers 1
Response formats
application/json
Description format
OpenAPI 3.0.4, API version 2.32

How to test the Orders in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Orders collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (client credentials flow) with 6 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Receive updated order information via callback URL” (POST /v2/checkout/orders/order-update-callback), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Orders?

An order represents a payment between two or more parties. Use the Orders API to create, update, retrieve, authorize, and capture orders. It is listed under Payments and has 9 endpoints.

Who publishes the Orders?

It is listed from PayPal's public API description (an OpenAPI document), not published by PayPal on Swastik Codes. Anyone who controls paypal.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Orders?

Requests go to https://api-m.paypal.com. Endpoint paths are added to this base URL.

How do I authenticate with the Orders?

With OAuth 2.0 (client credentials flow) with 6 scopes.

How many endpoints does the Orders have?

9 operations on 8 paths (6 POST, 2 PATCH, 1 GET). The largest groups are orders, externalcallback, trackers.

Is forking the Orders free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.