Developer's Guide
Table Of Contents
- Adaptive Payments Developer Guide
- Contents
- What’s New?
- Introducing Adaptive Payments
- Adaptive Payments Actors and Objects
- Simple, Parallel, and Chained Payments
- Payment Approval
- Adaptive Payments Service Permissions
- Explicit Approval Payment Flow
- Preapproved Payments Flow
- Implicit Approval Payments Flow
- Embedded Payments
- Embedded Payment Flow Presentations
- Kinds of Embedded Payments
- Embedded Payments Implementation Basics
- Embedded Payment Experience
- Preapprove Future Payments Checkbox
- Shipping Address Information
- Embedded Payment Experience
- Setting Up Web Pages to Invoke the Embedded Payment Flow Using a Lightbox
- Setting Up Web Pages to Invoke the Embedded Payment Flow Using a Minibrowser
- Displaying and Collecting Shipping Addresses
- Guest Payments
- Fee Payment Configuration
- Getting Started
- Pay API Operation
- PaymentDetails API Operation
- ExecutePayment API Operation
- GetPaymentOptions API Operation
- SetPaymentOptions API Operation
- Preapproval API Operation
- PreapprovalDetails API Operation
- CancelPreapproval API Operation
- ConvertCurrency API Operation
- Refund API Operation
- GetFundingPlans API Operation
- GetShippingAddresses API Operation
- Adaptive Payment Commands and Redirects
- Instant Payment Notifications
- Older Versions of the Adaptive Payments API
- 1.8.0 Features
- 1.7.0 Features
- 1.6.0 Features
- New API Operations for Version 1.6.0
- Changes to PayRequest Fields for Version 1.6.0
- Changes to PayResponse Fields for Version 1.6.0
- Changes to ExecutePaymentRequest Fields for Version 1.6.0
- Changes to GetPaymentOptionsResponse Fields for Version 1.6.0
- Changes to SetPaymentOptionsRequest Fields for Version 1.6.0
- Changes to PreapprovalRequest Fields for Version 1.6.0
- Changes to Address Structure for Version 1.6.0
- Changes to DisplayOptions Structure for Version 1.6.0
- New CurrencyConversion Structure for Version 1.6.0
- New InvoiceData Structure for Version 1.6.0
- New InvoiceItem Structure for Version 1.6.0
- New SenderOptions Structure for Version 1.6.0
- New SenderIdentifier Structure for Version 1.6.0
- New AccountIdentifier Structure for Version 1.6.0
- New ReceiverOptions Structure for Version 1.6.0
- New ReceiverIdentifier Structure for Version 1.6.0
- Additional Error Messages for Version 1.6.0
- 1.5.0 Features
- 1.4.0 Features
- 1.3.0 Features
- 1.2.0 Features
- 1.1.0 Features
- Revision History
- Index
Adaptive Payments Developer Guide August 7, 2012 167
Preapproval API Operation
PreapprovalRequest Message
dayOfWeek common:DayOfWeek
(Optional) The day of the week that a weekly payment is to be made.
Allowable values are:
NO_DAY_SPECIFIED
SUNDAY
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
endingDate xs:dateTime
(Optional) Last date for which the preapproval is valid. It cannot be later than
one year from the starting date.
NOTE: You must specify a value unless you have specific permission from
PayPal to omit this value.
ipnNotificationUrl xs:string
(Optional) The URL to which you want all IPN messages for this preapproval
to be sent. This URL supersedes the IPN notification URL in your profile.
Maximum length: 1024 characters
maxAmountPerPayment xs:decimal
(Optional) The preapproved maximum amount per payment. It cannot exceed
the preapproved maximum total amount of all payments.
maxNumberOfPayments xs:int
(Optional) The preapproved maximum number of payments. It cannot exceed
the preapproved maximum total number of all payments.
maxNumberOfPaymentsPerPe
riod
xs:int
(Optional) The preapproved maximum number of all payments per period.
You must specify a value unless you have specific permission from PayPal.
maxTotalAmountOfAllPayme
nts
xs:decimal
(Optional) The preapproved maximum total amount of all payments. It cannot
exceed $2,000 USD or its equivalent in other currencies.
NOTE: You must specify a value unless you have specific permission from
PayPal to omit this value.
memo xs:string
(Optional) A note about the preapproval.
Maximum length: 1000 characters, including newline characters
Field Description