Home > Requesting Services > Authorization Service


Authorization Service

The payPalAuthorizationService service:

nObtains the authorization.

nEnables you to perform multiple partial authorizations.

When you use the Authorization service, the authorization typically commits funds for three business days. Contact PayPal to find out how to negotiate an honor interval that is longer than three days. You can try to capture the authorization for a period of 29 days after the authorization. If funds are still available, then the capture will be successful.

When you request payPalAuthorizationService, you must include the following fields in the request:

npayPalAuthorizationService_run

npayPalAuthorizationService_paypalOrderId

npayPalAuthorizationService_paypalCustomerEmail

nbillTo_email

nmerchantID

nmerchantReferenceCode

npurchaseTotals_currency

npurchaseTotals_grandTotalAmount

nA request ID:

lFor a custom order:
payPalAuthorizationService_paypalEcOrderSetupRequestID

lFor a billing agreement:
payPalAuthorizationService_paypalDoRefTransactionRequestID 

nA request token:

lFor a custom order:
payPalAuthorizationService_paypalEcOrderSetupRequestToken

lFor a billing agreement:
payPalAuthorizationService_paypalDoRefTransactionRequestToken 

When Decision Manager is enabled, you must also submit the following fields in the request:

nbillTo_city

nbillTo_country

nbillTo_postalCode—required only when billTo_country is set to US or CA.

nbillTo_state—required only when billTo_country is set to US or CA.

nbillTo_street1

Additional fields are optional. The required and optional fields are described in API Fields.