RequestPermissions API Operation

scope

xs:string

(Required) At least 1 of the following permission categories:

• EXPRESS_CHECKOUT - Express Checkout

• DIRECT_PAYMENT - Direct payment by debit or credit card

• SETTLEMENT_CONSOLIDATION - Settlement consolidation

• SETTLEMENT_REPORTING - Settlement reporting

• AUTH_CAPTURE - Payment authorization and capture

• MOBILE_CHECKOUT - Mobile checkout

• BILLING_AGREEMENT - Billing agreements

• REFERENCE_TRANSACTION - Reference transactions

• AIR_TRAVEL - Express Checkout for UTAP

• MASS_PAY - Mass pay

• TRANSACTION_DETAILS - Transaction details

• TRANSACTION_SEARCH - Transaction search

• RECURRING_PAYMENTS - Recurring payments

• ACCOUNT_BALANCE - Account balance

• ENCRYPTED_WEBSITE_PAYMENTS - Encrypted website payments

• REFUND - Refunds

• NON_REFERENCED_CREDIT - Non-referenced credit

• BUTTON_MANAGER - Button Manager

• MANAGE_PENDING_TRANSACTION_STATUS includes ManagePendingTransactionStatus

• RECURRING_PAYMENT_REPORT - Reporting for recurring payments

• EXTENDED_PRO_PROCESSING_REPORT - Extended Pro processing

• EXCEPTION_PROCESSING_REPORT - Exception processing

• ACCOUNT_MANAGEMENT_PERMISSION - Account Management Permission (MAM)

• ACCESS_BASIC_PERSONAL_DATA - User attributes

• ACCESS_ADVANCED_PERSONAL_DATA - User attributes

• INVOICING - Invoicing

callback

xs:string

(Required) Your callback function that specifies actions to take after the account holder grants or denies the request.

requestEnvelope

common:requestEnvelope

(Required) Information common to each API operation, such as the language in which an error message is returned.

detailLevel

common:DetailLevelCode

(Optional) Level of detail required by the client application for components. Value is:

• ReturnAll — This value provides the maximum level of detail (default).

errorLanguage

xs:string

(Required) RFC 3066 language in which error messages are returned; by default it is en_US, which is the only language currently supported.

token

xs:string

(Required) A token from PayPal that enables the request to obtain permissions.

responseEnvelope

common:ResponseEnvelope

Common response information, including a timestamp and the response acknowledgment status.

ack

common:AckCode

Acknowledgment code. Value is:

• Success — The operation completed successfully.

• Failure — The operation failed.

• Warning — Warning.

• SuccessWithWarning — The operation completed successfully; however, there is a warning message.

• FailureWithWarning — The operation failed with a warning message.

build

Build number; it is used only by Merchant Technical Support.

correlationId

Correlation ID; it is used only by Merchant Technical Support.

timestamp

Date on which the response was sent. The time is currently not supported.

error

common:ErrorData

Detailed error information.

responseEnvelope

common:ResponseEnvelope

Common response information, including a timestamp and the response acknowledgment status.

category

common:ErrorCategory

The location where the error occurred.

Value is:

• System — The system encountered errors; try again

• Application — The application encountered errors; try again

• Request — The request was incorrect

domain

The domain to which this service belongs.

errorId

A number that uniquely identifies a particular error.

exceptionID

This field is not used.

message

A description of the error.

parameter

common:ErrorParameter

Represents contextual information about the error.

severity

common:ErrorSeverity

The severity of the error encountered.

Value is:

• Error — Processing of the request was interrupted

• Warning — Processing of the request was completed

subdomain

This field is not used.

ack

common:AckCode

Acknowledgment code. Value is:

• Success — The operation completed successfully.

• Failure — The operation failed.

• Warning — Warning.

• SuccessWithWarning — The operation completed successfully; however, there is a warning message.

• FailureWithWarning — The operation failed with a warning message.

build

Build number; it is used only by Merchant Technical Support.

correlationId

Correlation ID; it is used only by Merchant Technical Support.

timestamp

Date on which the response was sent. The time is currently not supported.

520002

Internal error

550001

User is not allowed to perform this action

560022

Invalid API Caller Account

580022

Transaction refused because of an invalid argument. See additional error messages for details.

580028

Invalid Redirect URL