Merchants
Register a merchant with its settlement account
Registers a merchant and its settlement account so it can be paid.
POST
/v1/merchantsRegisters a merchant and its settlement account so it can be paid. Requires merchants:write. external_id is yours: a second create with the same one is refused merchant_exists (409) rather than opening a second settlement account. A missing body or a field outside its bounds gives invalid_request (400).
Authorization
bearerAuth AuthorizationBearer <token>
A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/merchants" \ -H "Content-Type: application/json" \ -d '{ "external_id": "string", "name": "string" }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "external_id": "string", "name": "string", "category": "string", "status": "string", "created_at": "2019-08-24T14:15:22Z"}