Download PayPal Pro - 2012 Integration Guide

Integrating Recurring Payments
Recurring Payments Profile Status
6
Billing the Outstanding Amount
If a payment fails for any reason, PayPal adds the billing amount (including shipping and tax,
if applicable) to the profile’s outstanding balance. Use the AUTOBILLOUTAMT field in the
CreateRecurringPaymentsProfile request to specify whether PayPal should add the
outstanding amount to the payment amount for the next billing cycle.
Whether or not you choose to include the outstanding amount with the payment for the next
billing cycle, you can also use the BillOutstandingAmount API to programmatically
collect that amount at any time.
Identifying Items as Digital or Physical Goods
Set all the payment details item fields in the following table in the
CreateRecurringPaymentsProfile request. If all items are digital goods, be sure to set
the item category field to Digital to get the discount rate for digital goods.
Required fields for specifying item details
NVP
SOAP
Description
L_PAYMENTREQUEST_0_
ITEMCATEGORYn
ItemCategory
For digital goods, this field must be set to
Digital.
 Digital
 Physical
L_PAYMENTREQUEST_0_
NAMEn
Name
Item name.
L_PAYMENTREQUEST_0_
AMTn
Amount
Cost of item.
L_PAYMENTREQUEST_0_
QTYn
Quantity
Item quantity.
Recurring Payments Profile Status
The recurring payments actions you may take depend on the status of the profile.
A recurring payments profile can have one of the following status values:

ActiveProfile

PendingProfile

ExpiredProfile

SuspendedProfile

CancelledProfile
If PayPal successfully creates the profile, the profile has an ActiveProfile status. However,
if a non-recurring initial payment fails and you set FAILEDINITAMTACTION to
PayPal Payments Pro Integration Guide
April 2012
69