Agent Commerce Protocols

UCP-format discount eligibility check

UCP discount check. Same verification as POST /v1/verify, returned as a dev.ucp.shopping.discount fragment (a discounts object, not a full UCP Cart or Checkout resource) matching UCP release 2026-08-25. A code that carries a discount costs 1 regular credit from the API key that owns the store; a 0% result is free. A caller using another key is not charged. Source: "ucp".

post/v1/ucp/discount

Request

Base URL: https://api.insumermodel.com
URL: https://api.insumermodel.com/v1/ucp/discount
Auth: API key in header X-API-Key

Request body

merchantIdstring required

Merchant identifier

walletstring

EVM wallet address (0x...)

solanaWalletstring

Solana wallet address

xrplWalletstring

XRPL wallet address (classic r-address). The base58 checksum is verified; an address that fails it returns 400.

subtotalnumber

Optional order-level base in minor units, for callers that do not send line items. Ignored when items[] is supplied. With neither items[] nor subtotal the response carries no applied entry and discounts.codes is empty; the verified discount is still returned in the verification object.

Example request

{
  "items": [
    {
      "path": "$.line_items[0]",
      "amount": 2500
    }
  ],
  "subtotal": 5000
}

Response

UCP-format discount response

oktrue

Example response

{
  "data": {
    "version": "2026-08-25",
    "verification": {
      "kid": "insumer-attest-v1"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.