---
title: "Update a payment method by Id"
method: PATCH
path: "/payment-methods/{paymentMethodId}"
tags: ["Payment Methods"]
---

# Update a payment method by Id

`PATCH /payment-methods/{paymentMethodId}`

This is used to update an existing payment method

## Path parameters

- `paymentMethodId` string, required

## Request body

- object — The request body for updating a payment method
  - `billingAddress` CustomerAddress, nullable
    - `firstName` string — The first name of the customer
    - `lastName` string — The last name of the customer
    - `lineOne` string — First line of the address
    - `lineTwo` string — Second line of the address
    - `city` string — The address city/town
    - `country` string, required — The two-character ISO country code
    - `postalCode` string, required — The postal code/zip of the address
    - `region` string, nullable — The state/county/province/region Required if the address is in the US/Canada and must be a 2-character ISO state/province code

## Response `200`

Successfully updated the given PaymentMethod

- PaymentMethod
  - `id` string — The ID of the payment method
  - `type` 'Card' — The type of the payment method
  - `card` PaymentMethodCard
    - `scheme` 'Visa' | 'Mastercard' | 'Amex'
    - `last4` string — The last 4 digits of the card
    - `expiryMonth` string — The 2-digit expiry month of the card
    - `expiryYear` string — The 4-digit expiry year of the card
  - `billingAddress` CustomerAddress, nullable
    - `firstName` string — The first name of the customer
    - `lastName` string — The last name of the customer
    - `lineOne` string — First line of the address
    - `lineTwo` string — Second line of the address
    - `city` string — The address city/town
    - `country` string, required — The two-character ISO country code
    - `postalCode` string, required — The postal code/zip of the address
    - `region` string, nullable — The state/county/province/region Required if the address is in the US/Canada and must be a 2-character ISO state/province code
  - `checks` PaymentMethodChecks, nullable
    - `avsResponseCode` string, nullable — The response from Address Verification Service (AVS) that determines the match or partial match of the customer's billing address. Possible values: - A - Partial Match (street address matches, postal/zip code does not match) - B - Partial Match (street address matches, postal/zip code not verified) - C - No Match (street address and postal/zip code not verified) - D - Full Match (street address and postal/zip code match) - F - Full Match (street address and postal/zip code match) - G - Not Supported (address information not verified) - I - No Match (address information not verified) - M - Full Match (street address and postal/zip code match) - N - No Match (neither street address not postal/zip code match) - P - Partial Match (postal/zip code matches, street address not verified) - R - System Unavailable (unable to perform verification) - S - Not Supported (AVS currently not supported by issuer) - U - System Unavailable (address information not verified due to no data from issuer) - W - Partial Match (postal/zip code matches, street address does not match) - X - Full Match (street address and postal/zip code match) - Y - Full Match (street address and postal/zip code match) - Z - Partial Match (postal/zip code matches, street address does not match)
    - `cvvResponseCode` string, nullable — The response from the check on the Card Verification Value (CVV/CVV2/CVC) Possible values: - M - Match (Visa and MC) - Y - Match (Amex) - N - No Match - P - Not Processed - S - Should be on card - U - Issuer does not participate
  - `customerId` string, nullable — The Id of the customer this card belongs to (null if the payment-method is single-use)
  - `createdTimestamp` integer — The epoch timestamp (seconds) when the payment method was created

## Other responses

- `404` — The given resource could not be found
- `500` — An unexpected error occurred when executing this request

---

[API](https://skmtc.net/ryftpay/apis/ryft-payment-api.md) · [All operations](https://skmtc.net/ryftpay/apis/ryft-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ryftpay/ryft-payment-api/revisions/a042f64d4305/schema)