post-api2-dashboard-offers-qc

Create Qualification Criteria (QC)

​

Allows a business to define one or more qualification criteria (QC). You can bulk create a maximum of 20 qualification criteria per API call. If the request input contains more than 20 QC, only the first 20 are created, and the remaining are ignored.

QC define the rules and conditions under which offers can be redeemed. It involves various processing functions that determine how offers are applied based on specific criteria, such as customer behavior, purchase details, or transaction data. QC play a crucial role in managing complex offer logic, ensuring that only eligible transactions or actions qualify for discounts or rewards.

For more information, see Offers Ingestion Management

To call this API, the offers ingestion option must be enabled for the business on the Punchh platform. Contact your Punchh representative to update this Punchh platform configuration.

For more information on QC settings, see the Qualification Criteria article on the Support Portal.

Note: To view the Punchh product documentation on the Punchh Support Portal, you must log in to a Punchh platform production environment. If you already have access to a production environment, follow the instructions here to access the Punchh Support Portal.

Headers
  • Accept
    Type: string

    Set this header to application/json

  • Authorization
    Type: string
    required

    Bearer token for admin authorization, who is making a call on behalf of the customer. Send the API key in the following format: "Authorization: Bearer BUSINESS_ADMIN_KEY_GOES_HERE".

  • Content-Type
    Type: string

    Set this header to application/json

Body
application/json
  • data
    Type: array object[]
    required

    A list of qualification criteria (QC) that need to be created

Responses
  • 200
    Type: object
    • results
      Type: array object[]

      List of responses indicating if the entity is created or not

  • 400
    Type: object
    • error
      Type: string
  • 401
    Type: object
    • error
      Type: string
  • 403
    Type: object
    • error
      Type: string
post/api2/dashboard/offers/qc
{
  "results": [
    {
      "external_id": "string",
      "success": true,
      "errors": [
        "string"
      ],
      "warnings": {
        "line_item_filters": [
          {
            "message": "string",
            "item": {
              "line_item_selector_id": "string",
              " processing_method": "string",
              "quantity": 1
            }
          }
        ],
        "item_qualifiers": [
          {
            "message": "string",
            "item": {
              "line_item_selector_id": "string",
              "expression_type": "string",
              "net_value": 1
            }
          }
        ],
        "receipt_qualifiers": [
          {
            "message": "string",
            "item": {
              "attribute": "string",
              "operator": "string",
              "value": "string"
            }
          }
        ],
        "qualifying_expressions_operator": [
          {
            "message": "string",
            "item": {
              "qualifying_expressions_operator": "string"
            }
          }
        ],
        "item_filter_expressions_operator": [
          {
            "message": "string",
            "item": {
              "item_filter_expressions_operator": "string"
            }
          }
        ],
        "discount_evaluation_strategy": [
          {
            "message": "string",
            "item": {
              "discount_evaluation_strategy": "string"
            }
          }
        ]
      }
    }
  ]
}

OK