Gridbees

Developers

Promotions and prices as an API

Your front end keeps control: it sends the basket, Gridbees sends it back priced. Everything the back office does, the API does too.

Price a basket in one call

The answer holds every line, the promotions that fired, the fees, the wallet amount, VAT, the total to pay, the suggestions and the signature.

POST /valorization/valorize
Authorization: Bearer <token>

{
  "promocode": "WELCOME-7K2M",
  "deliverydetail": { "deliverymode": "HOME" },
  "lines": [
    { "linenum": 1, "offerid": "OSLO-SOFA", "quantity": 1 },
    { "linenum": 2, "offerid": "OSLO-CHAIR", "quantity": 1 }
  ]
}
200 OK
{
  "amount": {
    "totaltopay": 1123.20,
    "discountamount": 124.80,
    "feesdiscountamount": 49.00,
    "hashamount": "9f2c…e41a"
  },
  "basketrules": [
    { "rulename": "Oslo set −10%", "discountamount": 124.80 }
  ],
  "suggestions": [
    { "promotionname": "3rd item −50%", "conditiontype": "BasketLine" }
  ]
}

What you get

  • REST and OpenAPI

    Promotions, campaigns, codes, loyalty, referral, fees and pricing; each service serves its OpenAPI specification.

  • Authentication

    OAuth2 bearer tokens, or an access key for server-to-server calls.

  • Multi-tenant

    One tenant and one database per brand or company, taken from the credentials.

  • Simulate and explain

    Test drafts on up to 200 baskets; ask why a promotion did not fire.

  • Signed prices

    A signature over the amounts, which your order service can check before taking the order.

  • MCP server for AI agents

    Typed tools for offers, promotions, campaigns, basket pricing, explain and simulate.

Book your Free Demo Now!

Book a demo