action britbox_validate_pin_request {
  label: "validatePinRequest"
  description: "Validate PIN request created by calling POST /ee/pin This call is to validate MSISDN entered by a user not comming through EE network. This call should be called after PUT /ee/pin. This call should be followed by POST /ee/offers."
  provider: britbox
  method: POST
  path: "/ee/pin"
  encoding: json
  input: {
    type: "object"
    required: ["accessToken", "pin", "pinReference"]
    properties: {
      accessToken: {
        type: "string"
        description: "EE API authorization Token received from GET /ee/token/create."
      }
      pin: {
        type: "string"
        description: "The pin entered by a user. 6 digits"
      }
      pinReference: {
        type: "string"
        description: "The pinReference."
      }
      trackingHeader: {
        type: "string"
        description: "Tracking header to be able to search logs for a specific user requests. If not provided it will be generated. FE should store it for later user."
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["trackingHeader", "validationStatus"]
    properties: {
      pinValid: {
        type: "string"
        description: "The validation status."
      }
      trackingHeader: {
        type: "string"
        description: "trackingHeader"
      }
    }
    additionalProperties: false
  }
}