Contents x
    Calculate price of an order
    • 06 Sep 2024
    • 2 Minutes to read
    • Contributors
    • Print
    • Dark
      Light
    Contents

    Calculate price of an order

    • Updated on 06 Sep 2024
    • 2 Minutes to read
    • Contributors
    • Print
    • Dark
      Light
    Article summary

    Post
    /pricing/v2/calculate-price

    Given an order object, returns the price for that order.

    Takes the subscription into account and uses the calculator defined in the subscription contract. This allows a merchant to define custom pricing strategies.

    Security
    HTTP
    Type bearer
    Header parameters
    authorisation
    stringRequired
    Body parameters
    Expand All
    object
    order
    object Required
    id
    string Required

    The order's unique identifier within the Bento system.

    Example1
    user_id
    string Required

    The customer's unique identifier, which merchants can opt to assign using either their own customer service system or Bento's customer service during the onboarding process.

    Example1066
    subscription_contract_id
    string Required

    The unique identifier of the Bento subscription contract. It can be retrieved from the Bento Subscription Service.

    Examplea7ba8f43-a854-471d-99bc-9c366faba271
    subscription_phase_id
    string | null Required

    The unique identifier of the phase ID within the subscription contract. It is to determine which phase the given order is currently in, and thus which pricing calculator to use.

    Examplea7ba8f43-a854-471d-99bc-9c366faba271
    number
    number Required

    The position of the order relative to other orders in the subscription contract. It serves as an identifier representing the sequential order number of the customer's lifetime orders under a specific contract. The first order in the subscription contract has ordinal '1'.

    Example7
    items
    Array of object

    Array of items within an order, each containing id, quantity, source and custom attribute data.

    Example[ { "itemable_id": "1234", "quantity": 10.0, "source": "contract" } ]
    object
    itemable_id
    string | null

    A unique identifier for the product.

    Example10c9ca24-1fc3-11ee-8ff9-0ab7ee5e7h7w
    quantity
    number | null Required

    The quantity of this particular product within this order.

    Example30
    source
    string Required

    This is the source where the order item is added from. Could be from contract, product, order rule or admin edit.

    Examplecontract
    Responses
    200

    A successful response with the final price of the order, determined by its associated subscription contract and current phase.

    object
    price
    number

    Final price of the order, calculated after considering the specifics of the subscription contract and the order phase.

    Example3.14
    errors
    string

    Errors that occurred during price calculation.

    Example
    400

    Invalid Request

    Expand All
    object
    message
    string
    causes
    Array of object
    object
    message
    string
    metadata
    Array of object
    object
    key
    string
    value
    401

    Invalid Authentication Credentials

    Expand All
    object
    message
    string
    causes
    Array of object
    object
    message
    string
    metadata
    Array of object
    object
    key
    string
    value
    403

    Invalid Authorization Credentials

    Expand All
    object
    message
    string
    causes
    Array of object
    object
    message
    string
    metadata
    Array of object
    object
    key
    string
    value
    404

    Resource Not Found

    Expand All
    object
    message
    string
    causes
    Array of object
    object
    message
    string
    metadata
    Array of object
    object
    key
    string
    value
    424

    Failed Dependency

    Expand All
    object
    message
    string
    causes
    Array of object
    object
    message
    string
    metadata
    Array of object
    object
    key
    string
    value
    500

    Internal Server Error

    Expand All
    object
    message
    string
    causes
    Array of object
    object
    message
    string
    metadata
    Array of object
    object
    key
    string
    value
    Was this article helpful?
    What's Next