---
title: "Update a counterparty's payment method"
method: PATCH
path: "/counterparties/{counterparty_id}/payment-methods/{payment_method_id}"
tags: ["Counterparties"]
---

# Update a counterparty's payment method

`PATCH /counterparties/{counterparty_id}/payment-methods/{payment_method_id}`

## Request

- Base URL: `https://b2b.revolut.com/api/1.0`
- URL: `https://b2b.revolut.com/api/1.0/counterparties/{counterparty_id}/payment-methods/{payment_method_id}`
- Auth: HTTP bearer

Update the **address** of a counterparty's payment method.

:::tip [What is a payment method?]
A payment method is an individual account or card linked to a counterparty. When you [retrieve a counterparty](https://developer.revolut.com/docs/api/business#get-counterparty), the response includes an `accounts` array and a `cards` array — each entry in these arrays is a payment method with its own `id`.
:::

As only bank account payment methods have an address, you can use this endpoint to update the address of a counterparty's bank account.

To get the `payment_method_id` for the bank account, [retrieve the counterparty](https://developer.revolut.com/docs/api/business#get-counterparty) and use the `id` from the `accounts` array in the response.

You must provide the full address object — all required address fields must be present in the request.
Omitted optional fields will retain their existing values.

For more information, see the guide: [Update a counterparty's payment method](https://developer.revolut.com/docs/guides/manage-accounts/counterparties/update-counterparty-payment-method).

## Path parameters

- `counterparty_id` string, uuid, required
- `payment_method_id` string, uuid, required

## Request body

- UpdateCounterpartyPaymentMethodRequest: The request body for updating a counterparty's payment method address.
  - `address` UpdateCounterpartyPaymentMethodAddress, required: The updated address for the counterparty's payment method. All required fields must be provided.
    - `street_line1` string, required: Street line 1 information.
    - `street_line2` string: Street line 2 information.
    - `region` string: The name of the region (state or province), for example, Ontario for Canada.
    - `city` string, required: The name of the city.
    - `country` string, required: The country of the counterparty, provided as a 2-letter [ISO 3166](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) code.
    - `postcode` string, required: The postcode of the counterparty address.

## Response `204`

The address was updated

## Other responses

- `default`: Unexpected error

---

[API](https://skmtc.dev/revolut/apis/business-api.md) - [All operations](https://skmtc.dev/revolut/apis/business-api/llms.txt) - [OpenAPI document](https://skmtc.dev/revolut/apis/business-api/revisions/be089d9fa8b4?raw)