2013

Authorization and Capture API Operation Reference
DoAuthorization API Operation
3
32 February 01, 2013 Name-Value Pair API Developer Guide
DoAuthorization API Operation
Authorize a payment.
DoAuthorization Request Message
DoAuthorization Request Fields
PENDINGREASON
NOTE: PendingReason is returned in the response only if PaymentStatus is
Pending. This field does not apply to capturing point-of-sale authorizations,
which do not create pending payments.
Reason the payment is pending. It is one of the following values:
 none: – No pending reason.
 address – The payment is pending because your customer did not include a
confirmed shipping address and your Payment Receiving Preferences is set such
that you want to manually accept or deny each of these payments. To change your
preference, go to the Preferences section of your Profile.
 echeck – The payment is pending because it was made by an eCheck that has not
yet cleared.
 intl –The payment is pending because you hold a non-U.S. account and do not
have a withdrawal mechanism. You must manually accept or deny this payment
from your Account Overview.
 multi-currency – You do not have a balance in the currency sent, and you do
not have your Payment Receiving Preferences set to automatically
convert and accept this payment. You must manually accept or deny this payment.
 regulatoryreview – The payment is pending while we make sure it meets
regulatory requirements. You will be contacted again in 24-72 hours with the
outcome of the review.
 verify – The payment is pending because you are not yet verified. You must
verify your account before you can accept this payment.
 other – The payment is pending for a reason other than those listed above. For
more information, contact PayPal Customer Service.
Field Description
METHOD (Required) Must be DoAuthorization.
TRANSACTIONID (Required) Value of the order's transaction identification number returned by PayPal.
Character length and limitations: 19 single-byte characters
Field Description