Authorize and capture a payment

Important: This integration method is Deprecated as of January 1, 2017. For new integrations, see the PayPal Express 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 3 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 PAYMENTREQUEST_0_PAYMENTACTION=Authorization in the SetExpressCheckout and DoExpressCheckoutPayment calls.

    After a successful DoExpressCheckoutPayment request, you receive the Authorization ID in the response. Use the Authorization ID in subsequent DoCapture API calls.

  • To capture the payment, issue a DoCapture request 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).

Additional information

Next

Your Express Checkout Authorization and Capture payment is complete. Next, test your integration.