Authorize and capture a payment
Important: This integration method is deprecated as of January 1, 2017. PayPal continues to support existing merchants using this method, but please be advised new features and enhancements will not be applied to these integrations. For new integrations, see the PayPal Checkout Integration Guide.
You complete an authorization and capture payment action in two steps. First the funds are authorized from the buyer's PayPal account when a buyer places an order on your website. Later, when you are ready to ship the purchased items, you make another API call to capture the funds, or you can manually capture the payment using your PayPal account user interface.
How authorization and capture works:
An authorization places a hold on the funds.
An authorization period is for 29 days; which means you have up to 29 days to capture the payment for the authorization. However, the funds are guaranteed for the first 3 days. These three days are known as the "honor period".
Within a 29-day authorization period, you can issue multiple re-authorizations after the initial three-day honor period expires. A re-authorization restarts the honor period. If you do a re-authorization on the 27th day of the authorization, you get only two days of honor period.
You can capture less than the original authorization, full authorization amount or even more than the authorization amount (up to 115% of the original authorization or $75 USD more, whichever is less).
You can also do partial captures during a single authorization period. This feature has to be enabled on your PayPal account and is subject to approval.
Use the authorization and capture model for payment when you have delayed shipments and do not wish to capture the funds right away.
Required code changes for authorization and capture
To implement authorization and capture, make these changes to the basic Express Checkout integration:
To authorize the payment, set
After a successful
DoExpressCheckoutPaymentrequest, you receive the Authorization ID in the response. Use the Authorization ID in subsequent
To capture the payment, issue a
DoCapturerequest using the returned Authorization ID.
For detailed reference information, see DoCapture API Operation (NVP).
Voids and refunds for authorization and capture transactions
To void an authorization, see doVoid API Operation (NVP).
To refund a captured transaction, see RefundTransaction API Operation (NVP).
Your Express Checkout Authorization and Capture payment is complete. Next, test your integration.