Create Profile

This page is available only if you have signed up for Recurring Billing Services.

Create Profile page enables you to create a new recurring billing profile for a customer. A profile is your definition of a recurring transaction for a single customer. The profile includes all information required to automatically bill the right person the right amount of money at the right time for the right term.

There are two ways to add a profile:

Create a New Profile

To access the Create Profile page, navigate to Service Settings -> Recurring Billing -> Create Profile.

  1. For Transaction Mode, specify whether to display Live or Test transactions. Profiles created in Test status are handled by PayPal’s test system and do not accept or process live credit card or ACH account numbers. Live profiles handle real funds.

  2. Specify a Profile Name (up to 128 characters) for the person or organization that is useful to you. For example, Monthly Newsletter - Jane Doe. You can use the name specified here to search for a profile.

  3. Enter the Billing Information, including phone, fax and email address, for the new profile.

  4. If the Shipping Information is the same as the billing information, click the Same as Billing Information check box. Otherwise, fill in the shipping information.

  5. Enter the Phone number for contacting purposes.

  6. Enter Email address to search for profiles. This field is required if you wish to send the customer messages each time a payment succeeds or fails. Refer to Customer Email for more information.

  7. Enter the following payment information:



Currency Code

If this option is available to you, select a currency type from the drop-down menu.

Recurring Amount

Fixed amount to be charged to the customer’s credit card each payment period.

Start Date/Next Payment Date

The date that the first payment should be processed. Subsequent payments are processed in the next payment period that you specify. Use today’s date or a date in the future.


Use this field for comments on this profile. You can search for profiles by comment and view comments for all profiles.

Maximum Failed Payments


The number of payment periods for which the transaction is allowed to fail before PayPal deactivates a profile.

For example, if you bill monthly and specify 3, PayPal attempts to process the card for three months (possibly with multiple retries during each monthly payment period). If the transaction is not approved during that time, PayPal deactivates the profile.

The default value of 0 (zero) specifies that retry attempts should occur until the profile expires (that is, when the term is complete).

Term (number of payments)

The number of payments to be made over the duration of the agreement. For example, a one-year, monthly payment contract has a term of 12. A value of 0 (zero) specifies an indefinite number of payments.

Maximum Retry Number of Days

The number of consecutive days that PayPal should attempt to process a failed transaction until approved status is received.

For example, if you specify 4, PayPal attempts to process the transaction once each day for four consecutive days. If the transaction is not approved during this time, the payment scheduled for that payment period is marked as failed. This increments the number of failed payments used to by maximum fail payments.

Valid values: 1 - 4. Default: 2.

Payment Period

Specifies how often the payment occurs. For example, specify monthly to cause one payment to occur every month.

  • Weekly: Every week on the same day of the week as the first payment.

  • Every Two Weeks: Every other week on the same day as the first payment.

  • Monthly: Every month on the same date as the first payment. Results in 12 payments per year.

  • If you select Monthly payments, and have selected your start date as the 31st of each month, then your profile will be billed every month on the 31st. However, for months with fewer dates, like February, or April, your billing date will be the last date of the month.

Credit Card Number

Customer's credit card number that is used for payments. If you are creating a profile using information from a transaction, then the credit card information from that transaction is used, and you do not have the option to enter a credit card number here.

Expiration Date

Expiration date of the credit card to be used for payments. If you are creating a profile using information from a transaction, then the credit card information from that transaction is used, and you do not have the option to enter an expiration date here.


  1. Using the Optional Transaction section, you can optionally submit an Authorization (for Account Verification) or a Sale transaction (for a setup fee, for example) when submitting a new profile. Optional Transaction is a one-time transaction and is not considered a recurring payment.

  1. Click Submit.

Optional Transaction Guidelines