--- title: "Changes to Create a Merchant" method: POST path: "/payments/merchants" --- # Changes to Create a Merchant `POST /payments/merchants` > Every recorded change to this operation, newest first. ## Timeline Changed in 3 of 5 revisions. - **2026-11-06** `8d0ca833fa04`: 8 breaking, 6 warning, 26 info - **2026-04-17** `5e1eb58d42d5`: 2 breaking, 2 info - **2025-11-18** `30ea25af4354`: 5 warning, 8 info ## Changes - **2026-11-06** `8d0ca833fa04`: 8 breaking, 6 warning, 26 info - the request property `applePay/domains` became required - added the pattern `^(?:https?://[a-z0-9.-]+\.[a-z]{2,63}|www\d{0,3}\.[a-z0-9.-]+\.[a-z]{2,63}|[a-z0-9.-]+\.[a-z]{2,63}/)(?:(?:[^\s()<>:]+|\((?:[^\s()<>:]+|\([^\s()<>:]+\))*\))*(?:\((?:[^\s()<>:]+|\([^\s()<>:]+\))*\)|[^\s`!()\[\]{};:'".,<>?«»“”‘’:]))?$` to the request property `website` - added the pattern `^[0-9a-zA-Z ]*$` to the request property `business/address/postalCode` - added the pattern `^[0-9a-zA-Z _\-¡-￿]+$` to the request property `business/address/city` - added the pattern `^[a-zA-Z0-9 ]{1,60}$` to the request property `business/legalName` - added the pattern `^[a-zA-Z0-9 ]{1,60}$` to the request property `name` - added the pattern `^[À-ÖØ-öø-ǿa-zA-Z0-9().\-_#,;/@$!% ]+$` to the request property `business/address/line1` - added the pattern `^[À-ÖØ-öø-ǿa-zA-Z0-9().\-_#,;/@$!% ]+$` to the request property `business/address/line2` - the `business/address/city` request property's maxLength was set to `50` - the `business/address/line1` request property's maxLength was set to `60` - the `business/address/line2` request property's maxLength was set to `60` - the `business/address/postalCode` request property's maxLength was set to `20` - the `website` request property's maxLength was set to `100` - removed the request property `networkTokens` - added the new optional request property `contact` - added the new optional request property `externalCustomerReference` - added the new optional request property `preChargebackAlerts` - added the new optional request property `shortName` - added the optional property `contact` to the response with the `201` status - added the optional property `preChargebackAlerts` to the response with the `201` status - added the optional property `shortName` to the response with the `201` status - the response property `applePay` became required for the status `201` - the response property `applePay/domains` became required for the status `201` - the response property `applePay/domains/items/domain` became required for the status `201` - the response property `applePay/domains/items/status` became required for the status `201` - the response property `business` became required for the status `201` - the response property `business/address` became required for the status `201` - the response property `business/legalName` became required for the status `201` - the response property `categoryCode` became required for the status `201` - the response property `networkTokens` became required for the status `201` - the response property `networkTokens/enrolment` became required for the status `201` - the response property `networkTokens/enrolment/items/cardBrand` became required for the status `201` - the response property `networkTokens/enrolment/items/status` became required for the status `201` - the `business/address/city` response's property pattern `^[0-9a-zA-Z _\-¡-￿]+$` was added for the status `201` - the `business/address/line1` response's property pattern `^[À-ÖØ-öø-ǿa-zA-Z0-9().\-_#,;/@$!% ]+$` was added for the status `201` - the `business/address/line2` response's property pattern `^[À-ÖØ-öø-ǿa-zA-Z0-9().\-_#,;/@$!% ]+$` was added for the status `201` - the `business/address/postalCode` response's property pattern `^[0-9a-zA-Z ]*$` was added for the status `201` - the `business/legalName` response's property pattern `^[a-zA-Z0-9 ]{1,60}$` was added for the status `201` - the `name` response's property pattern `^[a-zA-Z0-9 ]{1,60}$` was added for the status `201` - added the required property `applePay/domains/items/merchantUuid` to the response with the `201` status - **2026-04-17** `5e1eb58d42d5`: 2 breaking, 2 info - the `business/address/country` request property format changed from no format to `iso-3166-1-alpha-2` - the `business/address/state` request property format changed from no format to `iso-3166-2-subdivision` - removed the pattern `^[a-z]{2}$` from the request property `business/address/country` - the `business/address/country` response's property pattern `^[a-z]{2}$` was removed for the status `201` - **2025-11-18** `30ea25af4354`: 5 warning, 8 info - removed the request property `networkTokens/enrollment/items/tokenRequestorId` - removed the optional property `networkTokens/enrolment/items/tokenRequestorId` from the response with the `201` status - added the new `active` enum value to the `applePay/domains/items/status` response property for the response status `201` - added the new `failed` enum value to the `applePay/domains/items/status` response property for the response status `201` - added the new `pending` enum value to the `applePay/domains/items/status` response property for the response status `201` - api tag `Merchants` added - api tag `Payments` added - api tag `payments` removed - added the new optional request property `networkTokens/enrollment/items/tokenRequestorIdentifier` - added the optional property `networkTokens/enrolment/items/tokenRequestorIdentifier` to the response with the `201` status - removed the `Active` enum value from the `applePay/domains/items/status` response property for the response status `201` - removed the `Failed` enum value from the `applePay/domains/items/status` response property for the response status `201` - removed the `Pending` enum value from the `applePay/domains/items/status` response property for the response status `201` --- [Operation](https://skmtc.dev/evervault/apis/evervault-api/docs/payments/merchants/post.md) - [API](https://skmtc.dev/evervault/apis/evervault-api.md) - [Page](https://skmtc.dev/evervault/apis/evervault-api/changes/payments/merchants/post)