Update a merchant

patch

https://gateway.pmnts.io/v2/partners/merchants/{username}

Updates the merchant's identity/business details. username, status
and credentials are read-only here — use the lifecycle endpoints
(/activate, /suspend, /cancel) to change status, and
/credentials/rotate to rotate credentials.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

username

string

required

The merchant's username (e.g. acme-store).

Body Params

Any subset of the create business/identity fields. username, status
and credentials are read-only — use the lifecycle and credential-rotate
endpoints for those. username is immutable post-creation.

name

string

trading_name

string

company_number

string

industry

string

contact

string

mcc

string

^\d{4}$

website

string

accounts_email

array of strings

accounts_email

phone

string

address

object

statement_descriptor

string

length ≤ 25

government_controlled

boolean

country_of_origin

string

^[A-Za-z]{2}$

country_code

string

fee_program_indicator

string

mastercard_iso_id

string

visa_iso_id

string

mastercard_assigned_id

string

visa_merchant_verification_value

string

visa_marketplace_identifier

string

visa_payment_facilitator_indicator

string

length ≤ 11

mastercard_payment_facilitator_indicator

string

length ≤ 11

bill_payment_provider

boolean

aggregator_fields_enabled

boolean

customer_support_phone

string

card_acceptor_name

string

card_acceptor_location

string

card_acceptor_country

string

^[A-Za-z]{2}$

timezone

string

IANA timezone identifier.

merchant_identifier

string

Partner-assigned identifier for the merchant. Distinct from the acquirer-assigned merchant_id (MID).

Responses

Language

Credentials

Basic

base64

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The updated merchant.

401Missing or invalid HTTP Basic credentials.

404Resource not found.