---
title: "Retrieve configuration of cascading payment methods for an account"
method: GET
path: "/v1/accounts/{account-key}/payment-methods/cascading"
tags: ["Accounts"]
---

# Retrieve configuration of cascading payment methods for an account

`GET /v1/accounts/{account-key}/payment-methods/cascading`

Zuora provides the Cascading Payment Method feature to dynamically retry the failed payment with alternative payment methods according to a predefined priority list. Use this API operation to retrieve the configuration information for Cascading Payment Method of a specified account, including the cascading consent value and the priority list of payment methods.

Before you use this API operation, ensure that the Cascading Payment Method feature is enabled. For more information about the Cascading Payment Method feature, see <a href="https://docs.zuora.com?resourceId=payments-cascade-payment-methods" target="_blank">Cascade payment methods</a>.

## Path parameters

- `account-key` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- GetCascadingPaymentMethodsConfigurationResponse
  - `consent` boolean — `true` indicates the consent from your customer to use the Cascading Payment Method feature was collected. `false` indicates the consent was not collected and the Cascading Payment Method feature is not enabled.
  - `priorities` object[] — Container for the priority configuration of payment methods.
    - `paymentMethodId` string, nullable — The ID of a payment method.
    - `order` integer — The order of the payment method in the priority list. For example, `1` indicates the payment method is the first one in the priority list, and `2` indicates it is the second. The first payment method in the priority list is the default payment method of the customer account.
  - `success` boolean — Indicates whether the call succeeded.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

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