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.