GetRecurringPaymentsProfileDetails API Operation (NVP)

METHOD

(Required) Must be GetRecurringPaymentsProfileDetails.

PROFILEID

(Required) Recurring payments profile ID returned in the CreateRecurringPaymentsProfile response. 19-character profile IDs are supported for compatibility with previous versions of the PayPal API.

Character length and limitations: 14 single-byte alphanumeric characters

PROFILEID

Recurring payments profile ID returned in the CreateRecurringPaymentsProfile response.

STATUS

Status of the recurring payment profile. Value is:

• Active

• Pending

• Cancelled

• Suspended

• Expired

DESC

Description of the recurring payment.

Character length and limitations: 127 single-byte alphanumeric characters

AUTOBILLOUTAMT

Indicates whether you would like PayPal to automatically bill the outstanding balance amount in the next billing cycle. The outstanding balance is the total amount of any previously failed scheduled payments that have yet to be successfully paid. Value is:

• NoAutoBill — PayPal does not automatically bill the outstanding balance amount.

• AddToNextBilling — PayPal automatically bills the outstanding balance amount.

MAXFAILEDPAYMENTS

Number of scheduled payments that can fail before the profile is automatically suspended.

Character length and limitations: Number string representing an integer

AGGREGATEAMOUNT

Total amount collected thus far for scheduled payments.

Character length and limitations: Value is typically a positive number that cannot exceed nine (9) digits in SOAP request/response for USD, CLP, or JPY or the per transaction limit for the currency. It includes no currency symbol. Most currencies require two decimal places. The decimal separator must be a period (.), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page.

AGGREGATEOPTIONALAMOUNT

Total amount collected thus far for optional payments.

Character length and limitations: Value is typically a positive number that cannot exceed nine (9) digits in SOAP request/response for USD, CLP, or JPY or the per transaction limit for the currency. It includes no currency symbol. Most currencies require two decimal places. The decimal separator must be a period (.), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page.

FINALPAYMENTDUEDATE

Final scheduled payment due date before the profile expires.

SUBSCRIBERNAME

Full name of the person receiving the product or service paid for by the recurring payment. If not present, the name in the buyer’s PayPal account is used.

Character length and limitations: 32 double-byte characters.

PROFILESTARTDATE

The date when billing for this profile begins.

Must be a valid date, in UTC/GMT format; for example, 2012-08-24T05:38:48Z.

PROFILEREFERENCE

The merchant’s own unique reference or invoice number.

Character length and limitations: 127 single-byte alphanumeric characters.

ADDRESSSTATUS

Status of street address on file with PayPal. Value is:

• none

• Confirmed

• Unconfirmed

SHIPTONAME

Person’s name associated with this address.

Character length and limitations: 32 double-byte characters

SHIPTOSTREET

First street address.

Character length and limitations: 100 single-byte characters

SHIPTOSTREET2

Second street address.

Character length and limitations: 100 single-byte characters

SHIPTOCITY

Name of city.

Character length and limitations: 40 single-byte characters

SHIPTOSTATE

State or province.
Required for transactions only if the address is in one of the following countries: Argentina, Brazil, Canada, China, Indonesia, India, Japan, Mexico, Thailand or USA. See the list of PayPal state codes.

Character length and limitations: 40 single-byte characters

SHIPTOZIP

U.S. ZIP code or other country-specific postal code.

Character length and limitations: 20 single-byte characters

SHIPTOCOUNTRYCODE

Country code.

Character length and limitations: 2 single-byte characters

BILLINGPERIOD

Unit for billing during this subscription period. Value is:

• Day

• Week

• SemiMonth

• Month

• Year

For SemiMonth, billing is done on the 1st and 15th of each month.

REGULARBILLINGPERIOD

Unit for billing during this regular subscription period. Value is:

• Day

• Week

• SemiMonth

• Month

• Year

For SemiMonth, billing is done on the 1st and 15th of each month.

This field is available since version 53.0.

BILLINGFREQUENCY

Number of billing periods that make up one billing cycle. The combination of billing frequency and billing period must be less than or equal to one year. For example, if the billing cycle is Month, the maximum value for billing frequency is 12. Similarly, if the billing cycle is Week, the maximum value for billing frequency is 52.

REGULARBILLINGFREQUENCY

Number of billing periods that make up one regular billing cycle.

The combination of billing frequency and billing period must be less than or equal to one year. For example, if the billing cycle is Month, the maximum value for billing frequency is 12. Similarly, if the billing cycle is Week, the maximum value for billing frequency is 52.

This field is available since version 53.0.

TOTALBILLINGCYCLES

Number of billing cycles for payment period (either the regular payment period or the trial period).

• For the trial period, the value must be greater than 0.

• For the regular payment period, if no value is specified or the value is 0, the regular payment period continues until the profile is canceled or deactivated.

• For the regular payment period, if the value is greater than 0, the regular payment period will expire after the trial period is finished and continue at the billing frequency for TotalBillingCycles cycles.

REGULARTOTALBILLINGCYCLES

Number of billing cycles for the regular payment period.

• For the regular payment period, if no value is specified or the value is 0, the regular payment period continues until the profile is canceled or deactivated.

• For the regular payment period, if the value is greater than 0, the regular payment period will expire after the trial period is finished and continue at the billing frequency for RegularTotalBillingCycles cycles.

This field is available since version 53.0.

AMT

Billing amount for each billing cycle during this payment period. This amount does not include shipping and tax amounts.

Character length and limitations: Value is typically a positive number that cannot exceed nine (9) digits in SOAP request/response for USD, CLP, or JPY or the per transaction limit for the currency. It includes no currency symbol. Most currencies require two decimal places. The decimal separator must be a period (.), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page.

REGULARAMT

Billing amount for each billing cycle during this regular payment period. This amount does not include shipping and tax amounts.

Character length and limitations: Value is typically a positive number that cannot exceed nine (9) digits in SOAP request/response for USD, CLP, or JPY or the per transaction limit for the currency. It includes no currency symbol. Most currencies require two decimal places. The decimal separator must be a period (.), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page.

This field is available since version 53.0.

SHIPPINGAMT

Shipping amount for each billing cycle during this payment period.

Character length and limitations: Value is typically a positive number that cannot exceed nine (9) digits in SOAP request/response for USD, CLP, or JPY or the per transaction limit for the currency. It includes no currency symbol. Most currencies require two decimal places. The decimal separator must be a period (.), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page.

REGULARSHIPPINGAMT

Shipping amount for each billing cycle during this regular payment period.

Character length and limitations: Value is typically a positive number that cannot exceed nine (9) digits in SOAP request/response for USD, CLP, or JPY or the per transaction limit for the currency. It includes no currency symbol. Most currencies require two decimal places. The decimal separator must be a period (.), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page.

This field is available since version 53.0.

TAXAMT

Tax amount for each billing cycle during this payment period.

Character length and limitations: Value is typically a positive number that cannot exceed nine (9) digits in SOAP request/response for USD, CLP, or JPY or the per transaction limit for the currency. It includes no currency symbol. Most currencies require two decimal places. The decimal separator must be a period (.), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page.

REGULARTAXAMT

Tax amount for each billing cycle during this regular payment period.

Character length and limitations: Value is typically a positive number that cannot exceed nine (9) digits in SOAP request/response for USD, CLP, or JPY or the per transaction limit for the currency. It includes no currency symbol. Most currencies require two decimal places. The decimal separator must be a period (.), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page.

This field is available since version 53.0.

CURRENCYCODE

(Required) Currency code (default is USD).

Character length and limitations: 3 single-byte characters

REGULARCURRENCYCODE

(Required) Currency code (default is USD).

This field is available since version 53.0.

NEXTBILLINGDATE

The next scheduled billing date, in YYYY-MM-DD format.

NUMCYLESCOMPLETED

The number of billing cycles completed in the current active subscription period. A billing cycle is considered completed when payment is collected or after retry attempts to collect payment for the current billing cycle have failed.

NUMCYCLESREMAINING

The number of billing cycles remaining in the current active subscription period.

OUTSTANDINGBALANCE

The current past due or outstanding balance for this profile.

Character length and limitations: Value is typically a positive number that cannot exceed nine (9) digits in SOAP request/response for USD, CLP, or JPY or the per transaction limit for the currency. It includes no currency symbol. Most currencies require two decimal places. The decimal separator must be a period (.), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page.

FAILEDPAYMENTCOUNT

The total number of failed billing cycles for this profile.

LASTPAYMENTDATE

The date of the last successful payment received for this profile, in YYYY-MM-DD format.

LASTPAYMENTAMT

The amount of the last successful payment received for this profile.

Character length and limitations: Value is typically a positive number that cannot exceed nine (9) digits in SOAP request/response for USD, CLP, or JPY or the per transaction limit for the currency. It includes no currency symbol. Most currencies require two decimal places. The decimal separator must be a period (.), and the optional thousands separator must be a comma (,). Some currencies do not allow decimals. For details, see the currency codes page.

CREDITCARDTYPE

Type of credit card. Is one of the following values:

• Visa
• Mastercard
• Discover
• Amex
• JCB
• Maestro — See note.

Character length and limitations: Up to 10 single-byte alphabetic characters

ACCT

Credit card number. Only the last 4 digits of the credit card number are returned.

Character length and limitations: Numeric characters only with no spaces or punctuation. The string must conform with modulo and length required by each credit card type.

EXPDATE

Credit card expiration date. This field is required if you are using recurring payments with direct payments.

Character length and limitations: 6 single-byte alphanumeric characters, including leading zero, in the format MMYYYY

STARTDATE

Month and year that Maestro card was issued.

Character length and limitations: Must be 6 digits, including leading zero, in the format MMYYYY

ISSUENUMBER

Issue number of Maestro card.

Character length and limitations: 2 numeric digits

EMAIL

Email address of buyer.

Character length and limitations: 127 single-byte characters

FIRSTNAME

Buyer’s first name.

Character length and limitations: 64 double-byte characters

LASTNAME

Buyer’s last name.

Character length and limitations: 64 double-byte characters

ADDRESSOWNER

eBay company that maintains this address. Value is:

• eBay

• PayPal

ADDRESSSTATUS

Status of street address on file with PayPal. Value is:

• none

• Confirmed

• Unconfirmed

SHIPTOSECONDARYNAME

Person’s name associated with this secondary address.

Character length and limitations: 32 double-byte characters

SHIPTONAME

Person’s name associated with this address.

Character length and limitations: 32 double-byte characters

SHIPTOSTREET

First street address.

Character length and limitations: 100 single-byte characters

SHIPTOSECONDARYADDRESSLINE1

First line of street address for secondary address.

Character length and limitations: 100 single-byte characters

SHIPTOSTREET2

Second street address.

Character length and limitations: 100 single-byte characters

SHIPTOSECONDARYADDRESSLINE2

Second line of street address for secondary address.

Character length and limitations: 100 single-byte characters

SHIPTOCITY

Name of city.

Character length and limitations: 40 single-byte characters

SHIPTOSECONDARYCITY

Name of city for secondary address.

Character length and limitations: 40 single-byte characters

SHIPTOSTATE

State or province.
Required for transactions only if the address is in one of the following countries: Argentina, Brazil, Canada, China, Indonesia, India, Japan, Mexico, Thailand or USA. See the list of PayPal state codes.

Character length and limitations: 40 single-byte characters

SHIPTOSECONDARYSTATE

State or province for secondary address. Required for U.S. addresses only.

Character length and limitations: 40 single-byte characters

SHIPTOZIP

U.S. ZIP code or other country-specific postal code.

Character length and limitations: 20 single-byte characters

SHIPTOSECONDARYZIP

U.S. ZIP code or other country-specific postal code for secondary address.

Character length and limitations: 20 single-byte characters

SHIPTOCOUNTRYCODE

Country code.

Character length and limitations: 2 single-byte characters

SHIPTOSECONDARYCOUNTRYCODE

Character length and limitations: 2 single-byte characters

SHIPTOPHONENUM

Phone number.

Character length and limitations: 20 single-byte characters

SHIPTOSECONDARYPHONENUM

Character length and limitations: 20 single-byte characters