Launch v2 PayPal Checkout APIs

Rahul Dighe
Feb 7 · 4 min read

Why v2?

The new v2 APIs do the heavy lifting for merchants and developers. They deliver a comprehensive and holistic solution that benefits all users. They include a cohesive and consistent set of API endpoints encompassing PayPal’s current and future payment processing capabilities to serve all merchants the world over.

  • Minimal number of required fields. Start small with just 5 lines of JSON to Create an Order and customize with other optional fields as the use case demands.
curl -v -X POST https://api.sandbox.paypal.com/v2/checkout/orders \
-H "Content-Type: application/json" \
-H "Authorization: Bearer Access-Token" \
-d '{
"intent": "CAPTURE",
"purchase_units": [{
"amount": {
"currency_code": "USD",
"value": "100.00"
}
}]
}'
curl -v -X POST https://api.sandbox.paypal.com/v2/checkout/orders/order_id/capture \
-H "Content-Type: application/json" \
-H "Authorization: Bearer Access-Token" \
-H "PayPal-Request-Id: 7b92603e-77ed-4896-8e78-5dea2050476a"
-d '{}'
POST v1/payments/payment/sale/{sale_id}/refund
POST v1/payments/payment/capture/{capture_id}/refund
With this launch we would have a single end point to refundPOST v2/payments/captures/{capture_id}/refund

Ready to switch?

If you are signing up now or are about to start to integrate, we encourage you to start with the new v2 APIs. Please view the PayPal Checkout Integration Guide to get started. New enhancements and improvements will only be launched on these.

Down memory lane…

PayPal was an early pioneer in opening up its platform, enabling thousands of small merchants to integrate the PayPal button on their website with just a few clicks. As our business grew, bigger merchants signed up to offer PayPal, and with that followed the need to simplify back office processing (e.g. refunds). To support that user need, we launched our first ever SOAP API in 2004. In 2013, as the industry and API paradigms evolved, we launched our flagship v1/payments REST API.

Focus on documentation

We have taken great care to ensure that the resource names, end points and fields are intuitive. We know too that equally good documentation is key to a successful integration and a positive merchant/developer experience.

Let us know what you think

Here at PayPal we are passionate and committed to your success. We encourage you to try our new APIs and share your feedback so we can further streamline and continue to improve your integration experience.

PayPal Engineering

The PayPal Engineering Blog

Thanks to Dan Shaw.

Rahul Dighe

Written by

Loves building products. Presently > Checkout API Product @ PayPal

PayPal Engineering

The PayPal Engineering Blog