---
title: "Update payment failure configuration"
method: PATCH
path: "/subscriptions/{subscription_id}/payment_failure_configuration"
tags: ["Subscriptions"]
---

# Update payment failure configuration

`PATCH /subscriptions/{subscription_id}/payment_failure_configuration`

Updates the subscription's automated payment recovery enrolment by changing its `recovery_strategy`. Send `none` to unenrol. The auto-cancellation threshold (`incomplete_bills_before_cancellation`) can only be set when the subscription is created and cannot be changed here.

## Path parameters

- `subscription_id` string, required

## Request body

- UpdatePaymentFailureConfigurationRequest
  - `recovery_strategy` string, nullable — The name of the recovery strategy to enrol the subscription in for automated payment recovery. Send `none` to unenrol. Omit the field, or send `null`, to leave the current strategy unchanged. Valid strategy names are provided to you as part of onboarding.

## Response `200`

Payment Failure Configuration Updated

- PaymentFailureConfigurationResponse
  - `recovery_strategy` string, required — The name of the recovery strategy the subscription is enrolled in. Returns `none` when the subscription is not enrolled in automated payment recovery.
  - `links` object[], required
    - `rel` 'subscription'
    - `href` string — Link to the resource which should be appended to base URL.
    - `method` string — The HTTP method to use with the link.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.dev/acquired/apis/acquired-api.md) · [All operations](https://skmtc.dev/acquired/apis/acquired-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/acquired/acquired-api/revisions/7ae178a046f2/schema)