Create API credentials

Creates new API credentials for a merchant with the following validations:

Organization Validation:
- Organization must exist
- User must have access to the organization
Merchant Validation:
- Merchant must exist
- Merchant must belong to the specified organization
- User must have the required permissions for the merchant
Role Assignment (required):
- At least one role must be provided
- Roles will be assigned to the API credentials for the merchant
- Roles must be valid merchant roles (not organization roles)
- Invalid or missing roles will result in a 400 error
Permission Requirements:
- User must have MERCHANT_DEV_SETTINGS_CREATE_API_KEY permission

organizationIdstringRequired

Organization ID

merchantIdstringRequired

Merchant ID

API credentials information to create

namestringRequired

Descriptive name to identify the purpose of the API credentials

roleslist of stringsRequired

Array of role IDs or names to assign to the API credentials for the merchant. Must contain at least 1 role.

API credentials created successfully

apiKeystring

Generated API Key for the merchant

secretstring

Generated Secret for the merchant

1	import requests
2
3	url = "https://api.koywe.com/api/v1/auth/organizations/organizationId/merchants/merchantId/credentials"
4
5	payload = {
6	"name": "API Key for Koywe integration",
7	"roles": ["MERCHANT_ADMIN", "MERCHANT_VIEWER"]
8	}
9	headers = {
10	"Authorization": "Bearer <token>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())

1	{
2	"apiKey": "f7d8e9c0-b1a2-3d4e-5f6g-7h8i9j0k1l2m",
3	"secret": "2af81190b3a153r48a3df3a1eefcc386ca763b99fba53d39666751ffd4e2ae81"
4	}