GetPrePaymentDisclosure API Operation

payKey

xs:string

(Required) The pay key that identifies the payment for which you want to retrieve details. This is the pay key returned in the pay response message.

receiverInfoList

ap:ReceiverInfoList

(Optional) List of payment receivers for unilateral scenarios. The list can contain details for a single simple payment or multiple receivers in support of parallel/chained payments.

requestEnvelope

common:RequestEnvelope

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

receiverInfo

ap:ReceiverInfo

(Required) List of receiver information details. For multiple receivers, this supports parallel/chained payments.

accountIdentifier

common:AccountIdentifier

(Required) Identifies the payment receiver.

countryCode

xs:string

(Required) The two-character country code of the end consumer's home country.

firstName

xs:string

(Optional) The first name of the consumer as known by the institution.

Maximum length: 64 characters

lastName

xs:string

(Optional) The last name of the consumer as known by the institution.

Maximum length: 64 characters

detailLevel

common:DetailLevelCode

(Optional) Level of detail required by the client application for components. Currently only one value is available:

• 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.

disclaimer

xs:string

(Optional) Holds the disclaimer.

(Optional) The payer of PayPal fees. Value is:

• SENDER — Sender pays all fees. (This is for personal, implicit simple/parallel payments; do not use for chained or unilateral payments.)
• PRIMARYRECEIVER — Primary receiver pays all fees (chained payments only.)
• EACHRECEIVER — Each receiver pays their own fee (default, personal, and unilateral payments.)
• SECONDARYONLY — Secondary receivers pay all fees (use only for chained payments with one secondary receiver.)

receiverDisclosureList

ap:ReceiverDisclosureList

(Optional) Holds the disclosure information related to receivers. The merchant can parse the details available in the response and display them to the receiver.

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

senderDisclosure

ap:SenderDisclosure

(Optional) Holds the disclosure related to the sender.

Merchants should display the details in SenderDisclosure.
The FeeDisclosure applies only if the feePayer is set to SENDER.

status

ap:Status

(Required) Indicates the response status:

• Status = RTR: This is a Remittance Transfer Rule transaction.
• Status = NON_RTR: This is not a Remittance Transfer Rule transaction.
• Status = MISSING_RECEIVER_COUNTRY_INFORMATION: The Receiver country information is not found in the PayPal database. The merchant must call the API again with same set of parameters along with the receiver country code. This is useful in case of a Unilateral scenario, where the receiver does not hold a PayPal account.

ack

common:AckCode

(Required) acknowledgment code. Value is:

• Success — The operation completed successfully.

• Failure — The operation failed.

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

• FailureWithWarning — The operation failed with a warning message.

build

xs:string

(Required) Build number. It is used only by PayPal Merchant Technical Support.

correlationId

xs:string

(Required) Correlation identifier. It is a 13-character, alphanumeric string (for example, db87c705a910e) that is used only by PayPal Merchant Technical Support.

Note: You must log and store this data for every response you receive. PayPal Technical Support uses the information to assist with reported issues.

timestamp

xs:datetime

(Required) Date on which the response was sent, for example:

2012-04-02T22:33:35.774-07:00

Note: You must log and store this data for every response you receive. PayPal Technical Support uses the information to assist with reported issues.

amountToTransfer

common:CurrencyType

(Required) The amount of the transaction.

conversionRate

ap:ConversionRate

(Required) The conversion rate from the sender currency to the transaction currency.

feeDisclosure

ap:FeeDisclosure

(Optional) The fee, if any, associated with the transaction.

totalAmountToTransfer

common:CurrencyType

(Required) The total transaction that includes the main transaction amount adjusted for any associated fee.

status

xs:string

(Required) Indicates the response status as one of the following:

• RTR: This is a Remittance Transfer Rule transaction.
• NON_RTR: This is not a Remittance Transfer Rule transaction.
• MISSING_RECEIVER_COUNTRY_INFORMATION: The Receiver country information is not found in the PayPal database. The merchant must call the API again with same set of parameters along with the receiver country code. This is useful in case of a Unilateral scenario, where the receiver does not hold a PayPal account.

receiverDisclosure

ap:ReceiverDisclosure

(Required) List of the disclosures for the receivers.

accountIdentifier

common:AccountIdentifier

(Required) Identifies the payment receiver.

amountReceivedFromSender

common:CurrencyType

(Required) The amount received from the sender.

conversionRate

ap:ConversionRate

Note: The conversion rate in the receiver disclosure is obsolete. All the elements in this tag return NULL value.

countryCode

xs:string

(Required) The two-character country code of the end consumer's home country.

feeDisclosure

ap:FeeDisclosure

(Optional) The fee, if any, associated with the transaction.

TotalAmountReceived

ap:CurrencyType

(Required) The total transaction that includes the main transaction amount adjusted for any associated fee.

amount

xs:decimal

(Required) The converted amount.

code

xs:string

(Required) The currency code for the converted amount. Value is:

• Australian Dollar — AUD

• Brazilian Real — BRL

  Note: This currency is supported as a payment currency and a currency balance for in-country PayPal accounts only. If the receiver of funds is not from Brazil, then PayPal converts funds into the primary holding currency of the account with the applicable currency conversion rate. The currency conversion rate includes PayPal's applicable spread or fee.

• Canadian Dollar — CAD

• Czech Koruna — CZK

• Danish Krone — DKK

• Euro — EUR

• Hong Kong Dollar — HKD

• Hungarian Forint — HUF

• Israeli New Sheqel — ILS

• Japanese Yen — JPY

• Malaysian Ringgit — MYR

  Note: The Ringgit is supported as a payment currency and currency balance only for Malaysian PayPal accounts.

• Mexican Peso — MXN

• Norwegian Krone — NOK

• New Zealand Dollar — NZD

• Philippine Peso — PHP

• Polish Zloty — PLN

• Pound Sterling — GBP

• Singapore Dollar — SGD

• Swedish Krona — SEK

• Swiss Franc — CHF

• Taiwan New Dollar — TWD

• Thai Baht — THB

• U.S. Dollar — USD

exchangeRate

xs:decimal

(Required) The exchange rate that converts a unit of the sender's currency to the transaction currency.

receiverCurrency

xs:string

(Required) The transaction currency that the receiver will receive.

senderCurrency

xs:string

(Required) The sender's primary currency to be converted.

fee

ap:CurrencyType

(Required) The fee associated with the payment.

taxes

ap:CurrencyType

(Required) Taxes associated with the payment.

error

common:ErrorData

(Optional) Detailed error information.

responseEnvelope

common:ResponseEnvelope

(Required) 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

xs:string

The domain to which this service belongs.

errorId

xs:long

A 6-digit number that uniquely identifies a particular error.

exceptionID

xs:token

(Optional) This field is not used.

message

xs:string

A description of the error.

parameter

common:ErrorParameter

(Optional) 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

xs:string

(Optional) This field is not used.

ack

common:AckCode

(Required) acknowledgment code. Value is:

• Success — The operation completed successfully.

• Failure — The operation failed.

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

• FailureWithWarning — The operation failed with a warning message.

build

xs:string

(Required) Build number. It is used only by PayPal Merchant Technical Support.

correlationId

xs:string

(Required) Correlation identifier. It is a 13-character, alphanumeric string (for example, db87c705a910e) that is used only by PayPal Merchant Technical Support.

Note: You must log and store this data for every response you receive. PayPal Technical Support uses the information to assist with reported issues.

timestamp

xs:datetime

(Required) Date on which the response was sent, for example:

2012-04-02T22:33:35.774-07:00

Note: You must log and store this data for every response you receive. PayPal Technical Support uses the information to assist with reported issues.

520003

Authentication failed. API credentials are incorrect.

550001

User is not allowed to perform this action.

569020

Feature not enabled.

580001

Invalid request: <value>

580023

The fee payer SENDER cannot be used with unilateral receiver

580027

The parameter is not supported.