---
title: "Live Application: Update Payment Method"
method: PATCH
path: "/live_application/{merchant_id}/payment_methods/{payment_method}"
tags: ["Platform Model"]
---

# Live Application: Update Payment Method

`PATCH /live_application/{merchant_id}/payment_methods/{payment_method}`

Update the payment method application of the applicant merchant

## Path parameters

- `merchant_id` string, required — A unique 25-character alphanumeric resource identifier.
- `payment_method` string, required

## Request body

- UpdatePaymentMethodRequest
  - `locale` 'ja' | 'en' | 'ko' — For supported payment methods, sets the language of the instruction page.
  - `shared_payment_method_data.open_time` string — Business opening time for this merchant's store.
  - `shared_payment_method_data.close_time` string — Business closing time for this merchant's store.
  - `shared_payment_method_data.privacy_policy_url` string — URL to the merchant's privacy policy page.
  - `shared_payment_method_data.terms_of_service_url` string — URL to the merchant's terms of service page.
  - `shared_payment_method_data.pci_compliance_proofs` string[] — File IDs of uploaded PCI compliance proof documents.
  - `shared_payment_method_data.shareholder_registers` string[] — File IDs of uploaded shareholder register documents.
  - `shared_payment_method_data.has_processed_cc_before` boolean — Whether the merchant has previously processed credit card payments.
  - `shared_payment_method_data.processes_card_info` boolean — Whether the merchant directly handles or stores card information.
  - `shared_payment_method_data.conducts_door_to_door_sales` boolean — Whether the merchant conducts door-to-door sales.
  - `shared_payment_method_data.conducts_telemarketing` boolean — Whether the merchant conducts telemarketing activities.
  - `shared_payment_method_data.conducts_mlm_scheme` boolean — Whether the merchant operates a multi-level marketing scheme.
  - `shared_payment_method_data.conducts_business_opportunity_scheme` boolean — Whether the merchant offers business opportunity schemes.
  - `shared_payment_method_data.provides_specified_continuous_services` boolean — Whether the merchant provides services subject to the Specified Commercial Transaction Act.
  - `shared_payment_method_data.violated_consumer_contract_act` boolean — Whether the merchant has violated the Consumer Contract Act.
  - `shared_payment_method_data.violated_commercial_transaction_act` boolean — Whether the merchant has violated the Commercial Transaction Act.
  - `linepay.accepted_line_tos` boolean — Whether the merchant has accepted LINE Pay's terms of service.
  - `linepay.fields` string — Serialized form fields for the LINE Pay application.
  - `paypay.accepted_paypay_tos` boolean — Whether the merchant has accepted PayPay's terms of service.
  - `paypay.fields` string — Serialized form fields for the PayPay application.
  - `merpay.accepted_merpay_tos` boolean — Whether the merchant has accepted Merpay's terms of service.
  - `merpay.fields` string — Serialized form fields for the Merpay application.
  - `convenience_store.expected_number_of_payments` integer — Estimated monthly number of convenience store payments.
  - `convenience_store.fields` string — Serialized form fields for the convenience store application.
  - `seven_eleven.site_is_public` boolean — Whether the merchant's website is publicly accessible.
  - `seven_eleven.no_direct_delivery_from_producer` boolean — Confirmation that products are not delivered directly from producers.
  - `seven_eleven.no_ticket_sales` boolean — Confirmation that the merchant does not sell tickets.
  - `seven_eleven.correct_flow_for_order_items` boolean — Confirmation that the order flow matches Seven-Eleven's requirements.
  - `seven_eleven.delivery_within_two_months` boolean — Confirmation that all ordered items will be delivered within two months.
  - `seven_eleven.all_items_are_cheaper_than_konbini_limit` boolean — Confirmation that all items are priced below the konbini payment limit.
  - `seven_eleven.display_sales_permit_number` boolean — Confirmation that any required sales permit numbers are displayed.
  - `seven_eleven.order_fee_is_displayed` boolean — Confirmation that the order fee is clearly displayed to customers.
  - `seven_eleven.no_international_transaction` boolean — Confirmation that transactions are domestic only.
  - `seven_eleven.provided_info_matches_sctl` boolean — Confirmation that site info matches the Specified Commercial Transaction Law disclosure page.
  - `seven_eleven.sctl_page_has_phone_number` boolean — Confirmation that the SCTL page includes a phone number.
  - `seven_eleven.product_pages_are_public` boolean — Confirmation that product detail pages are publicly viewable.
  - `seven_eleven.have_sold_as_regular_price` boolean — Confirmation that items have been sold at regular (non-discounted) price before.
  - `seven_eleven.note` string — Free-text notes for the Seven-Eleven application.
  - `seven_eleven.fields` string — Serialized form fields for the Seven-Eleven application.
  - `visa_mastercard_credit_card.access_restrictions` boolean — Confirmation that the site has appropriate access restrictions in place.
  - `visa_mastercard_credit_card.mfa_implementation` boolean — Confirmation that multi-factor authentication is implemented.
  - `visa_mastercard_credit_card.account_lock` boolean — Confirmation that account lockout policies are in place.
  - `visa_mastercard_credit_card.public_directories` boolean — Confirmation that public directory listing is disabled.
  - `visa_mastercard_credit_card.file_extension_restrictions` boolean — Confirmation that file extension restrictions are enforced.
  - `visa_mastercard_credit_card.vulnerability_assessments` boolean — Confirmation that regular vulnerability assessments are conducted.
  - `visa_mastercard_credit_card.sql_injection_and_xss` boolean — Confirmation that the site is protected against SQL injection and XSS attacks.
  - `visa_mastercard_credit_card.source_code_review` boolean — Confirmation that source code security review is performed.
  - `visa_mastercard_credit_card.anti_virus_software` boolean — Confirmation that anti-virus software is installed and maintained.
  - `visa_mastercard_credit_card.fields` string — Serialized form fields for the Visa/Mastercard credit card application.
  - `jcb_amex_diners_credit_card.access_restrictions` boolean — Confirmation that the site has appropriate access restrictions in place (JCB/Amex/Diners).
  - `jcb_amex_diners_credit_card.mfa_implementation` boolean — Confirmation that multi-factor authentication is implemented (JCB/Amex/Diners).
  - `jcb_amex_diners_credit_card.account_lock` boolean — Confirmation that account lockout policies are in place (JCB/Amex/Diners).
  - `jcb_amex_diners_credit_card.public_directories` boolean — Confirmation that public directory listing is disabled (JCB/Amex/Diners).
  - `jcb_amex_diners_credit_card.file_extension_restrictions` boolean — Confirmation that file extension restrictions are enforced (JCB/Amex/Diners).
  - `jcb_amex_diners_credit_card.vulnerability_assessments` boolean — Confirmation that regular vulnerability assessments are conducted (JCB/Amex/Diners).
  - `jcb_amex_diners_credit_card.sql_injection_and_xss` boolean — Confirmation that the site is protected against SQL injection and XSS attacks (JCB/Amex/Diners).
  - `jcb_amex_diners_credit_card.source_code_review` boolean — Confirmation that source code security review is performed (JCB/Amex/Diners).
  - `jcb_amex_diners_credit_card.anti_virus_software` boolean — Confirmation that anti-virus software is installed and maintained (JCB/Amex/Diners).
  - `jcb_amex_diners_credit_card.fields` string — Serialized form fields for the JCB/Amex/Diners credit card application.

## Response `200`

Subsequent requests will specify errored fields or additional required fields

- PaymentMethodApplication
  - `merchant_id` string, required — A unique 25-character alphanumeric resource identifier.
  - `status` 'submitted' | 'accepted' | 'declined', required
  - `payments_enabled` boolean, required — Whether payments have been enabled following payment-method review.
  - `payouts_enabled` boolean, required — Whether payouts have been enabled following payment-method review.
  - `requested_fields` Field[], required — Fields currently required to be submitted for this payment method.
    - `field_type` string, required — The input type for this field (e.g. "text", "file", "boolean").
    - `field` string, required — Machine-readable key name of the field.
    - `field_name` string, required — Human-readable display name of the field.
    - `field_properties` object, required
      - `external_links` string[] — Array of URLs to external resources relevant to this field.
      - `minLength` integer — Minimum character length for the field value.
      - `format` string — Semantic format hint for the field value (e.g. "date", "email").
      - `pattern` string — Regular expression the field value must match.
      - `minimum` integer — Minimum numeric value for integer fields.
      - `maximum` integer — Maximum numeric value for integer fields.
      - `enum` object — Map of human-readable labels to enum codes for dropdown/radio fields.
      - `items` object — Schema describing each item in an array field.
    - `position` integer, required — Display order position of this field in the application form.
    - `optional` boolean, required — Whether this field is optional (true) or required (false).
  - `newly_requested_fields` Field[], required — Fields newly added to the required list since last submission.
    - `field_type` string, required — The input type for this field (e.g. "text", "file", "boolean").
    - `field` string, required — Machine-readable key name of the field.
    - `field_name` string, required — Human-readable display name of the field.
    - `field_properties` object, required
      - `external_links` string[] — Array of URLs to external resources relevant to this field.
      - `minLength` integer — Minimum character length for the field value.
      - `format` string — Semantic format hint for the field value (e.g. "date", "email").
      - `pattern` string — Regular expression the field value must match.
      - `minimum` integer — Minimum numeric value for integer fields.
      - `maximum` integer — Maximum numeric value for integer fields.
      - `enum` object — Map of human-readable labels to enum codes for dropdown/radio fields.
      - `items` object — Schema describing each item in an array field.
    - `position` integer, required — Display order position of this field in the application form.
    - `optional` boolean, required — Whether this field is optional (true) or required (false).
  - `errored_fields` ErroredField[], required — Fields that were submitted but failed validation.
    - `field_type` string, required — The input type for this field (e.g. "text", "file", "boolean").
    - `field` string, required — Machine-readable key name of the field.
    - `field_name` string, required — Human-readable display name of the field.
    - `field_properties` object, required
      - `external_links` string[] — Array of URLs to external resources relevant to this field.
      - `minLength` integer — Minimum character length for the field value.
      - `format` string — Semantic format hint for the field value (e.g. "date", "email").
      - `pattern` string — Regular expression the field value must match.
      - `minimum` integer — Minimum numeric value for integer fields.
      - `maximum` integer — Maximum numeric value for integer fields.
      - `enum` object — Map of human-readable labels to enum codes for dropdown/radio fields.
      - `items` object — Schema describing each item in an array field.
    - `position` integer, required — Display order position of this field in the application form.
    - `optional` boolean, required — Whether this field is optional (true) or required (false).
    - `value` union, required
      - string
      - boolean
      - integer
    - `error` string[], required

---

[API](https://skmtc.dev/komoju/apis/komoju-api.md) · [All operations](https://skmtc.dev/komoju/apis/komoju-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/komoju/komoju-api/revisions/65483c40ba32/schema)
