Skip to main content
PATCH
/
v1
/
merchants
/
{merchantId}
Update a merchant
curl --request PATCH \
  --url https://api.pay.walletconnect.com/v1/merchants/{merchantId} \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchantName": "<string>",
  "merchantEmail": "jsmith@example.com",
  "iconUrl": "https://example.com/new-logo.png"
}
'
{ "merchant": { "id": "mrch_7kBz2qR9xPvLmN4Yw", "name": "Acme Store v2", "email": "billing@acme.store", "status": "active", "iconUrl": "https://imagedelivery.net/example/acme-icon.png", "createdAt": "2025-06-15T10:30:00.000Z" } }

Documentation Index

Fetch the complete documentation index at: https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Api-Key
string
header
required

Path Parameters

​
merchantId
string
required

Body

application/json
​
merchantName
string

Updated display name

Required string length: 1 - 256
Example:

"Acme Store v2"

​
merchantEmail
string<email>

Updated contact email

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
Example:

"new-billing@acme.store"

​
iconUrl
string<uri> | null

Updated logo URL (HTTPS only), or null to unset

Example:

"https://example.com/new-logo.png"

Response

Merchant updated

​
merchant
object
required