handel.halowerk.com
Takes a list of returns with the figures your own systems already hold and returns one decision per return, with the arithmetic that produced it. Four routes are valued: reselling as is, at the resale value weighted by the probability that it actually sells and less the restocking cost; repairing and reselling, at the refurbished value weighted by the repair success probability plus the salvage value on the failure branch, less the repair cost, which is incurred either way; recovering value…
Offering
- Provider
- handel.halowerk.com
- Method
- POST
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Financial Analysis
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://handel.halowerk.com/v1/return-disposition- MIME type
- Not provided
- First seen
- 2026-10-16T01:58:48.885Z
- Last seen
- Tags
- None supplied
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.004 USDC
Atomic price: 4000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "4000",
"payTo": "0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E"
}
]Observed health
- Status
- Healthy
- Latest latency
- 319 ms
- Average latency
- 677 ms
- HTTP status
- 204
- Last checked
- Reachability
- 100% over 11 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"currency": {
"default": "EUR",
"description": "ISO 4217 code for every amount in this request. Not converted, only carried through.",
"maxLength": 3,
"minLength": 3,
"type": "string"
},
"decision_margin_pct": {
"default": 5,
"description": "How far ahead the best route must be before it counts as a decision. Inside this margin the result is reported as ambiguous instead of asserting a winner.",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"defaults": {
"additionalProperties": false,
"description": "Values that apply to every item that does not carry its own. An item value always wins.",
"properties": {
"disposal_cost": {
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"inbound_freight_cost": {
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"inspection_cost": {
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"repair_cost": {
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"repair_success_probability": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"resale_probability": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"restocking_cost": {
"maximum": 100000000,
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"items": {
"description": "The returns to decide on. Every amount is in the currency named at document level.",
"items": {
"additionalProperties": false,
"properties": {
"condition": {
"description": "Condition as your inspection recorded it. Passed through unchanged; it does not change the arithmetic.",
"enum": [
"new",
"like_new",
"used",
"damaged",
"defective",
"unknown"
],
"type": "string"
},
"disposal_cost": {
"description": "Cost of disposing of the item. Scrapping is a cost, not proceeds.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"inbound_freight_cost": {
"description": "Freight already spent getting the item back. Incurred on every route.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"inspection_cost": {
"description": "Cost of inspecting this return. Incurred on every route and therefore does not change the ranking, only the level.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"refurb_resale_value": {
"description": "Expected proceeds after a successful repair.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"repair_cost": {
"description": "Cost of the repair attempt. Incurred whether or not the repair succeeds.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"repair_success_probability": {
"description": "Probability that the repair succeeds. A failed repair falls back to salvage_value.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"resale_probability": {
"default": 1,
"description": "Probability that the as-is resale actually happens within your planning window.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"resale_value": {
"description": "Expected proceeds from selling the item as it is.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"restocking_cost": {
"description": "Cost of putting the item back into stock. Only charged to the as-is resale route.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"return_id": {
"description": "Your identifier for this return. Must be unique within the request.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"salvage_value": {
"description": "Proceeds from parts recovery or material recycling.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
}
},
"required": [
"return_id"
],
"type": "object"
},
"maxItems": 500,
"minItems": 1,
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"currency": {
"default": "EUR",
"description": "ISO 4217 code for every amount in this request. Not converted, only carried through.",
"maxLength": 3,
"minLength": 3,
"type": "string"
},
"decision_margin_pct": {
"default": 5,
"description": "How far ahead the best route must be before it counts as a decision. Inside this margin the result is reported as ambiguous instead of asserting a winner.",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"defaults": {
"additionalProperties": false,
"description": "Values that apply to every item that does not carry its own. An item value always wins.",
"properties": {
"disposal_cost": {
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"inbound_freight_cost": {
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"inspection_cost": {
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"repair_cost": {
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"repair_success_probability": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"resale_probability": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"restocking_cost": {
"maximum": 100000000,
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"items": {
"description": "The returns to decide on. Every amount is in the currency named at document level.",
"items": {
"additionalProperties": false,
"properties": {
"condition": {
"description": "Condition as your inspection recorded it. Passed through unchanged; it does not change the arithmetic.",
"enum": [
"new",
"like_new",
"used",
"damaged",
"defective",
"unknown"
],
"type": "string"
},
"disposal_cost": {
"description": "Cost of disposing of the item. Scrapping is a cost, not proceeds.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"inbound_freight_cost": {
"description": "Freight already spent getting the item back. Incurred on every route.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"inspection_cost": {
"description": "Cost of inspecting this return. Incurred on every route and therefore does not change the ranking, only the level.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"refurb_resale_value": {
"description": "Expected proceeds after a successful repair.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"repair_cost": {
"description": "Cost of the repair attempt. Incurred whether or not the repair succeeds.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"repair_success_probability": {
"description": "Probability that the repair succeeds. A failed repair falls back to salvage_value.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"resale_probability": {
"default": 1,
"description": "Probability that the as-is resale actually happens within your planning window.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"resale_value": {
"description": "Expected proceeds from selling the item as it is.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"restocking_cost": {
"description": "Cost of putting the item back into stock. Only charged to the as-is resale route.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"return_id": {
"description": "Your identifier for this return. Must be unique within the request.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"salvage_value": {
"description": "Proceeds from parts recovery or material recycling.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
}
},
"required": [
"return_id"
],
"type": "object"
},
"maxItems": 500,
"minItems": 1,
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}