Developers
V1PlatformMerchantsId

Edit a prospect; revoke pending invitations before changing contacts

PATCH
/v1/platform/merchants/{id}

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/platform/merchants/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "offering": "product",    "contactName": "string",    "email": "string",    "phone": "string",    "expectedVersion": 1  }'
{  "merchant": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "stage": "prospect",    "createdAt": "2019-08-24T14:15:22Z",    "contactName": "string",    "email": "string",    "phone": "string",    "offering": "product",    "version": -9007199254740991,    "members": 0  },  "invitations": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "state": "pending",      "createdAt": "2019-08-24T14:15:22Z",      "expiresAt": "2019-08-24T14:15:22Z",      "delivery": "not_sent"    }  ],  "emailConfigured": true}

Merchant contact and latest 20 owner invitations; never invitation secrets GET

Previous Page

Replace the owner invitation and email its new seven-day link POST

Send and resend both invalidate every previous unused owner link. Provider acceptance confirms neither inbox delivery nor membership. Recipient must verify the invited email and use a fresh password or email-code session.