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": "<string>"
}
'
{
  "merchant": {
    "id": "<string>",
    "name": "<string>",
    "email": "<string>",
    "status": "<string>",
    "iconUrl": "<string>",
    "createdAt": "<string>"
  }
}

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
Required string length: 1 - 256
​
merchantEmail
string<email>
required
Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
​
iconUrl
string<uri> | null

Response

Merchant created

​
merchant
object
required