Integration Guide

Getting Started With Direct Payment
Direct Payment Authorization and Captures
4
38 April 2012 PayPal Payments Pro Integration Guide
Direct Payment Authorization and Captures
You can use PayPal API operations to handle the capture of payments authorized using
DoDirectPayment.
 Sale Payment Action for Direct Payment
 Authorization and Capture for Direct Payment
 DoDirectPayment Authorization and Capture Example
 DoDirectPayment Reauthorization and Capture Example
Sale Payment Action for Direct Payment
A sale payment action represents a single payment that completes a purchase for a specified
amount.
A sale is the default payment action; however, you can also specify the action in your
DoDirectPayment requests:
PAYMENTACTION=Sale
A sale is the most straightforward payment action. Choose this payment action if the
transaction, including shipping of goods, can be completed immediately. Use this payment
action when you intend to fulfill the order immediately, such as would be the case for digital
goods or for items you have in stock for immediate shipment
After you execute the DoDirectPayment API operation, the payment is complete and further
action is unnecessary. You cannot capture a further payment or void any part of the payment
when you use this payment action.
Authorization and Capture for Direct Payment
An authorization payment action represents an agreement to pay and places the buyer’s funds
on hold for up to three days.
To set up an authorization, specify the following payment action in your DoDirectPayment
request:
PAYMENTACTION=Authorization
An authorization enables you to capture multiple payments up to 115% of, or USD $75 more
than, the amount you initially specify in the DoDirectPayment request. Choose this payment
action if you need to ship the goods before capturing the payment or if there is some reason not
to accept the payment immediately.
The honor period, for which funds can be held, is 3 days. The valid period, for which the
authorization is valid, is 29 days. You can reauthorize the 3-day honor period at most once
within the 29-day valid period.