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

Authorizations

​
Api-Key
string
header
required

Headers

​
Idempotency-Key
string
required

Unique key to ensure idempotent request processing. Max 255 characters.

Maximum string length: 255

Body

application/json
​
merchantName
string
required

Display name for the merchant

Required string length: 1 - 256
Example:

"Acme Store"

​
merchantEmail
string<email>
required

Contact email for the merchant

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

"billing@acme.store"

​
iconUrl
string<uri> | null

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

Example:

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

Response

Merchant created

​
merchant
object
required