Authorization Service

The payPalAuthorizationService service:

■	Obtains the authorization.

■	Enables 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:

■	payPalAuthorizationService_run

■	payPalAuthorizationService_paypalOrderId

■	payPalAuthorizationService_paypalCustomerEmail

■	billTo_email

■	merchantID

■	merchantReferenceCode

■	purchaseTotals_currency

■	purchaseTotals_grandTotalAmount

■	A request ID:

●	For a custom order: payPalAuthorizationService_paypalEcOrderSetupRequestID

●	For a billing agreement: payPalAuthorizationService_paypalDoRefTransactionRequestID

■	A request token:

●	For a custom order: payPalAuthorizationService_paypalEcOrderSetupRequestToken

●	For a billing agreement: payPalAuthorizationService_paypalDoRefTransactionRequestToken

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

■	billTo_city

■	billTo_country

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

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

■	billTo_street1

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