# CreateRecurringPaymentsProfile API Operation (SOAP) (/api/nvp-soap/create-recurring-payments-profile-soap)



> **Note:** **Important:** NVP/SOAP is a legacy integration method. We accept new integrations and support existing integrations, but there are newer solutions. If you're starting an integration, [we recommend our latest solutions](/).

Creates a recurring payments profile. You must invoke the CreateRecurringPaymentsProfile API operation for each profile you want to create. The API operation creates a profile and an associated billing agreement.

> **Note:** **Note:** There is a one-to-one correspondence between billing agreements and recurring payments profiles. To associate a recurring payments profile with its billing agreement, you must ensure that the description in the recurring payments profile matches the description of a billing agreement. For version 54.0 and later, use `SetExpressCheckout` to initiate creation of a billing agreement.

## CreateRecurringPaymentsProfile Request Message [#createrecurringpaymentsprofile-request-message]

### CreateRecurringPaymentsProfile Request Fields [#createrecurringpaymentsprofile-request-fields]

| Field                                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Token`<br />                            | `xs:string`<br /> A timestamped token, the value of which was returned in the response to the first call to `SetExpressCheckout`. You can also use the token returned in the `SetCustomerBillingAgreement` response. Either this token or a credit card number is required. If you include both token and credit card number, the token is used and credit card number is ignored Call `CreateRecurringPaymentsProfile` once for each billing agreement included in `SetExpressCheckout` request and use the same token for each call. Each `CreateRecurringPaymentsProfile` request creates a single recurring payments profile.<br /> > **Note:** &#x2A;*Note:** Tokens expire after approximately 3 hours. |
| `CreditCard`<br />                       | `ns:CreditCardDetailsType`<br /> Credit card information for recurring payments using direct payments. Either a token or a credit card number is required. If you include both token and credit card number, the token is used and credit card number is ignored.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `RecurringPayments ProfileDetails`<br /> | `ns:RecurringPaymentsProfileDetails`<br /&#x3E; &#x2A;(Required)* You can include up to 10 recurring payments profiles per request. The order of the profile details must match the order of the billing agreement details specified in the `SetExpressCheckout` request.<br />                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `ScheduleDetails`<br />                  | `ns:ScheduleDetailsType`<br /&#x3E; &#x2A;(Required)* Describes the recurring payments schedule, including the regular payment period, whether there is a trial period, and the number of payments that can fail before a profile is suspended.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

### RecurringPaymentsProfileDetailsType Fields [#recurringpaymentsprofiledetailstype-fields]

| Field                              | Description                                                                                                                                                                                                                                                                                                                    |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `SubscriberName`<br />             | `xs:string`<br /&#x3E; &#x2A;(Optional)* 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.<br /> Character length and limitations: 32 double-byte characters<br />                                                   |
| `SubscriberShipping Address`<br /> | `ns:AddressType`<br /&#x3E; &#x2A;(Optional)* The subscriber's shipping address associated with this profile, if applicable. If not specified, the ship-to address from buyer's PayPal account is used.<br /> > **Note:** &#x2A;*Note:** Shipping Address is optional, but if you include it, certain fields are required.     |
| `BillingStartDate`<br />           | `xs:dateTime`<br /&#x3E; &#x2A;(Required)* The date when billing for this profile begins.<br /> > **Note:** &#x2A;*Note:** The profile may take up to 24 hours for activation. Character length and limitations: Must be a valid date, in UTC/GMT format; for example, `2013-08-24T05:38:48Z`. No wildcards are allowed.<br /> |
| `ProfileReference`<br />           | `xs:string`<br /&#x3E; &#x2A;(Optional)* The merchant's own unique reference or invoice number.<br /> Character length and limitations: 127 single-byte alphanumeric characters<br />                                                                                                                                          |

### ScheduleDetailsType Fields [#scheduledetailstype-fields]

| Field                             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Description`<br />               | `xs:string`<br /&#x3E; &#x2A;(Required)* Description of the recurring payment.<br /> > **Note:** &#x2A;*Note:** You must ensure that this field matches the corresponding billing agreement description included in the `SetExpressCheckout` request. Character length and limitations: 127 single-byte alphanumeric characters<br />                                                                                                                                                |
| `ActivationDetails`<br />         | `ns:ActivationDetailsType`<br /&#x3E; &#x2A;(Optional)* Information about activating a profile, such as whether there is an initial non-recurring payment amount immediately due upon profile creation and how to override a pending profile PayPal suspends when the initial payment amount fails.<br />                                                                                                                                                                            |
| `TrialPeriod`<br />               | `ns:BillingPeriodDetailsType`<br /&#x3E; &#x2A;(Optional)* Trial period for this schedule.<br />                                                                                                                                                                                                                                                                                                                                                                                     |
| `PaymentPeriod`<br />             | `ns:BillingPeriodDetailsType`<br /&#x3E; &#x2A;(Required)* Regular payment period for this schedule.<br />                                                                                                                                                                                                                                                                                                                                                                           |
| `MaxFailedPayments`<br />         | `xs:int`<br /&#x3E; &#x2A;(Optional)* Number of scheduled payments that can fail before the profile is automatically suspended. An IPN message is sent to the merchant when the specified number of failed payments is reached.<br /> Character length and limitations: Number string representing an integer<br />                                                                                                                                                                  |
| `AutoBillOutstandingAmount`<br /> | `ns:AutoBillType`<br /&#x3E; &#x2A;(Optional)* 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:<br /> `NoAutoBill` — PayPal does not automatically bill the outstanding balance.<br />`AddToNextBilling` — PayPal automatically bills the outstanding balance.<br /> |

### BillingPeriodDetailsType Fields [#billingperioddetailstype-fields]

| Field                                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PaymentPeriod.BillingPeriod`<br />      | `ns:BillingPeriodType`<br /&#x3E; &#x2A;(Required)* Unit for billing during this subscription period. Value is:<br /> `Day`<br />`Week`<br />`SemiMonth`<br />`Month`<br />`Year`<br /> For `SemiMonth`, billing is done on the 1st and 15th of each month.<br /> > **Note:** &#x2A;*Note:** The combination of `BillingPeriod` and `BillingFrequency` cannot exceed one year.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `PaymentPeriod.BillingFrequency`<br />   | `xs:int`<br /&#x3E; &#x2A;(Required)* Number of billing periods that make up one billing cycle.<br /> 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.<br /> > **Note:** &#x2A;*Note:** If the billing period is `SemiMonth`, the billing frequency must be 1.                                                                                                                                                                                                                                                                                                                                                                                  |
| `PaymentPeriod.TotalBillingCycles`<br /> | `xs:int`<br /&#x3E; &#x2A;(Optional)* Number of billing cycles for payment period.<br /> 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.<br />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.<br />                                                                                                                                                                                                                                                                                                                                                                                                   |
| `PaymentPeriod.Amount`<br />             | `cc:BasicAmountType`<br /&#x3E; &#x2A;(Required)* Billing amount for each billing cycle during this payment period. This amount does not include shipping and tax amounts.<br /> > **Note:** &#x2A;*Note:** All amounts in the `CreateRecurringPaymentsProfile` request must have the same currency. 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](/api/nvp-soap/currency-codes/). 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](/api/nvp-soap/currency-codes/).<br />                            |
| `TrialPeriod.BillingPeriod`<br />        | `ns:BillingPeriodType`<br /> Unit for billing during this subscription period; required if you specify an optional trial period. Value is:<br /> `Day`<br />`Week`<br />`SemiMonth`<br />`Month`<br />`Year`<br /> For `SemiMonth`, billing is done on the 1st and 15th of each month.<br /> > **Note:** &#x2A;*Note:** The combination of `BillingPeriod` and `BillingFrequency` cannot exceed one year.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `TrialPeriod.BillingFrequency`<br />     | `xs:int`<br /> Number of billing periods that make up one billing cycle; required if you specify an optional trial period.<br /> 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.<br /> > **Note:** &#x2A;*Note:** If the billing period is `SemiMonth`, the billing frequency must be 1.                                                                                                                                                                                                                                                                                                                                                       |
| `TrialPeriod.TotalBillingCycles`<br />   | `xs:int`<br /&#x3E; &#x2A;(Optional)* Number of billing cycles for trial payment period.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `TrialPeriod.Amount`<br />               | `cc:BasicAmountType`<br /> Billing amount for each billing cycle during this payment period; required if you specify an optional trial period. This amount does not include shipping and tax amounts.<br /> > **Note:** &#x2A;*Note:** All amounts in the `CreateRecurringPaymentsProfile` request must have the same currency. 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](/api/nvp-soap/currency-codes/). 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](/api/nvp-soap/currency-codes/).<br /> |
| `ShippingAmount`<br />                   | `cc:BasicAmountType`<br /&#x3E; &#x2A;(Optional)* Shipping amount for each billing cycle during this payment period.<br /> > **Note:** &#x2A;*Note:** All amounts in the request must have the same currency. 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](/api/nvp-soap/currency-codes/). 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](/api/nvp-soap/currency-codes/).<br />                                                                                                                   |
| `TaxAmount`<br />                        | `cc:BasicAmountType`<br /&#x3E; &#x2A;(Optional)* The tax amount for each billing cycle during this payment period.<br /> > **Note:** &#x2A;*Note:** All amounts in the request must have the same currency. 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](/api/nvp-soap/currency-codes/). 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](/api/nvp-soap/currency-codes/).<br />                                                                                                                    |

### ActivationDetailsType Fields [#activationdetailstype-fields]

| Field                             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `InitialAmount`<br />             | `cc:BasicAmountType`<br /&#x3E; &#x2A;(Optional)* Initial non-recurring payment amount due immediately upon profile creation. Use an initial amount for enrollment or setup fees.<br /> > **Note:** &#x2A;*Note:** All amounts included in the request must have the same currency. 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](/api/nvp-soap/currency-codes/). 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](/api/nvp-soap/currency-codes/).<br />                                                                                                                                                                                                                                                                                                                                                                          |
| `FailedInitialAmountAction`<br /> | `ns:FailedPaymentAction`<br /&#x3E; &#x2A;(Optional)* Action you can specify when a payment fails. Value is:<br /> `ContinueOnFailure` — By default, PayPal suspends the pending profile in the event that the initial payment amount fails. You can override this default behavior by setting this field to `ContinueOnFailure`. Then, if the initial payment amount fails, PayPal adds the failed payment amount to the outstanding balance for this recurring payment profile.<br /> When you specify `ContinueOnFailure`, a success code is returned to you in the `CreateRecurringPaymentsProfile` response and the recurring payments profile is activated for scheduled billing immediately. You should check your IPN messages or PayPal account for updates of the payment status.<br />`CancelOnFailure` — If this field is not set or you set it to `CancelOnFailure`, PayPal creates the recurring payment profile, but places it into a pending status until the initial payment completes. If the initial payment clears, PayPal notifies you by IPN that the pending profile has been activated. If the payment fails, PayPal notifies you by IPN that the pending profile has been canceled.<br /> |

### AddressType (Shipping) Fields [#addresstype-shipping-fields]

| Field                   | Description                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Name`<br />            | `xs:string`<br /> Person's name associated with this shipping address. It is required if using a shipping address.<br /> Character length and limitations: 32 double-byte characters<br />                                                                                                                                                                   |
| `Street1`<br />         | `xs:string`<br /> First street address. It is required if using a shipping address.<br /> Character length and limitations: 100 single-byte characters<br />                                                                                                                                                                                                 |
| `Street2`<br />         | `xs:string`<br /&#x3E; &#x2A;(Optional)* Second street address.<br /> Character length and limitations: 100 single-byte characters<br />                                                                                                                                                                                                                     |
| `CityName`<br />        | `xs:string`<br /> Name of city. It is required if using a shipping address.<br /> Character length and limitations: 40 single-byte characters<br />                                                                                                                                                                                                          |
| `StateOrProvince`<br /> | `xs:string`<br /> State or province.<br /> 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](/api/nvp-soap/state-codes/).<br /> Character length and limitations: 40 single-byte characters<br /> |
| `PostalCode`<br />      | `xs:string`<br /> U.S. ZIP code or other country-specific postal code. It is required if using a U.S. shipping address; may be required for other countries.<br /> Character length and limitations: 20 single-byte characters<br />                                                                                                                         |
| `Country`<br />         | `ebl:CountryCodeType`<br /> Country code. It is required if using a shipping address.<br /> Character length and limitations: 2 single-byte characters<br />                                                                                                                                                                                                 |
| `Phone`<br />           | `xs:string`<br /&#x3E; &#x2A;(Optional)* Phone number.<br /> Character length and limitations: 20 single-byte characters<br />                                                                                                                                                                                                                               |

### CreditCardDetailsType Fields [#creditcarddetailstype-fields]

| Field                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `CreditCardType`<br />   | `ebl:CreditCardType`<br /&#x3E; &#x2A;(Optional)* Type of credit card. For UK, only `Maestro`, `Mastercard`, `Discover`, and `Visa` are allowable. For Canada, only `Mastercard` and `Visa` are allowable and Interac debit cards are not supported. Value is:<br /> `Visa``Mastercard``Discover``Amex``JCB``Maestro`: See note. > **Note:** &#x2A;*Note:** If the credit card type is `Maestro`, you must set `currencyId` to `GBP`. In addition, you must specify either `StartMonth` and `StartYear` or `IssueNumber`. Character length and limitations: Up to 10 single-byte alphabetic characters<br /> |
| `CreditCardNumber`<br /> | `xs:string`<br /&#x3E; &#x2A;(Required)* Credit card number.<br /> 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.<br />                                                                                                                                                                                                                                                                                                                                                          |
| `ExpMonth`<br />         | `xs:int`<br /&#x3E; &#x2A;(Required)* Credit card expiration month.<br /> Character length and limitations: 2 single-byte numeric characters, including leading zero<br />                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `ExpYear`<br />          | `xs:int`<br /&#x3E; &#x2A;(Required)* Credit card expiration year.<br /> Character length and limitations: 4 single-byte numeric characters<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `CVV2`<br />             | `xs:string`<br /> Card Verification Value, version 2. Your Merchant Account settings determine whether this field is required. To comply with credit card processing regulations, you must not store this value after a transaction has been completed.<br /> Character length and limitations: For Visa, Mastercard, and Discover, the value is exactly 3 digits. For American Express, the value is exactly 4 digits.<br />                                                                                                                                                                                |
| `CardOwner`<br />        | `ns:PayerInfoType`<br /&#x3E; &#x2A;(Required)* Details about the owner of the credit card.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `StartMonth`<br />       | `xs:int`<br /&#x3E; &#x2A;(Optional)* Month that Maestro card was issued.<br /> Character length and limitations: 2-digit, zero-filled if necessary<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `StartYear`<br />        | `xs:int`<br /&#x3E; &#x2A;(Optional)* Year that Maestro card was issued.<br /> Character length and limitations: 4 digits<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `IssueNumber`<br />      | `xs:string`<br /&#x3E; &#x2A;(Optional)* Issue number of Maestro card.<br /> Character length and limitations: 2 numeric digits maximum<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

### PayerInfoType Fields [#payerinfotype-fields]

| Field                 | Description                                                                                                                                                                                                          |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Payer`<br />         | `ebl:EmailAddressType`<br /&#x3E; &#x2A;(Required)* Email address of buyer.<br /> Character length and limitations: 127 single-byte characters<br />                                                                 |
| `PayerID`<br />       | `ebl:UserIDType`<br /&#x3E; &#x2A;(Optional)* Unique PayPal Customer Account identification number.<br /> Character length and limitations:13 single-byte alphanumeric characters<br />                              |
| `PayerStatus`<br />   | `ebl:PayPalUser` `StatusCodeType`<br /&#x3E; &#x2A;(Optional)* Status of buyer. Value is:<br /> `verified`<br />`unverified`<br /> Character length and limitations: 10 single-byte alphabetic characters<br />      |
| `PayerName`<br />     | `ebl:PersonNameType`<br /&#x3E; &#x2A;(Optional)* First and last name of buyer.<br />                                                                                                                                |
| `PayerCountry`<br />  | `ebl:CountryCodeType`<br /&#x3E; &#x2A;(Optional)* Buyer's country of residence in the form of ISO standard 3166 two-character country codes.<br /> Character length and limitations: 2 single-byte characters<br /> |
| `PayerBusiness`<br /> | `xs:string`<br /&#x3E; &#x2A;(Optional)* Buyer's business name.<br /> Character length and limitations: 127 single-byte characters<br />                                                                             |
| `Address`<br />       | `xs:string`<br /&#x3E; &#x2A;(Optional)* Buyer's shipping address information.<br />                                                                                                                                 |

### PayerNameType Fields [#payernametype-fields]

| Field              | Description                                                                                                                                   |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `Salutation`<br /> | `xs:string`<br /&#x3E; &#x2A;(Optional)* Buyer's salutation.<br /> Character length and limitations: 20 single-byte characters<br />          |
| `FirstName`<br />  | `ebl:PersonNameType`<br /&#x3E; &#x2A;(Optional)* Buyer's first name.<br /> Character length and limitations: 64 double-byte characters<br /> |
| `MiddleName`<br /> | `ebl:NameUser`<br /&#x3E; &#x2A;(Optional)* Buyer's middle name.<br /> Character length and limitations: 64 double-byte characters<br />      |
| `LastName`<br />   | `ebl:NameType`<br /&#x3E; &#x2A;(Optional)* Buyer's last name.<br /> Character length and limitations: 64 double-byte characters<br />        |
| `Suffix`<br />     | `ebl:SuffixType`<br /&#x3E; &#x2A;(Optional)* Buyer's suffix.<br /> Character length and limitations: 12 single-byte characters<br />         |

### AddressType Fields [#addresstype-fields]

| Field                   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Street1`<br />         | `xs:string`<br /&#x3E; &#x2A;(Required)* First street address.<br /> Character length and limitations: 100 single-byte characters<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `Street2`<br />         | `xs:string`<br /&#x3E; &#x2A;(Optional)* Second street address.<br /> Character length and limitations: 100 single-byte characters<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `CityName`<br />        | `xs:string`<br /&#x3E; &#x2A;(Required)* Name of city.<br /> Character length and limitations: 40 single-byte characters<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `StateOrProvince`<br /> | `xs:string`<br /> State or province.<br /> 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](/api/nvp-soap/state-codes/).<br /> Character length and limitations: 40 single-byte characters<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `Country`<br />         | `ebl:CountryCodeType`<br /&#x3E; &#x2A;(Required)* Country code.<br /> Character length and limitations: 2 single-byte characters<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `PostalCode`<br />      | `xs:string`<br /&#x3E; &#x2A;(Required)* U.S. ZIP code or other country-specific postal code.<br /> Character length and limitations: 20 single-byte characters<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `Phone`<br />           | `xs:string`<br /&#x3E; &#x2A;(Optional)* Phone number.<br /> Character length and limitations: 20 single-byte characters<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `SoftDescriptor`        | `xs:string`<br /&#x3E; &#x2A;(Optional)* Information that is usually displayed in the account holder's statement, for example, `<Your-Not-For-Profit> <State>`, `<Your-Not-For-Profit> <Branch-Name>`, `<Your-Website> dues` or `<Your-Website> list fee`.<br /> <br />Character length and limitations: 23 alphanumeric characters, can include the special characters dash (`-`) and dot (`.`) only. Asterisks (`*`) are NOT permitted. If it includes a space character (` `), enclose the `"<Soft-Descriptor>"` value in double quotes. > **Note:** &#x2A;*Note:** For US Website Payments Pro AMEX cards only and only for merchants passing dynamic soft descriptors, the dynamic soft descriptors for AMEX cards are only guaranteed once the transaction settles. This means that during the authorization time the card issuing bank might show their customer the registered business or legal name for the merchant versus the dynamic soft descriptor passed on a per API transaction.<br /> |
| `SoftDescriptorCity`    | *(Optional)* A unique phone number, email address or URL, which is displayed on the account holder's statement. PayPal recommends passing a toll-free phone number because, typically, this is the easiest way for a buyer to contact the seller in the case of an inquiry.<br /><br />Character length and limitations: 13 characters including special characters, such as, space, `!`, `"`, `#`, `$`, `%`, `&`, `'`, `(`, `)`, `+`, `-`,`*`, `/`, `:`, `;`, `<`, `=`, `>`, `?`, `@`, comma and period.<br /><br />If it includes the space character (` `), enclose the `"<Soft-Descriptor-City>"` value in double quotes.<br /><br /> > **Note:** &#x2A;*Note:** Underscore (`_`) is an illegal character for this field. If it is passed, then it will be removed leaving the remaining characters in the same order. For example, `New_York` changes to `NewYork`.<br />                                                                                                                           |

### PaymentDetailsItemType Fields [#paymentdetailsitemtype-fields]

| Field                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ItemCategory`<br /> | `ns:ItemCategoryType`<br /> Indicates whether the item is digital or physical. For digital goods, this field is required and must be set to `Digital` to get the best rates. Is one of the following values:<br /> `Digital`<br />`Physical`<br /> This field is introduced in version 69.0.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `Name`<br />         | `xs:string`<br /> Item name. This field is required when `ItemCategory` is passed.<br /> Character length and limitations: 127 single-byte characters<br /> This field is introduced in version 69.0.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `Description`<br />  | `xs:string`<br /&#x3E; &#x2A;(Optional)* Item description.<br /> Character length and limitations: 127 single-byte characters<br /> This field is introduced in version 69.0.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `Amount`<br />       | `ebl:BasicAmountType`<br /> Cost of item. This field is required when `ItemCategory` is passed.<br /> > **Note:** &#x2A;*Note:** You must set the `currencyID` attribute to one of the 3-character [currency codes](/api/nvp-soap/currency-codes/) for any of the supported PayPal currencies. 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](/api/nvp-soap/currency-codes/). 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](/api/nvp-soap/currency-codes/).<br /> This field is introduced in version 69.0.<br /> |
| `Number`<br />       | `xs:string`<br /&#x3E; &#x2A;(Optional)* Item number.<br /> Character length and limitations: 127 single-byte characters<br /> This field is introduced in version 69.0.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `Quantity`<br />     | `xs:integer`<br /> Item quantity. This field is required when `ItemCategory` is passed.<br /> Character length and limitations: Any positive integer<br /> This field is introduced in version 69.0.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `Tax`<br />          | `ebl:BasicAmountType`<br /&#x3E; &#x2A;(Optional)* Item sales tax.<br /> > **Note:** &#x2A;*Note:** You must set the `currencyID` attribute to one of the 3-character [currency codes](/api/nvp-soap/currency-codes/) for any of the supported PayPal currencies. 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](/api/nvp-soap/currency-codes/). 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](/api/nvp-soap/currency-codes/).<br /> This field is introduced in version 69.0.<br />                              |

## CreateRecurringPaymentsProfile Response Message [#createrecurringpaymentsprofile-response-message]

<img src="https://www.paypalobjects.com/webstatic/en_US/developer/docs/api/CreateRecurringPaymentsProfileResponseType1.gif" />

> **Note:** **Note:** Only the fields described in this documentation are available for use.

### CreateRecurringPaymentsProfile Response Fields [#createrecurringpaymentsprofile-response-fields]

| Field                        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ProfileID`<br />            | `xs:string`<br />                  A unique identifier for future reference to the details of this recurring payment.<br />                  Character length and limitations: Up to 14 single-byte alphanumeric characters.<br />                                                                                                                                                                                                                                            |
| `ProfileStatus`<br />        | `ns:RecurringPaymentsProfileStatusType`<br />                  Status of the recurring payment profile.<br />                  `ActiveProfile` — The recurring payment profile has been successfully created and activated for scheduled payments according the billing instructions from the recurring payments profile.<br />`PendingProfile` — The system is in the process of creating the recurring payment profile. Please check your IPN messages for an update.<br /> |
| `TransactionID`<br />        | `xs:string`<br />                  The transaction ID from the direct credit card initial payment.<br />  Character length and limitations: 17 characters. [Orders](/archive/paypal-payments-standard/admin/auth-capture/#types) transactions have 19 characters.                                                                                                                                                                                                             |
| `DCCProcessorResponse`<br /> | `xs:string`<br />                  The response from the direct credit card initial payment.<br />                                                                                                                                                                                                                                                                                                                                                                            |
| `DCCReturnCode`<br />        | `xs:string`<br />                  The return code if the direct credit card initial payment fails.<br />                                                                                                                                                                                                                                                                                                                                                                     |

## Additional information [#additional-information]

* [API error codes](/api/nvp-soap/errors/)