Create a cloud API key for a merchant
POST/partner/cloudpos/partner/:partnerId/merchant/:merchantId/keys
Creates a new cloud API key for a merchant. The API response will contain the API key unmasked.
Request
Path Parameters
Possible values: non-empty
and <= 50 characters
Your partner ID.
Possible values: non-empty
and <= 20 characters
ID of the merchant.
- application/json
Body
required
The name for the API key to be created. The name is used as part of the randomisation process generating the API key.
Possible values: <= 20 characters
The API key name.
Responses
- 200
- 400
- 401
- 403
- 409
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
The API key unmasked value.
The API key name.
Possible values: non-empty
and <= 20 characters
It is a unique Handpoint ID for the merchant, it must be unique across ALL TMS merchants. Handpoint will provide a range of IDs that can be used for this purpose.
{
"key": "string",
"keyName": "string",
"merchantIdAlpha": "string"
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
Error code.
Reason of the error.
Message guid of the error.
{
"code": "string",
"reason": "string",
"messageGuid": "string"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
Error code.
Reason of the error.
Message guid of the error.
{
"code": "string",
"reason": "string",
"messageGuid": "string"
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Error code.
Reason of the error.
Message guid of the error.
{
"code": "string",
"reason": "string",
"messageGuid": "string"
}
Conflict
- application/json
- Schema
- Example (from schema)
Schema
Error code.
Reason of the error.
Message guid of the error.
{
"code": "string",
"reason": "string",
"messageGuid": "string"
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
Error code.
Reason of the error.
Message guid of the error.
{
"code": "string",
"reason": "string",
"messageGuid": "string"
}