---
title: "Patch a configuration document"
method: PATCH
path: "/v1/merchant_configurations/{id}"
tags: ["merchant_configurations"]
---

# Patch a configuration document

`PATCH /v1/merchant_configurations/{id}`

## Request

- Base URL: `https://ewallets-api.paymongo.com`
- URL: `https://ewallets-api.paymongo.com/v1/merchant_configurations/{id}`
- Auth: HTTP bearer

JSON merge patch on features, settings and providers (null removes a key); enabled and provider are set directly ("provider": null clears it). expected_version must be the version read; a document that moved on answers 409 and nothing is written.

## Path parameters

- `id` string, required

## Headers

- `PayMongo-Actor` string, required
- `PayMongo-Livemode` 'true' | 'false', required

## Request body

- InternalMerchantconfigHandlerPatchMerchantConfigurationRequestDTO
  - `enabled` boolean
  - `expected_version` integer, required
  - `features` object
  - `provider` string
  - `providers` object
  - `reason` string
  - `settings` object

## Response `200`

OK

- object: Standard response containing data and its metadata if any
  - `data` InternalMerchantconfigHandlerMerchantConfigurationResponseDTO
    - `configured` boolean
    - `created_at` string
    - `enabled` boolean
    - `features` object
    - `id` string
    - `livemode` boolean
    - `method` string
    - `organization_id` string
    - `provider` string
    - `providers` object
    - `settings` object
    - `updated_at` string
    - `version` integer
  - `has_more` boolean

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `409`: version_conflict
- `422`: account_not_configured, feature_unsupported or schema_violation

---

[API](https://skmtc.dev/paymongo/apis/ewallets.md) - [All operations](https://skmtc.dev/paymongo/apis/ewallets/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/ewallets/revisions/a445ca65c132?raw)