---
title: Update Payment Method
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api)

[Accounts](https://developers.cloudflare.com/api/resources/accounts)

[Payment Methods](https://developers.cloudflare.com/api/resources/accounts/subresources/payment%5Fmethods)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Update Payment Method

PUT/accounts/{account\_id}/payment-methods/{payment\_method\_id}

Updates a payment method for an account.

##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/).

**Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY`

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

**Example:**`X-Auth-Email: user@example.com`

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

**Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194`

##### Accepted Permissions (at least one required)

`Billing Write`

##### Path ParametersExpand Collapse 

account\_id: string

Identifier

maxLength32

payment\_method\_id: string

Identifier

maxLength32

##### Body ParametersJSONExpand Collapse 

address: optional string

Billing address line 1.

address2: optional string

Billing address line 2.

bank\_account\_type: optional string

Bank account type.

bank\_code: optional string

Bank code.

bank\_country: optional string

Bank country.

bank\_name: optional string

Bank name for bank-based payment methods.

bank\_routing\_number: optional string

Bank routing number.

cashapp\_cash\_tag: optional string

Cash App cash tag.

city: optional string

Billing city.

country: optional string

Billing country.

default: optional boolean

Whether this is the default payment method.

device\_data: optional string

Device data for fraud prevention.

first\_name: optional string

Billing first name.

last\_name: optional string

Billing last name.

nick\_name: optional string

A nickname for the payment method.

payment\_account\_email: optional string

Email associated with the payment account.

payment\_email: optional string

Payment email address.

payment\_gateway: optional string

The payment gateway used.

payment\_nonce: optional string

Payment nonce for tokenized payments.

state: optional string

Billing state.

type: optional "CREDIT\_CARD" or "PAYPAL" or "CASHAPP" or 3 more

The payment method type.

One of the following:

"CREDIT\_CARD"

"PAYPAL"

"CASHAPP"

"SEPA\_DEBIT"

"LINK"

"ACH\_DIRECT\_DEBIT"

zipcode: optional string

Billing zip code.

##### ReturnsExpand Collapse 

errors: array of [ResponseInfo](https://developers.cloudflare.com/api/resources/$shared#%28resource%29%20%24shared%20%3E%20%28model%29%20response%5Finfo%20%3E%20%28schema%29) { code, message, documentation\_url, source } 

code: number

minimum1000

message: string

documentation\_url: optional string

source: optional object { pointer } 

pointer: optional string

messages: array of [ResponseInfo](https://developers.cloudflare.com/api/resources/$shared#%28resource%29%20%24shared%20%3E%20%28model%29%20response%5Finfo%20%3E%20%28schema%29) { code, message, documentation\_url, source } 

code: number

minimum1000

message: string

documentation\_url: optional string

source: optional object { pointer } 

pointer: optional string

result: object { id, address, address2, 22 more } 

id: optional string

Payment method identifier.

address: optional string

Billing address line 1.

address2: optional string

Billing address line 2.

bank\_account\_type: optional string

Bank account type.

bank\_code: optional string

Bank code.

bank\_country: optional string

Bank country.

bank\_name: optional string

Bank name for bank-based payment methods.

bank\_routing\_number: optional string

Bank routing number.

cashapp\_cash\_tag: optional string

Cash App cash tag.

city: optional string

Billing city.

country: optional string

Billing country.

default: optional boolean

Whether this is the default payment method.

device\_data: optional string

Device data for fraud prevention.

expiration\_date: optional string

Card expiration date.

first\_name: optional string

Billing first name.

last\_four: optional string

Last four digits of the card number.

last\_name: optional string

Billing last name.

nick\_name: optional string

A nickname for the payment method.

payment\_account\_email: optional string

Email associated with the payment account.

payment\_email: optional string

Payment email address.

payment\_gateway: optional string

The payment gateway used.

payment\_nonce: optional string

Payment nonce for tokenized payments.

state: optional string

Billing state.

type: optional "CREDIT\_CARD" or "PAYPAL" or "CASHAPP" or 3 more

The payment method type.

One of the following:

"CREDIT\_CARD"

"PAYPAL"

"CASHAPP"

"SEPA\_DEBIT"

"LINK"

"ACH\_DIRECT\_DEBIT"

zipcode: optional string

Billing zip code.

success: true

Whether the API call was successful

### Update Payment Method

HTTP

HTTPHTTP

TypeScriptTypeScript

PythonPython

GoGo

TerraformTerraform

```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/payment-methods/$PAYMENT_METHOD_ID \
    -X PUT \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
    -d '{
          "type": "CREDIT_CARD"
        }'
```

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "id": "id",
    "address": "address",
    "address2": "address2",
    "bank_account_type": "bank_account_type",
    "bank_code": "bank_code",
    "bank_country": "bank_country",
    "bank_name": "bank_name",
    "bank_routing_number": "bank_routing_number",
    "cashapp_cash_tag": "cashapp_cash_tag",
    "city": "city",
    "country": "country",
    "default": true,
    "expiration_date": "expiration_date",
    "first_name": "first_name",
    "last_four": "4242",
    "last_name": "last_name",
    "nick_name": "nick_name",
    "payment_account_email": "payment_account_email",
    "payment_email": "payment_email",
    "state": "state",
    "type": "CREDIT_CARD",
    "zipcode": "zipcode"
  },
  "success": true
}
```

##### Returns Examples

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "id": "id",
    "address": "address",
    "address2": "address2",
    "bank_account_type": "bank_account_type",
    "bank_code": "bank_code",
    "bank_country": "bank_country",
    "bank_name": "bank_name",
    "bank_routing_number": "bank_routing_number",
    "cashapp_cash_tag": "cashapp_cash_tag",
    "city": "city",
    "country": "country",
    "default": true,
    "expiration_date": "expiration_date",
    "first_name": "first_name",
    "last_four": "4242",
    "last_name": "last_name",
    "nick_name": "nick_name",
    "payment_account_email": "payment_account_email",
    "payment_email": "payment_email",
    "state": "state",
    "type": "CREDIT_CARD",
    "zipcode": "zipcode"
  },
  "success": true
}
```