# ManageRecurringPaymentsProfileStatus API Operation (SOAP) (/api/nvp-soap/manage-recurring-payments-profile-status-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](/).

The ManageRecurringPaymentsProfileStatus API operation cancels, suspends, or reactivates a recurring payments profile.

## ManageRecurringPaymentsProfileStatus Request Message [#managerecurringpaymentsprofilestatus-request-message]

![](https://www.paypalobjects.com/webstatic/en_US/developer/docs/api/ManageRecurringPaymentsProfileStatusRequestType1.gif)

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

### ManageRecurringPaymentsProfileStatus Request Fields [#managerecurringpaymentsprofilestatus-request-fields]

| Field<br />       | Description<br />                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ProfileID`<br /> | `xs:string`<br /&#x3E; &#x2A;(Required)* Recurring payments profile ID returned in the `CreateRecurringPaymentsProfile` response.<br /> Character length and limitations: 14 single-byte alphanumeric characters. 19 character profile IDs are supported for compatibility with previous versions of the PayPal API.<br />                                                          |
| `Action`<br />    | `ns:StatusChangeActionType`<br /&#x3E; &#x2A;(Required)* The action to be performed to the recurring payments profile. Must be one of the following:<br /> `Cancel` — Only profiles in Active or Suspended state can be canceled.<br />`Suspend` — Only profiles in Active state can be suspended.<br />`Reactivate` — Only profiles in a suspended state can be reactivated.<br /> |
| `Note`<br />      | `xs:string`<br /&#x3E; &#x2A;(Optional)* The reason for the change in status. For Express Checkout-created profiles, this message is included in the email notification to the buyer when the status of the profile is successfully changed, and can also be seen by both you and the buyer on the Status History page of the PayPal account.<br />                                 |

## ManageRecurringPaymentsProfileStatus Response Message [#managerecurringpaymentsprofilestatus-response-message]

![](https://www.paypalobjects.com/webstatic/en_US/developer/docs/api/ManagePendingTransactionStatusResponseType1.gif)

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

### ManageRecurringPaymentsProfileStatus Response Fields [#managerecurringpaymentsprofilestatus-response-fields]

| Field<br />       | Description<br />                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ProfileID`<br /> | `xs:string`<br /> Recurring payments profile ID returned in the `CreateRecurringPaymentsProfile` response. For each action, an error is returned if the recurring payments profile has a status that is not compatible with the action. Errors are returned in the following cases:<br /> `Cancel` — Profile status is not Active or Suspended.<br />`Suspend` — Profile status is not Active.<br />`Reactivate` — Profile status is not Suspended.<br /> |