Integration Guide

PayPal Payments Pro Integration Guide April 2012 69
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
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
NVP SOAP Description
L_PAYMENTREQUEST_0_
ITEMCATEGORY
n
ItemCategory For digital goods, this field must be set to
Digital.
 Digital
 Physical
L_PAYMENTREQUEST_0_
NAME
n
Name Item name.
L_PAYMENTREQUEST_0_
AMT
n
Amount Cost of item.
L_PAYMENTREQUEST_0_
QTY
n
Quantity Item quantity.