User's Guide
Table Of Contents
- Contents
- Preface
- Managing Payflow Services
- Using the SDK to Perform Recurring Tasks
- About Recurring Billing Profile Actions
- Using the Add Action
- Required Parameters for the Add Action
- Using the Modify and Reactivate Actions
- Required Parameters for the Modify and Reactivate Actions
- Using the Cancel Action
- Required Parameters for the Cancel Action
- Using the Inquiry Action to View Information for a Profile
- Using the Inquiry Action to View the Status of the Profile
- Using the Inquiry Action to View the Status of Payments
- Required Parameters for the Status of Payments Inquiry Action
- Using the Payment Action
- Required Parameters for the Payment Action
- Testing Recurring Billing
- Obtaining Consent to Bill Customers Using Recurring Billing
Payflow Pro Recurring Billing Service User’s Guide July 2011 21
Using the SDK to Perform Recurring Tasks
Using the Modify and Reactivate Actions
2
Using the Modify and Reactivate Actions
You can Modify (ACTION=M) any profile value by sending any subset of the profile
parameters. If the profile is currently inactive (because you deactivated it), then the Modify
action reactivates it.
NOTE: The Modify action cannot reactivate a profile that PayPal canceled.
The Modify action is useful, for example, when an inactive customer wishes to restart
payments using a new valid credit card. The Modify action changes a profile’s STATUS to
active but does not change the START date. To change the START date, use the Reactivate
command. Profile STATUS is described in Table 2.13.
You can Reactivate (ACTION=R) a profile with inactive STATUS. (Profiles can be
deactivated for the following reasons: the term has completed, the profile reached maximum
allowable payment failures, or you canceled the profile.) You have the option to alter any
profile parameter, including an Optional Transaction, and you must specify a new start date.
NOTE: Values of processor-specific parameters are forwarded and stored, but do not appear in
reports.
Example Modify Action
The following example Payflow parameter string uses the Modify (ACTION=M) action to
change the amount of payment to $42.00 (AMT=42.00) for profile ID number RP0000001234.
"TRXTYPE=R&TENDER=C&PARTNER=PayPal&VENDOR=Acme&USER=Acme&PWD=a1b2c3d4&ACTIO
N=M&AMT=42.00&ORIGPROFILEID=RP0000001234"
Parameters are described in “Required Parameters for the Modify and Reactivate Actions” on
page 21.
Example Reactivate Action
IMPORTANT: Payments missed while a profile is inactive are not re-tried if you reactivate
the profile after the missed payment periods have passed. To submit the
missed payment transactions, you must reactivate the profile and increase the
value of either TERM or MAXFAILPAYMENTS. Alternatively, perform a
manual payment using PayPal Manager – the profile is activated as a side
effect of the manual payment.
The following example Payflow parameter string performs a Reactivate action. Parameters are
described in “Required Parameters for the Modify and Reactivate Actions” on page 21.
"TRXTYPE=R&TENDER=C&PARTNER=PayPal&VENDOR=Acme&USER=Acme&PWD=a1b2c3d4&ACTIO
N=R&ACCT=4012888888881881&START="