Developer's Guide

Payflow Recurring Payments Developer’s Guide 49
Recurring Payments Reference
Updating Recurring Payments Profiles (ACTION=M)
8
MAXFAILPAYMENTS (Optional) The number of scheduled payments for which the transaction
is allowed to fail before PayPal deactivates (suspends) a profile. The
default is 0.
For example, if you specify 3, then PayPal allows a maximum of three
failed payment periods (possibly with multiple retries during each
payment period, and possibly nonconsecutive periods). If the transaction
is not approved for any three periods (months in the example), then
PayPal deactivates the profile.
I MPORTANT: If you do not specify a value, the default value of 0
(zero) specifies no limit. Retry attempts occur until the
TERM is met.
Character length and limitations: Numeric characters.
EMAIL (Optional) Buyer’s email address. This value is used when sending email
receipts to buyers.
Character length and limitations: 127 characters.
DESC (Optional) Description of the goods or services being purchased.
Character length and limitations: 80 alphanumeric characters.
COMPANYNAME (Optional) Company name associated with this profile.
Character length and limitations: 64 alphanumeric characters.
OPTIONALTRXAMT (Optional) Amount to be billed per regular payment period, not
including shipping and tax.
N OTE: All amounts in the profile creation request must be in the same
currency.
Limitations: Nine numeric characers plus decimal (.) character. No
currency symbol. Specify the exact amount to the cent using a decimal
point—use 34.00, not 34. Do not include comma separators—use
1199.95 not 1,199.95.
FIRSTNAME (Optional) Bill-to first name. See NAME.
Character length and limitations: 30 alphanumeric characters.
MIDDLENAME (Optional) Bill-to middle name.
Character length and limitations: 30 alphanumeric characters.
LASTNAME (Optional) Bill-to last name.
Character length and limitations: 30 alphanumeric characters.
NAME (Optional) The subscriber’s name. When NAME is passed, do not pass
FIRSTNAME. If both NAME and FIRSTNAME are passed, either one of the
values is considered as the subscriber’s name. If FIRSTNAME only is
passed, it alone is considered the subscriber’s name.
Character length and limitations: 30 alphanumeric characters.
T
ABLE 8.3 Update Recurring Payments Profile Request Parameters
Parameter Description