Skip to content
HALOWERK

Finopswerk

loyalty material right allocation bridge

Reconstructs one cash goods sale with a distinct loyalty material-right performance obligation from transaction price P, goods standalone price S, Q reward rights, per-right incremental discount D and inception exercise probability p. Option SSP = Q*D*p (B42); allocation on relative SSP: points L = P * option SSP / total SSP, goods revenue = P - L. The caller qualifies a genuine material right (B40), not an ordinary marketing offer (B41).

POST https://finops.halowerk.com/v1/loyalty-material-right-allocation-bridge

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
price_nintegerYes
goods_ssp_nintegerYes
pointsintegerYes
discount_nintegerYes
probability_bpintegerYes
redeemedintegerYes
expected_redemptionsintegerYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "required": [
    "price_n",
    "goods_ssp_n",
    "points",
    "discount_n",
    "probability_bp",
    "redeemed",
    "expected_redemptions",
    "amount_denominator",
    "report"
  ],
  "properties": {
    "price_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "goods_ssp_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "points": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "discount_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "probability_bp": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "redeemed": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000
    },
    "expected_redemptions": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 18,
      "maxProperties": 18,
      "propertyNames": {
        "enum": [
          "transaction_price",
          "goods_ssp",
          "point_count",
          "point_discount",
          "exercise_probability",
          "points_ssp",
          "total_ssp",
          "points_allocation",
          "goods_revenue",
          "redeemed",
          "expected_redemptions",
          "points_revenue",
          "remaining_points_liability",
          "total_revenue",
          "unredeemed_points",
          "expected_breakage_points",
          "allocation_gap",
          "cash_revenue_liability_gap"
        ]
      },
      "additionalProperties": {
        "type": "object",
        "required": [
          "n",
          "d"
        ],
        "propertyNames": {
          "enum": [
            "n",
            "d"
          ]
        },
        "additionalProperties": {
          "type": [
            "string",
            "null"
          ],
          "minLength": 1,
          "maxLength": 64
        }
      }
    }
  },
  "additionalProperties": false
}

Open original schema

Published input example

{
  "price_n": 100,
  "goods_ssp_n": 100,
  "points": 10,
  "discount_n": 1,
  "probability_bp": 8000,
  "redeemed": 4,
  "expected_redemptions": 8,
  "amount_denominator": 1,
  "report": {
    "transaction_price": {
      "n": "100",
      "d": "1"
    },
    "goods_ssp": {
      "n": "100",
      "d": "1"
    },
    "point_count": {
      "n": "10",
      "d": "1"
    },
    "point_discount": {
      "n": "1",
      "d": "1"
    },
    "exercise_probability": {
      "n": "4",
      "d": "5"
    },
    "points_ssp": {
      "n": "8",
      "d": "1"
    },
    "total_ssp": {
      "n": "108",
      "d": "1"
    },
    "points_allocation": {
      "n": "200",
      "d": "27"
    },
    "goods_revenue": {
      "n": "2500",
      "d": "27"
    },
    "redeemed": {
      "n": "4",
      "d": "1"
    },
    "expected_redemptions": {
      "n": "8",
      "d": "1"
    },
    "points_revenue": {
      "n": "100",
      "d": "27"
    },
    "remaining_points_liability": {
      "n": "100",
      "d": "27"
    },
    "total_revenue": {
      "n": "2600",
      "d": "27"
    },
    "unredeemed_points": {
      "n": "6",
      "d": "1"
    },
    "expected_breakage_points": {
      "n": "2",
      "d": "1"
    },
    "allocation_gap": {
      "n": "0",
      "d": "1"
    },
    "cash_revenue_liability_gap": {
      "n": "0",
      "d": "1"
    }
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’