Delete Product
Archive a product (soft delete). The product will be set to ARCHIVED status and will no longer appear in active product listings.
DELETE
https://api.zenpayz.com/merchant/api/v1/products/:productIdBearer · API key
Request
Headers
| Header | Description |
|---|---|
Authorization REQUIRED | Bearer {api_key} |
X-Signature REQUIRED | HMAC-SHA256 signature |
X-Timestamp REQUIRED | ISO 8601 timestamp |
X-Secret-Salt REQUIRED | Secret salt for HMAC validation |
Content-Type REQUIRED | application/json |
Path Parameters
| Parameter | Type | Description |
|---|---|---|
productId REQUIRED | string | The product ID (e.g. prod_a1b2c3d4e5f6g7h8) |
Response
Success (200 OK)
{
"success": true,
"data": {
"productId": "prod_a1b2c3d4e5f6g7h8",
"status": "ARCHIVED"
},
"message": "Product archived successfully",
"error": null,
"meta": {
"request_id": "req_xxxxx",
"timestamp": "2024-01-16T14:20:00.000Z",
"processing_time_ms": 30,
"api_version": "v1",
"endpoint": "DELETE /products/:productId",
"user_type": "merchant"
}
}
Error Responses
| Code | HTTP | Message |
|---|---|---|
| UNAUTHORIZED | 401 | Invalid API key |
| PRODUCT_NOT_FOUND | 404 | Product does not exist |
Examples
- cURL
- JavaScript
- SDK
curl -X DELETE https://api.zenpayz.com/merchant/api/v1/products/prod_a1b2c3d4e5f6g7h8 \
-H "Authorization: Bearer zp_test_xxxxx" \
-H "X-Timestamp: 2024-01-16T14:20:00.000Z" \
-H "X-Signature: a1b2c3d4e5f6..." \
-H "X-Secret-Salt: your_secret_salt" \
-H "Content-Type: application/json"
const response = await fetch('https://api.zenpayz.com/merchant/api/v1/products/prod_a1b2c3d4e5f6g7h8', {
method: 'DELETE',
headers: {
'Authorization': `Bearer ${apiKey}`,
'X-Timestamp': timestamp,
'X-Signature': signature,
'X-Secret-Salt': secretSalt,
'Content-Type': 'application/json',
},
});
const result = await response.json();
console.log(result.data.status); // "ARCHIVED"
const result = await zenpays.products.delete('prod_a1b2c3d4e5f6g7h8');
console.log(result.status); // "ARCHIVED"