> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Payment Methods

> See which payment methods a sub-merchant can accept and switch each instrument on or off using the Razorpay Method Management API.

Available in
🇮🇳 India

Use the Method Management API to see which payment methods a sub-merchant account can accept, and to switch them on or off. Razorpay raises any onboarding with the bank or provider for you.

> [!NOTE]
>
> **Handy Tips**
>
> * Only a partner platform can call this API, for a sub-merchant account mapped to its app. A sub-merchant cannot call it for its own account.
> * It works in live mode only. Test credentials are not supported.
> * Version 1 covers e-commerce accounts only. For any other business category, the API returns `403` with `category_not_supported`.

## What You Can Do

* **See every payment method and its instruments.** Each instrument shows its status, whether customers can pay with it now, how long activation is expected to take and what Razorpay still needs.
* **Switch an instrument on or off**, one per call. If the instrument first needs onboarding with a bank or provider, switching it on starts that onboarding.
* **Supply what is missing.** Each instrument lists its open requirements. You answer them with the Onboarding APIs you already use.

## Endpoints

Both endpoints sit under the account's `payment_gateway` product. Here, `…` stands for `/v3/accounts/{account_id}/products/payment_gateway`.

| Method | Path | Purpose |
| - | - | - |
| `GET` | `…/payment_methods` | Fetch all payment methods, or one payment method with `?method=`. |
| `PATCH` | `…/payment_methods` | Enable or disable one instrument. The request body names it. |

## Key Terms

| Term | Meaning |
| - | - |
| Payment method | A group of instruments: `card`, `netbanking`, `upi`, `wallet`, `emi` or `cod`. |
| Instrument | One way a customer can pay inside a payment method, such as the HDFC Bank netbanking option or the Visa card network. |
| Group | An EMI instrument that holds members, such as `debit_card` and `cardless_emi`. You can switch a group as a whole. |
| Requirement | Something Razorpay needs about the account before it can activate an instrument. It is the same object the Onboarding APIs return. |

## Authenticate

Use the partner key and secret of your app, sent as HTTP Basic credentials on every request. The user name is `rzp_live_partner_[CLIENT_ID]` and the password is the secret. Your key needs the `account_read` scope to fetch and `account_read_write` to enable or disable.

Every request must come from an IP address allowlisted for your app, for an account mapped to your app, where the sub-merchant's consent is on record. Know more about [authenticating your platform](https://razorpay.com/docs/partners/aggregators/onboarding-api#authenticate-your-platform).

## Integration Steps

1. [Fetch and Enable Instruments](https://razorpay.com/docs/partners/aggregators/onboarding-api/payment-methods/fetch-and-enable.md): See the payment methods, switch an instrument on and read the result.
2. [Activated vs Enabled](https://razorpay.com/docs/partners/aggregators/onboarding-api/payment-methods/activated-vs-enabled.md): Understand the two fields and the four paths an instrument takes to go live.
3. [Supply Requirements](https://razorpay.com/docs/partners/aggregators/onboarding-api/payment-methods/supply-requirements.md): Answer what Razorpay needs for an instrument.
4. [Follow Onboarding](https://razorpay.com/docs/partners/aggregators/onboarding-api/payment-methods/follow-onboarding.md): Track an instrument to activation with a webhook or by polling.
5. [Cash on Delivery](https://razorpay.com/docs/partners/aggregators/onboarding-api/payment-methods/cash-on-delivery.md): Switch full and partial COD on or off.

## Next Step

[Fetch and Enable Instruments](https://razorpay.com/docs/partners/aggregators/onboarding-api/payment-methods/fetch-and-enable.md)
