Behavior When Invalid Items are Requested

This section describes how Dynamic Monetization handles access requests that include invalid line items.

A line item is invalid if one or more of the following apply:

The line item is not included a valid rate table.
The line item’s status is Inactive or Obsolete in the back office.
The line item was deleted in the back office.

If an access request includes an invalid item among other valid items, a charge for the invalid item cannot be made.

If this is a standalone access request, all other items are granted if possible.
If the access request is made to a session, then the entire request fails.

In the following example response for an access request made to a session, the item PhotoAlbum is not included in the rate table and is therefore invalid:

{

  "correlationId": "5c8ec4fd-f17f-4657-bf09-74a97ddc9f8b",

  "requester": {

    "type": "user",

    "value": "LisaBarry"

  },

  "requestedItems": [

    {

      "item": "PhotoAlbum",

      "Version": "1.0",

      "count": 1,

      "status": {

        "code": "201",

        "description": "Item not found in any effective rate table"

      },

      "totalTokensCharged": 0.0,

      "lineItems": []

    },

    {

      "item": "PhotoPrint",

      "requestedVersion": "1.0",

      "count": 5,

      "status": {

        "code": "102",

        "description": "No Status"

      },

      "totalTokensCharged": 0.0,

      "lineItems": []

    }

  ]

}

See also