---
title: "Update a payment method domain"
method: POST
path: "/v1/payment_method_domains/{payment_method_domain}"
---

# Update a payment method domain

`POST /v1/payment_method_domains/{payment_method_domain}`

Updates an existing payment method domain.

## Path parameters

- `payment_method_domain` string, required

## Response `200`

Successful response.

- PaymentMethodDomain — A payment method domain represents a web domain that you have registered with Stripe. Stripe Elements use registered payment method domains to control where certain payment methods are shown. Related guide: [Payment method domains](https://docs.stripe.com/payments/payment-methods/pmd-registration).
  - `amazon_pay` PaymentMethodDomainResourcePaymentMethodStatus, required — Indicates the status of a specific payment method on a payment method domain.
    - `status` 'active' | 'inactive', required — The status of the payment method on the domain.
    - `status_details` PaymentMethodDomainResourcePaymentMethodStatusDetails — Contains additional details about the status of a payment method for a specific payment method domain.
      - `error_message` string, required — The error message associated with the status of the payment method on the domain.
  - `apple_pay` PaymentMethodDomainResourcePaymentMethodStatus, required — Indicates the status of a specific payment method on a payment method domain.
    - `status` 'active' | 'inactive', required — The status of the payment method on the domain.
    - `status_details` PaymentMethodDomainResourcePaymentMethodStatusDetails — Contains additional details about the status of a payment method for a specific payment method domain.
      - `error_message` string, required — The error message associated with the status of the payment method on the domain.
  - `created` integer, required — Time at which the object was created. Measured in seconds since the Unix epoch.
  - `domain_name` string, required — The domain name that this payment method domain object represents.
  - `enabled` boolean, required — Whether this payment method domain is enabled. If the domain is not enabled, payment methods that require a payment method domain will not appear in Elements.
  - `google_pay` PaymentMethodDomainResourcePaymentMethodStatus, required — Indicates the status of a specific payment method on a payment method domain.
    - `status` 'active' | 'inactive', required — The status of the payment method on the domain.
    - `status_details` PaymentMethodDomainResourcePaymentMethodStatusDetails — Contains additional details about the status of a payment method for a specific payment method domain.
      - `error_message` string, required — The error message associated with the status of the payment method on the domain.
  - `id` string, required — Unique identifier for the object.
  - `klarna` PaymentMethodDomainResourcePaymentMethodStatus, required — Indicates the status of a specific payment method on a payment method domain.
    - `status` 'active' | 'inactive', required — The status of the payment method on the domain.
    - `status_details` PaymentMethodDomainResourcePaymentMethodStatusDetails — Contains additional details about the status of a payment method for a specific payment method domain.
      - `error_message` string, required — The error message associated with the status of the payment method on the domain.
  - `link` PaymentMethodDomainResourcePaymentMethodStatus, required — Indicates the status of a specific payment method on a payment method domain.
    - `status` 'active' | 'inactive', required — The status of the payment method on the domain.
    - `status_details` PaymentMethodDomainResourcePaymentMethodStatusDetails — Contains additional details about the status of a payment method for a specific payment method domain.
      - `error_message` string, required — The error message associated with the status of the payment method on the domain.
  - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
  - `object` 'payment_method_domain', required — String representing the object's type. Objects of the same type share the same value.
  - `paypal` PaymentMethodDomainResourcePaymentMethodStatus, required — Indicates the status of a specific payment method on a payment method domain.
    - `status` 'active' | 'inactive', required — The status of the payment method on the domain.
    - `status_details` PaymentMethodDomainResourcePaymentMethodStatusDetails — Contains additional details about the status of a payment method for a specific payment method domain.
      - `error_message` string, required — The error message associated with the status of the payment method on the domain.

## Other responses

- `default` — Error response.

## Changes

> 51 revisions in range; 14 not diffed, 6 could not be searched.

- **2026-07-01** `e24a26de4188` — 3 breaking
  - removed the required property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/application_fee/anyOf[subschema #2: PlatformFee]/balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/payment_method_details/card/network` from the response with the `default` status
  - removed the required property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/payment_method_details/card/network` from the response with the `default` status
  - removed the required property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/failure_balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/payment_method_details/card/network` from the response with the `default` status
  - …this revision’s changelog is incomplete
- **2025-11-05** `62e8dc4ed869` — 1 info
  - added the optional property `error/payment_intent/payment_method_options/anyOf[subschema #1: PaymentIntentPaymentMethodOptions]/card_present/anyOf[subschema #1: payment_method_options_card_present]/capture_method` to the response with the `default` status
- …earlier changes not shown

[Full history](https://skmtc.dev/stripe/apis/spec3/changes/v1/payment_method_domains/:payment_method_domain/post.md)

---

[API](https://skmtc.dev/stripe/apis/spec3.md) · [All operations](https://skmtc.dev/stripe/apis/spec3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stripe/spec3/revisions/f0e0fc8fffbf/schema)