---
title: "Patch Payment Method"
method: PATCH
path: "/v4/accounts/{voip_id}/payment-methods/{id}"
tags: ["Payment Methods"]
---

# Patch Payment Method

`PATCH /v4/accounts/{voip_id}/payment-methods/{id}`

Replace the status of an individual payment method.

## Path parameters

- `voip_id` integer, required
- `id` integer, required

## Request body

- object
  - `status` 'onfile' | 'primary' | 'hidden', nullable — Can be 'primary' = primary card used for billing, 'onfile' = card on file, 'hidden' = deleted card

## Response `200`

OK

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation failed
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/phone/phoenix-api-by-phone-com/revisions/29cb08fa4b03/schema)