---
title: Create product absolute partner discount
slug: reference/create-product-absolute-partner-discount
docTags:
createdAt: 2025-03-18T18:28:02.919Z
---
{
"id": "5XoRFyHfS6hiDtAQ1nsnT",
"type": "api-oas-v2",
"data": {
"method": "POST",
"url": "https://app.amberflo.io/payments/pricing/amberflo/account-pricing/promotions/product_absolute_partner_discount",
"servers": [
{
"url": "https://app.amberflo.io/payments/pricing/amberflo/account-pricing/promotions/product_absolute_partner_discount"
}
],
"name": "Create product absolute partner discount",
"description": "Creates a fixed-amount discount promotion for partner channel customers that applies to entire products.
\nThis provides fixed dollar amount discounts on product billing for customers sourced through partners,\nresellers, or channel programs.
\nUse this for partner channel programs, reseller discounts, or strategic alliance programs where you want\nfixed-amount discounts applied product-wide for partner-sourced customers.
\nBusiness Use Cases:
\n\n- Technology partner integration incentives
\n- Reseller channel enablement and margin support
\n- Marketplace and platform partner programs
\n- Strategic alliance pricing agreements
\n- Channel conflict resolution through differentiated pricing
\n
\nPartner Program Management:
\n\n- Multi-tier partner discount structures
\n- Partner performance tracking and analytics
\n- Automated partner payout calculations
\n- Channel partner enablement and training support
\n- Competitive positioning in partner ecosystems
\n
\nIntegration Benefits:
\n\n- Partner relationship management (PRM) system integration
\n- Channel partner portal automation
\n- Sales team partner collaboration tools
\n- Marketing development fund (MDF) program support
\n- Partner certification and qualification workflows
\n
",
"contentType": "application/json",
"request": {
"pathParameters": [],
"headerParameters": [],
"queryParameters": [],
"bodyDataParameters": [
{
"kind": "required",
"name": "body",
"type": "object",
"description": "Product absolute partner discount configuration with partner program details and fixed discount amounts",
"customType": "payment.pricing.promotions.pre_created.ProductAbsolutePartnerDiscount.in",
"schema": [
{
"name": "id",
"kind": "required",
"type": "string",
"description": "Unique identifier for the partner discount within the account scope.",
"example": ""
},
{
"name": "type",
"kind": "optional",
"type": "string",
"description": "Fixed promotion type identifier for product-level absolute partner discounts.",
"example": "",
"default": "product_absolute_partner_discount"
},
{
"name": "promotionName",
"kind": "required",
"type": "string",
"description": "Human-readable name for partner discount display and management purposes.",
"example": ""
},
{
"name": "description",
"kind": "optional",
"type": "string",
"description": "Optional detailed description explaining partner discount purpose and terms.",
"example": ""
},
{
"name": "lockingStatus",
"kind": "optional",
"type": "string",
"description": "Modification permissions controlling partner discount lifecycle and editing capabilities.",
"modelRef": "#/components/schemas/common.LockingStatus.in",
"customType": "common.LockingStatus.in",
"schema": []
},
{
"name": "dimensionConstraintMap",
"kind": "optional",
"type": "map",
"description": "Optional dimension filters restricting discount to specific usage characteristics.",
"example": "",
"customType": "map",
"schema": []
},
{
"name": "customerTags",
"kind": "optional",
"type": "map",
"description": "Required customer tag criteria identifying customers eligible for partner discounts.",
"example": "",
"customType": "map",
"schema": []
},
{
"name": "isHidden",
"kind": "optional",
"type": "boolean",
"description": "Controls partner discount visibility in customer interfaces and billing communications.",
"example": ""
},
{
"name": "discount",
"kind": "optional",
"type": "number",
"description": "Fixed monetary amount deducted from product charges in account currency.",
"example": ""
},
{
"name": "totalMaxDiscount",
"kind": "optional",
"type": "number",
"description": "Optional maximum total discount amount across all billing periods.",
"example": ""
},
{
"name": "targetProductId",
"kind": "optional",
"type": "string",
"description": "Identifier of the specific product receiving partner discount benefits.",
"example": ""
}
],
"modelRef": "#/components/schemas/payment.pricing.promotions.pre_created.ProductAbsolutePartnerDiscount.in",
"isExpanded": true
}
],
"formDataParameters": [],
"oAuthParameters": [
{
"id": "apiKey",
"name": "X-API-KEY",
"kind": "optional",
"type": "apiKey",
"in": "header"
}
]
},
"responses": [
{
"statusCode": "200",
"description": "Product absolute partner discount successfully created",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "Response containing fixed-amount partner discount details for customers sourced through channel partners.",
"customType": "payment.pricing.promotions.pre_created.ProductAbsolutePartnerDiscount.out",
"schema": [
{
"name": "id",
"kind": "required",
"type": "string",
"description": "Unique identifier for the partner discount within the account scope.",
"example": ""
},
{
"name": "type",
"kind": "optional",
"type": "string",
"description": "Fixed promotion type identifier for product-level absolute partner discounts.",
"example": "",
"default": "product_absolute_partner_discount"
},
{
"name": "promotionName",
"kind": "required",
"type": "string",
"description": "Human-readable name for partner discount display and management purposes.",
"example": ""
},
{
"name": "description",
"kind": "optional",
"type": "string",
"description": "Optional detailed description explaining partner discount purpose and terms.",
"example": ""
},
{
"name": "lockingStatus",
"kind": "optional",
"type": "string",
"description": "Current modification permissions and lifecycle state of the partner discount.",
"modelRef": "#/components/schemas/common.LockingStatus.in",
"customType": "common.LockingStatus.in",
"schema": []
},
{
"name": "lastUpdateTimeInMillis",
"kind": "optional",
"type": "integer",
"description": "Unix timestamp in milliseconds when partner discount was last modified.",
"example": 0
},
{
"name": "dimensionConstraintMap",
"kind": "optional",
"type": "map",
"description": "Optional dimension filters restricting discount to specific usage characteristics.",
"example": "",
"customType": "map",
"schema": []
},
{
"name": "customerTags",
"kind": "optional",
"type": "map",
"description": "Required customer tag criteria identifying customers eligible for partner discounts.",
"example": "",
"customType": "map",
"schema": []
},
{
"name": "isHidden",
"kind": "optional",
"type": "boolean",
"description": "Controls partner discount visibility in customer interfaces and billing communications.",
"example": ""
},
{
"name": "discount",
"kind": "optional",
"type": "number",
"description": "Fixed monetary amount deducted from product charges in account currency.",
"example": ""
},
{
"name": "totalMaxDiscount",
"kind": "optional",
"type": "number",
"description": "Optional maximum total discount amount across all billing periods.",
"example": ""
},
{
"name": "targetProductId",
"kind": "optional",
"type": "string",
"description": "Identifier of the specific product receiving partner discount benefits.",
"example": ""
}
],
"modelRef": "#/components/schemas/payment.pricing.promotions.pre_created.ProductAbsolutePartnerDiscount.out",
"isExpanded": true
}
]
},
{
"statusCode": "400",
"description": "Bad request - invalid partner program configuration or discount parameters",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "403",
"description": "Forbidden - insufficient permissions for partner program management",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "409",
"description": "Conflict - partner discount conflicts with existing partner agreements",
"jsonExample": "",
"isExpanded": true
}
],
"hasXCodeSamples": false,
"examples": {
"languages": [
{
"id": "TJ-EXILGcqU8_1v90Bt69",
"language": "curl",
"label": "cURL",
"code": "curl --request POST \\\n --url https://app.amberflo.io/payments/pricing/amberflo/account-pricing/promotions/product_absolute_partner_discount \\\n --header 'accept: application/json' \\\n --header 'content-type: application/json' \\\n --data '{\n \"id\": \"\",\n \"type\": \"product_absolute_partner_discount\",\n \"promotionName\": \"\"\n }'"
},
{
"id": "QhbHSRIvKAFHxkY2s8x1h",
"language": "javascript",
"label": "javascript",
"code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar raw = JSON.stringify({\n \"id\": \"\",\n \"type\": \"product_absolute_partner_discount\",\n \"promotionName\": \"\"\n});\n\nvar requestOptions = {\n method: 'POST',\n headers: myHeaders,\n body: raw,\n redirect: 'follow'\n};\n\nfetch(\"https://app.amberflo.io/payments/pricing/amberflo/account-pricing/promotions/product_absolute_partner_discount\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));"
},
{
"id": "8XKOH4CTdNSbKkHh6BKdP",
"language": "ruby",
"label": "Ruby",
"code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://app.amberflo.io/payments/pricing/amberflo/account-pricing/promotions/product_absolute_partner_discount\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\nrequest.body = JSON.dump({\n \"id\": \"\",\n \"type\": \"product_absolute_partner_discount\",\n \"promotionName\": \"\"\n})\n\nresponse = https.request(request)\nputs response.read_body\n"
},
{
"id": "MGd4kKO11wqyG0fhD3fzB",
"language": "python",
"label": "Python",
"code": "import requests\nimport json\n\nurl = \"https://app.amberflo.io/payments/pricing/amberflo/account-pricing/promotions/product_absolute_partner_discount\"\n\npayload = json.dumps({\n \"id\": \"\",\n \"type\": \"product_absolute_partner_discount\",\n \"promotionName\": \"\"\n})\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
}
],
"selectedLanguageId": "TJ-EXILGcqU8_1v90Bt69"
},
"results": {
"languages": [
{
"id": "response-0-200",
"language": "200",
"code": "// Product absolute partner discount successfully created\n{\n \"id\": \"\",\n \"type\": \"\",\n \"promotionName\": \"\",\n \"description\": \"\",\n \"lockingStatus\": \"\",\n \"lastUpdateTimeInMillis\": \"\",\n \"dimensionConstraintMap\": \"\",\n \"customerTags\": \"\",\n \"isHidden\": false,\n \"discount\": 0,\n \"totalMaxDiscount\": 0,\n \"targetProductId\": \"\"\n}"
},
{
"id": "response-1-400",
"language": "400",
"code": "// Bad request - invalid partner program configuration or discount parameters\n"
},
{
"id": "response-2-403",
"language": "403",
"code": "// Forbidden - insufficient permissions for partner program management\n"
},
{
"id": "response-3-409",
"language": "409",
"code": "// Conflict - partner discount conflicts with existing partner agreements\n"
}
],
"selectedLanguageId": "response-0-200"
}
},
"children": [
{
"text": ""
}
]
}