---
title: "Update Payment Method"
method: PATCH
path: "/v1/billing/payment_methods/{payment_method_id}"
tags: ["Billing"]
---

# Update Payment Method

`PATCH /v1/billing/payment_methods/{payment_method_id}`

NOTE: Only credit cards can be updated this way. PayPal subscriptions will need to be cancelled at PayPal and a new subscription can be applied to an open invoice

## Path parameters

- `payment_method_id` integer, required

## Request body

- UpdateBillingPayMethodRequest
  - `active` boolean — Use this payment method for all automated payments
  - `address_id` integer — ID of the billing address used for this payment method
  - `description` string — Optional description of the card
  - `expiry_date` string — Expiration month and year of the payment method (if it is a credit card)

## Response `200`

OK

- BillingPaymentMethodResponse
  - `success` boolean — whether the request succeeded
  - `errors` string[]
  - `messages` string[], nullable
  - `result` BillingPaymentMethod — Payment method on the account. Either a Credit Card or PayPal. Onlty the 'active' payment method will be used to pay any automated payments.
    - `id` integer, required — ID of the payment method
    - `type` 'Credit Card' | 'PayPal', required
    - `active` boolean, required — The active payment method is the one that will be used to pay any automated payments
    - `description` string, required — Optional description of the card
    - `address` BillingAddress — Address associated with a credit card or billing contact
      - `id` integer — Billing address identifier
      - `first_name` string — First name of the billing contact
      - `last_name` string — Last name of the billing contact
      - `address_line_1` string — First Address line of the billing contact
      - `address_line_2` string — Second Address line of the billing contact
      - `company_name` string — Company name of the billing contact
      - `email` string — Email address of the billing contact
      - `city` string — City of the billing contact
      - `state` string — State / Province of the billing contact
      - `country` string — Country Code of the billing contact
      - `postal_code` string — Postal code of the billing contact
      - `telephone` string — Telephone number of the billing contact
      - `receive_invoice_emails` boolean — If this email address should receive invoice related emails
    - `address_id` integer — ID of the billing address used for this payment method
    - `card_last_four` string — Last 4 digits of the payment method (if it is a credit card)
    - `card_type` string — Used payment card network
    - `expiry_date` string — Expiration month and year of the payment method (if it is a credit card)
    - `last_updated` string — Date the payment method was last updated
    - `gateway_token` string — If requested, the token used to pay at the payment gateway

## Other responses

- `400` — Bad Request
- `401` — Authentication failed
- `403` — Not authorized to access endpoint
- `405` — Invalid input
- `500` — Internal error

---

[API](https://skmtc.net/rocket/apis/rocket-net-api.md) · [All operations](https://skmtc.net/rocket/apis/rocket-net-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rocket/rocket-net-api/versions/db0dcbbc5764/schema)