Partner Merchants
Create merchant
Creates a sub-merchant. Idempotent on `externalTenantId` and `Idempotency-Key`. Fee fields in the body are rejected.
Creates a sub-merchant. Idempotent on externalTenantId and Idempotency-Key.
Fee fields in the body are rejected.
Authorization
bearerAuth AuthorizationBearer <token>
Partner API key (pt_test_... or pt_live_...)
In: header
Header Parameters
Idempotency-Key*string
Unique key per create attempt. Reuse returns the same result when the body matches.
Length
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Fee fields in the body are rejected.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/partner/merchants" \ -H "Idempotency-Key: string" \ -H "Content-Type: application/json" \ -d '{ "externalTenantId": "string", "email": "[email protected]", "name": "string" }'{ "merchantId": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b", "organizationId": "string", "partnerId": "bf408d53-df49-40a6-8455-a34bd4360901", "externalTenantId": "string", "name": "string", "email": "string", "integrationStatus": "string", "dashboardAccess": true, "autoPayoutEnabled": true, "bindUrl": "http://example.com", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}{ "merchantId": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b", "organizationId": "string", "partnerId": "bf408d53-df49-40a6-8455-a34bd4360901", "externalTenantId": "string", "name": "string", "email": "string", "integrationStatus": "string", "dashboardAccess": true, "autoPayoutEnabled": true, "bindUrl": "http://example.com", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}{ "error": { "code": "string", "message": "string" }}{ "error": { "code": "string", "message": "string" }}{ "error": { "code": "string", "message": "string" }}